JavaScript蓝牙设备操作全攻略

一分耕耘，一分收获！既然都打开这篇《JavaScript操作蓝牙设备方法详解》，就坚持看下去，学下去吧！本文主要会给大家讲到等等知识点，如果大家对本文有好的建议或者看到有不足之处，非常欢迎大家积极提出！在后续文章我会继续更新文章相关的内容，希望对大家都有所帮助！

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 特征）：

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 查看设备广播和服务结构

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~