如何用Web Bluetooth API控制蓝牙设备？-js教程-PHP中文网

web bluetooth api 可实现网页与ble设备通信，通过 requestdevice 选择设备并连接 gatt 服务器，读写特征值或监听数据变化，需在 https 环境下使用且仅支持 chromium 浏览器。

如何用web bluetooth api控制蓝牙设备？

Web Bluetooth API 让网页可以直接与附近的蓝牙低功耗（BLE）设备进行通信，无需安装原生应用。它适用于控制智能灯、传感器、健康设备等支持 BLE 的外设。下面介绍如何使用该 API 实现基本的连接与数据交互。

请求设备并建立连接

要使用 Web Bluetooth，第一步是让用户选择一个可用的蓝牙设备。通过 navigator.bluetooth.requestDevice() 方法触发设备选择弹窗。

你需要指定设备需要支持的服务（如心率服务 'heart_rate' 或自定义的 UUID）。例如，连接一个带自定义服务的设备：

const device = await navigator.bluetooth.requestDevice({
  filters: [{ services: ['battery_service'] }], // 按服务过滤
  optionalServices: ['device_information']     // 需要访问其他服务时添加
});

用户从列表中选择设备后，浏览器会尝试建立 GATT 连接：

const server = await device.gatt.connect();

读取和写入特征值（Characteristics）

连接成功后，可以通过远程 GATT 服务器获取服务和特征值。特征值是实际传输数据的单元，分为读、写、通知等类型。

例如，从电池服务中读取当前电量：

const service = await server.getPrimaryService('battery_service');
const characteristic = await service.getCharacteristic('battery_level');
const value = await characteristic.readValue();
const batteryLevel = value.getUint8(0);
console.log(`电量：${batteryLevel}%`);

若要向设备发送指令（比如打开灯光），可使用 writeValue 或 writeValueWithResponse：

Money Knowledge

金钱与财富知识助手。提供关于金钱的基本概念、理财知识、投资原则、财富思维等方面的内容。适用于：1) 了解金钱的基本知识；2) 学习理财和投资原则；3) 培养财富思维；4) 了解经济学基础概念。

下载

const lightChar = await service.getCharacteristic('light_control');
await lightChar.writeValue(new Uint8Array([1])); // 发送开灯命令

监听设备数据变化（开启通知）

某些设备会主动推送数据（如心率监测器）。你需要启用特征值的通知功能来实时接收更新。

设置监听如下：

const sensorChar = await service.getCharacteristic('heart_rate_measurement');
sensorChar.addEventListener('characteristicvaluechanged', (event) => {
  const value = event.target.value;
  console.log('心率:', value.getUint8(1));
});
await sensorChar.startNotifications();