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 环境下(本地开发可使用
localhost)
连接蓝牙设备的步骤
通过 JavaScript 连接蓝牙设备通常包括以下流程:
立即学习“Java免费学习笔记(深入)”;
调用
navigator.bluetooth.requestDevice() 弹出选择框,让用户选择目标设备。
const device = await navigator.bluetooth.requestDevice({
filters: [{ services: ['battery_service'] }], // 按服务筛选
optionalServices: ['battery_service'] // 后续操作需要的服务
});
2. 建立 GATT 连接获取设备的 GATT 服务器并连接。
const server = await device.gatt.connect();3. 获取服务和特征值
通过服务 UUID 获取特定服务,再获取其中的特征(Characteristic)。
const service = await server.getPrimaryService('battery_service');
const characteristic = await service.getCharacteristic('battery_level');
4. 读取或监听数据可以读取当前值或开启通知持续接收更新。
// 读取一次
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));
});
实际应用场景示例
假设你有一个自定义的 BLE 设备,广播一个名为 "HeartRateMonitor" 的服务,你可以这样连接:
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);
});
注意事项与限制
虽然 Web Bluetooth 提供了便捷的硬件交互方式,但仍有一些关键限制:
- 仅支持 BLE 设备,不能连接经典蓝牙(如音箱、键盘)
- 必须由用户主动触发连接操作(比如点击按钮),不能自动扫描
- 权限控制严格,用户每次都需要确认设备选择
- 不同设备的 UUID 和数据格式各异,需查阅设备文档正确解析
- 移动端兼容性差,Android 支持较好,iOS 基本不支持
基本上就这些。只要设备符合规范,配合正确的服务和特征 UUID,JavaScript 就能轻松实现与硬件的数据交互。不复杂但容易忽略细节,尤其是数据解析部分,建议结合官方 BLE 规范文档一起调试。











