JavaScript 通过 Web Bluetooth API 可在支持的浏览器中直接与蓝牙低功耗(BLE)设备交互,实现扫描发现、连接断连、读写特征值、订阅通知及服务遍历;需 HTTPS、Chromium 内核、用户授权且仅限 BLE 设备。

JavaScript 通过 Web Bluetooth API 可以在支持的浏览器中直接与蓝牙低功耗(BLE)设备交互,无需原生 App 或插件。它不是操作传统经典蓝牙(如音频耳机),而是面向 BLE 外设(如传感器、手环、开发板等)的现代 Web 标准。
能做什么:核心功能
Web Bluetooth API 提供以下关键能力:
-
扫描并发现附近 BLE 设备:调用
navigator.bluetooth.requestDevice()弹出系统选择框,用户手动选取设备(需用户主动授权) -
连接与断开设备:通过
device.gatt.connect()建立 GATT 连接;支持监听gattserverdisconnected事件处理意外断连 -
读写特征值(Characteristic):对已知 UUID 的 service 和 characteristic 执行
readValue()、writeValue()、startNotifications()等操作 - 订阅通知(Notifications)和指示(Indications):让设备在数据变化时主动推送,例如实时接收温湿度传感器更新
-
遍历服务与特征结构:通过
device.gatt.getPrimaryService()和service.getCharacteristics()动态探索设备能力(部分设备需先启用服务发现权限)
使用前提和限制
该 API 并非随处可用,必须满足以下条件:
- 仅支持 HTTPS 网站(
localhost也允许,适合本地开发) - 目前仅 Chromium 内核浏览器稳定支持(Chrome 56+、Edge 79+、Opera);Firefox 和 Safari 尚未实现或仅实验性支持
- 需要用户显式授权——每次请求设备都触发弹窗,不能静默连接
- 只支持 BLE(Bluetooth 4.0+),不支持经典蓝牙协议(如 A2DP、SPP)
- 部分操作系统需额外配置:macOS 要求 macOS 10.15+;Linux 需 BlueZ 5.4+ 和正确权限(如
bluetooth用户组)
一个最小可运行示例
以下代码点击按钮后请求连接一个提供电池服务(0000180f-0000-1000-8000-00805f9b34fb)的设备,并读取电量:
标签: linux javascript java 操作系统 浏览器 app edge 工具 safari mac ai
还木有评论哦,快来抢沙发吧~