JavaScript通过Web Bluetooth API实现与蓝牙低功耗设备的交互,需用户授权并满足HTTPS、现代浏览器等条件;1. 调用requestDevice选择设备;2. 连接GATT服务器;3. 获取服务与特征值;4. 读取或监听数据;仅支持BLE、需手动触发、兼容性有限,尤其iOS不支持。
JavaScript 实现蓝牙连接和硬件交互,主要依赖于 Web Bluetooth API,它允许网页在用户授权的前提下与附近的蓝牙低功耗(BLE, Bluetooth Low Energy)设备进行通信。这种技术广泛应用于物联网(IoT)、智能穿戴设备、健康监测仪器等场景中。
Web Bluetooth API 基础
Web Bluetooth 让
浏览器
可以直接发现、连接并读写 BLE 外设的数据。该功能目前主要支持现代浏览器如 Chrome、Edge 和部分基于 Chromium 的浏览器,不支持 Safari 和 IE。
使用前需确保:
设备支持蓝牙 4.0 或以上版本
浏览器启用且支持 Web Bluetooth
网站运行在 HTTPS 环境下(本地开发可使用
)
连接蓝牙设备的步骤
通过 JavaScript 连接蓝牙设备通常包括以下流程:
立即学习
“
Java免费学习笔记(深入)
”;
Comet AI 浏览器
下载 Comet AI 浏览器,体验由 Perplexity AI 驱动的革命性上网方式。内置 AI 助手可实时总结网页、跨标签页对比信息、自动执行任务。告别繁琐操作,让 AI 成为你的浏览副驾,大幅提升研究与工作效率。支持 Windows、macOS、Android 和 iOS。
下载
1. 请求设备调用弹出选择框,让用户选择目标设备。
2. 建立 GATT 连接获取设备的 GATT 服务器并连接。
3. 获取服务和特征值通过服务 UUID 获取特定服务,再获取其中的特征(Characteristic)。
4. 读取或监听数据可以读取当前值或开启通知持续接收更新。
实际应用场景示例
假设你有一个自定义的 BLE 设备,广播一个名为 "HeartRateMonitor" 的服务,你可以这样连接:
注意事项与限制
虽然 Web Bluetooth 提供了便捷的硬件交互方式,但仍有一些关键限制:
仅支持 BLE 设备,不能连接经典蓝牙(如音箱、键盘)
必须由用户主动触发连接操作(比如点击按钮),不能自动扫描
权限控制严格,用户每次都需要确认设备选择
不同设备的 UUID 和数据格式各异,需查阅设备文档正确解析
移动端兼容性差,Android 支持较好,iOS 基本不支持
基本上就这些。只要设备符合规范,配合正确的服务和特征 UUID,JavaScript 就能轻松实现与硬件的数据交互。不复杂但容易忽略细节,尤其是数据解析部分,建议结合官方 BLE 规范文档一起调试。
localhostnavigator.bluetooth.requestDevice()const device = await navigator.bluetooth.requestDevice({
filters: [{ services: ['battery_service'] }], // 按服务筛选
optionalServices: ['battery_service'] // 后续操作需要的服务
});const server = await device.gatt.connect();const service = await server.getPrimaryService('battery_service');
const characteristic = await service.getCharacteristic('battery_level');// 读取一次
const value = await characteristic.readValue();
console.log('电量:', value.getUint8(0));
// 监听变化
await characteristic.startNotifications();
characteristic.addEventListener('characteristicvaluechanged', (event) => {
const val = event.target.value;
console.log('实时电量:', val.getUint8(0));
});const device = await navigator.bluetooth.requestDevice({
filters: [
{ namePrefix: 'HR_' } // 名称以 HR_ 开头的设备
],
optionalServices: ['heart_rate']
});
const server = await device.gatt.connect();
const service = await server.getPrimaryService('heart_rate');
const char = await service.getCharacteristic('heart_rate_measurement');
await char.startNotifications();
char.addEventListener('characteristicvaluechanged', (e) => {
const data = e.target.value;
// 解析心率数据(具体格式参考 BLE 标准)
const heartRate = data.getUint8(1);
console.log('当前心率:', heartRate);
});