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）：
立即学习“Java免费学习笔记（深入）”；
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 功能明确但权限谨慎，写起来不复杂，但容易忽略安全上下文和用户交互要求。
