JavaScript连接蓝牙设备方法详解

在文章实战开发的过程中，我们经常会遇到一些这样那样的问题，然后要卡好半天，等问题解决了才发现原来一些细节知识点还是没有掌握好。今天golang学习网就整理分享《JavaScript如何连接蓝牙设备？》，聊聊，希望可以帮助到正在努力赚钱的你。

Web Bluetooth API允许HTTPS或localhost环境下通过用户交互调用requestDevice()、connect()、getPrimaryService()、readValue()等异步方法与BLE设备通信，Chrome/Edge/Opera支持，Safari/Firefox不支持。

JavaScript 本身不能直接操作蓝牙硬件，但现代浏览器（Chrome、Edge、Opera 等）支持 Web Bluetooth API，它允许网页在用户授权前提下与附近的蓝牙设备（如传感器、手环、打印机、BLE 设备）进行通信。这个 API 是异步的、基于 Promise 的，且必须运行在安全上下文（HTTPS 或 localhost）中。

一、基础前提和限制

使用 Web Bluetooth 前需确认：

• 浏览器支持：Chrome 56+、Edge 79+、Opera 43+；Safari 和 Firefox 暂不支持
• 页面必须通过 HTTPS（生产环境）或 http://localhost（开发调试）提供
• 用户必须主动触发（比如点击按钮），不能自动连接——这是强制的安全策略
• 仅支持 BLE（Bluetooth Low Energy），不支持经典蓝牙（如音频耳机、鼠标）

二、核心流程：发现 → 连接 → 读写特征值

典型操作分四步，每步都返回 Promise：

• requestDevice()：弹出系统设备选择框，让用户选一个 BLE 设备
• connect()：建立 GATT 连接（类似“打开通道”）
• getPrimaryService() + getCharacteristic()：定位服务（Service）和特征（Characteristic）
• readValue() / writeValue() / startNotifications()：读、写、监听数据

示例：读取温度传感器的当前值（假设服务 UUID 为 0000181a-0000-1000-8000-00805f9b34fb，温度特征 UUID 为 00002a6e-0000-1000-8000-00805f9b34fb）：

document.getElementById('readBtn').addEventListener('click', async () => {
  try {
    // 1. 选择设备（可加 filters 缩小范围）
    const device = await navigator.bluetooth.requestDevice({
      filters: [{ services: ['battery_service'] }], // 或用 UUID 数组
      optionalServices: ['0000181a-0000-1000-8000-00805f9b34fb']
    });

    // 2. 连接
    const server = await device.gatt.connect();

    // 3. 获取服务和特征
    const service = await server.getPrimaryService('0000181a-0000-1000-8000-00805f9b34fb');
    const characteristic = await service.getCharacteristic('00002a6e-0000-1000-8000-00805f9b34fb');

    // 4. 读值（返回 DataView）
    const value = await characteristic.readValue();
    const temp = value.getFloat32(0, true); // 按 Little-Endian 解析 float
    console.log('温度：', temp, '°C');
  } catch (error) {
    console.error('操作失败：', error);
  }
});

三、常见实用技巧

• 过滤设备：用 filters 指定名称前缀、服务 UUID 或制造商数据，避免列出所有设备
• 监听通知：对可订阅的特征调用 startNotifications()，然后监听 characteristic.addEventListener('characteristicvaluechanged', ...)
• 写数据注意格式：用 new Uint8Array([...]) 构造字节数组再传给 writeValue()
• 断开后清理：监听 device.gatt.ondisconnect，必要时重连或提示用户

四、调试建议

开发时推荐：

• 用手机 App（如 nRF Connect）模拟 BLE 外设，验证网页逻辑
• Chrome 地址栏输入 chrome://bluetooth-internals 查看已配对设备、GATT 结构和实时日志
• 遇到 NotFoundError 或 SecurityError，优先检查是否 HTTPS、是否用户触发、是否设备未广播

基本上就这些。Web Bluetooth 功能明确但权限谨慎，写起来不复杂，但容易忽略安全上下文和用户交互要求。

理论要掌握，实操不能落！以上关于《JavaScript连接蓝牙设备方法详解》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！