javascript如何操作蓝牙_Web Bluetooth API有哪些功能

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）的设备，并读取电量：

腾讯云AI代码助手

基于混元代码大模型的AI辅助编码工具

205

查看详情

立即学习“Java免费学习笔记（深入）”；

document.getElementById('connectBtn').addEventListener('click', async () => {
  try {
    const device = await navigator.bluetooth.requestDevice({
      filters: [{ services: ['battery_service'] }], // 或用 UUID 字符串
      optionalServices: ['battery_service']
    });
    const server = await device.gatt.connect();
    const service = await server.getPrimaryService('battery_service');
    const characteristic = await service.getCharacteristic('battery_level');
    const value = await characteristic.readValue();
    console.log('电量：', value.getUint8(0) + '%');
  } catch (error) {
    console.error('操作失败：', error);
  }
});

常见注意事项

实际开发中容易踩坑的地方：

• 设备必须处于可被发现（discoverable）且广播（advertising）状态，否则扫描不到
• 读写前务必检查 characteristic 的属性（properties.read、properties.notify 等），否则会报错
• 二进制数据用 DataView 或 Uint8Array 处理，别直接当字符串解析
• 频繁读写或开启通知后记得适时 stopNotifications() 和 disconnect()，避免资源泄漏
• 移动端 Chrome 在后台标签页可能暂停蓝牙操作，建议引导用户保持前台

基本上就这些。Web Bluetooth 让网页具备了轻量级硬件交互能力，适合做控制面板、调试工具、教育演示等场景，但不适合高实时性或复杂配对流程的应用。

以上就是javascript如何操作蓝牙_Web Bluetooth API有哪些功能的详细内容，更多请关注php中文网其它相关文章！