Web Bluetooth API 可实现网页与BLE设备通信,通过 requestDevice 选择设备并连接 GATT 服务器,读写特征值或监听数据变化,需在 HTTPS 环境下使用且仅支持 Chromium 浏览器。

Web Bluetooth API 让网页可以直接与附近的蓝牙低功耗(BLE)设备进行通信,无需安装原生应用。它适用于控制智能灯、传感器、健康设备等支持 BLE 的外设。下面介绍如何使用该 API 实现基本的连接与数据交互。
请求设备并建立连接
要使用 Web Bluetooth,第一步是让用户选择一个可用的蓝牙设备。通过 navigator.bluetooth.requestDevice() 方法触发设备选择弹窗。
你需要指定设备需要支持的服务(如心率服务 ‘heart_rate’ 或自定义的 UUID)。例如,连接一个带自定义服务的设备:
const device = await navigator.bluetooth.requestDevice({ filters: [{ services: ['battery_service'] }], // 按服务过滤 optionalServices: ['device_information'] // 需要访问其他服务时添加});
用户从列表中选择设备后,浏览器会尝试建立 GATT 连接:
const server = await device.gatt.connect();
读取和写入特征值(Characteristics)
连接成功后,可以通过远程 GATT 服务器获取服务和特征值。特征值是实际传输数据的单元,分为读、写、通知等类型。
例如,从电池服务中读取当前电量:
const service = await server.getPrimaryService('battery_service');const characteristic = await service.getCharacteristic('battery_level');const value = await characteristic.readValue();const batteryLevel = value.getUint8(0);console.log(`电量:${batteryLevel}%`);
若要向设备发送指令(比如打开灯光),可使用 writeValue 或 writeValueWithResponse:
const lightChar = await service.getCharacteristic('light_control');await lightChar.writeValue(new Uint8Array([1])); // 发送开灯命令
监听设备数据变化(开启通知)
某些设备会主动推送数据(如心率监测器)。你需要启用特征值的通知功能来实时接收更新。
设置监听如下:
const sensorChar = await service.getCharacteristic('heart_rate_measurement');sensorChar.addEventListener('characteristicvaluechanged', (event) => { const value = event.target.value; console.log('心率:', value.getUint8(1));});await sensorChar.startNotifications();
注意事项与兼容性
Web Bluetooth 目前仅在基于 Chromium 的浏览器(如 Chrome、Edge)上支持,且必须运行在 HTTPS 环境下(localhost 除外)。
常见限制包括:
只能访问 BLE 设备,不支持经典蓝牙 部分操作系统权限需手动开启 长时间无操作可能导致连接断开
建议在用户操作(如点击按钮)后调用 requestDevice,避免自动弹窗被拦截。
基本上就这些。只要设备服务公开且格式明确,Web Bluetooth 能轻松实现网页端控制。关键是理解 GATT 结构和服务 UUID 的匹配方式。不复杂但容易忽略细节。
以上就是如何用Web Bluetooth API控制蓝牙设备?的详细内容,更多请关注创想鸟其它相关文章!
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/1526849.html
微信扫一扫
支付宝扫一扫