JavaScript可通过Web Bluetooth API在HTTPS网站中通过用户触发与BLE设备通信,支持Chrome/Edge等浏览器,流程包括请求设备、连接GATT、获取服务特征、读写监听数据,需注意权限、配对及特征属性检查。

JavaScript 通过 Web Bluetooth API 可以在支持的浏览器中(如 Chrome、Edge、Opera)直接与蓝牙低功耗(BLE)设备通信,无需插件或本地应用。它不是操作传统蓝牙(如音频耳机),而是面向 BLE 外设(如传感器、手环、开发板等)。
前提条件和限制
Web Bluetooth 是受严格安全策略约束的 API,使用前必须满足以下条件:
- 网站必须通过 HTTPS(本地开发可使用
localhost) - 用户必须主动触发(如点击按钮),不能自动连接
- 仅支持 BLE 设备(Bluetooth 4.0+),不支持经典蓝牙(如音箱、鼠标)
- 目前仅在桌面 Chrome/Edge(Windows/macOS/Linux)、Android Chrome 上稳定可用;Safari 和 Firefox 尚未支持
基本连接流程
典型操作分四步:请求设备 → 选择服务 → 获取特征 → 读/写/监听数据。
-
请求设备:
navigator.bluetooth.requestDevice()弹出系统选择框,需指定过滤条件(如服务 UUID 或名称关键字) -
连接 GATT 服务器:调用
device.gatt.connect() -
获取服务与特征:用
server.getPrimaryService()和service.getCharacteristic() -
交互数据:用
characteristic.readValue()、writeValue()或startNotifications()监听变化
一个可运行的最小示例
以下代码实现读取某 BLE 温度传感器的当前值(假设其公开了 00002a6e-0000-1000-8000-00805f9b34fb 特征):
立即学习“Java免费学习笔记(深入)”;
document.getElementById('connectBtn').addEventListener('click', async () => {
try {
const device = await navigator.bluetooth.requestDevice({
filters: [{ services: ['environmental_sensing'] }], // 或用 UUID 数组
optionalServices: ['battery_service']
});
const server = await device.gatt.connect();
const service = await server.getPrimaryService('environmental_sensing');
const tempChar = await service.getCharacteristic('temperature_measurement');
const value = await tempChar.readValue();
console.log('温度值(原始):', value.buffer);
// 解析 IEEE 11073 FLOAT(简化示例)
const view = new DataView(value.buffer);
const temp = view.getFloat32(2, true); // 假设偏移 2 字节,小端
console.log('解析后温度:', temp.toFixed(2), '°C');
} catch (error) {
console.error('操作失败:', error);
}
});
常见注意事项
实际开发中容易踩坑的地方:
- 特征值读写前务必检查
characteristic.properties.read或.write是否为true - 通知(notifications)需先调用
characteristic.startNotifications(),再监听characteristic.addEventListener('characteristicvaluechanged', ...) - 设备断开后,所有 GATT 对象(service/characteristic)将失效,需重新获取
- 部分设备要求配对(系统级弹窗),有些则免配对;权限由操作系统管理,JS 无法绕过
- 调试建议开启 Chrome 的
chrome://bluetooth-internals查看设备广播和服务结构










