当前位置：首页 > 文章列表 > 文章 > 前端 > JavaScript蓝牙连接入门指南

JavaScript蓝牙连接入门指南

2025-12-01 20:27:41 0浏览收藏

想要用JavaScript连接蓝牙设备吗？本文为你提供一份详细的JavaScript蓝牙连接教程，教你如何通过Web Bluetooth API实现网页与蓝牙低功耗(BLE)设备的交互。首先，了解Web Bluetooth API的基础知识，包括所需环境：HTTPS协议、现代浏览器支持。然后，按照步骤学习如何请求蓝牙设备、建立GATT连接、获取服务和特征值，以及读取和监听蓝牙设备的数据。本文还提供了一个实际应用场景示例，以及使用Web Bluetooth API的注意事项与限制，例如仅支持BLE设备、需要用户手动触发连接、以及iOS兼容性问题。掌握这些，你就能利用JavaScript轻松实现与硬件的数据交互，开发出各种有趣的物联网应用！

JavaScript通过Web Bluetooth API实现与蓝牙低功耗设备的交互，需用户授权并满足HTTPS、现代浏览器等条件；1. 调用requestDevice选择设备；2. 连接GATT服务器；3. 获取服务与特征值；4. 读取或监听数据；仅支持BLE、需手动触发、兼容性有限，尤其iOS不支持。

JavaScript蓝牙连接_javascript硬件交互

JavaScript 实现蓝牙连接和硬件交互，主要依赖于 Web Bluetooth API，它允许网页在用户授权的前提下与附近的蓝牙低功耗（BLE, Bluetooth Low Energy）设备进行通信。这种技术广泛应用于物联网（IoT）、智能穿戴设备、健康监测仪器等场景中。

Web Bluetooth API 基础

Web Bluetooth 让浏览器可以直接发现、连接并读写 BLE 外设的数据。该功能目前主要支持现代浏览器如 Chrome、Edge 和部分基于 Chromium 的浏览器，不支持 Safari 和 IE。

使用前需确保：

设备支持蓝牙 4.0 或以上版本
浏览器启用且支持 Web Bluetooth
网站运行在 HTTPS 环境下（本地开发可使用 localhost）

连接蓝牙设备的步骤

通过 JavaScript 连接蓝牙设备通常包括以下流程：

1. 请求设备
调用 navigator.bluetooth.requestDevice() 弹出选择框，让用户选择目标设备。

const device = await navigator.bluetooth.requestDevice({
  filters: [{ services: ['battery_service'] }], // 按服务筛选
  optionalServices: ['battery_service'] // 后续操作需要的服务
});

2. 建立 GATT 连接
获取设备的 GATT 服务器并连接。

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

3. 获取服务和特征值
通过服务 UUID 获取特定服务，再获取其中的特征（Characteristic）。

const service = await server.getPrimaryService('battery_service');
const characteristic = await service.getCharacteristic('battery_level');

4. 读取或监听数据
可以读取当前值或开启通知持续接收更新。

// 读取一次
const value = await characteristic.readValue();
console.log('电量:', value.getUint8(0));

// 监听变化
await characteristic.startNotifications();
characteristic.addEventListener('characteristicvaluechanged', (event) => {
  const val = event.target.value;
  console.log('实时电量:', val.getUint8(0));
});

实际应用场景示例

假设你有一个自定义的 BLE 设备，广播一个名为 "HeartRateMonitor" 的服务，你可以这样连接：

const device = await navigator.bluetooth.requestDevice({
  filters: [
    { namePrefix: 'HR_' } // 名称以 HR_ 开头的设备
  ],
  optionalServices: ['heart_rate']
});

const server = await device.gatt.connect();
const service = await server.getPrimaryService('heart_rate');
const char = await service.getCharacteristic('heart_rate_measurement');

await char.startNotifications();
char.addEventListener('characteristicvaluechanged', (e) => {
  const data = e.target.value;
  // 解析心率数据（具体格式参考 BLE 标准）
  const heartRate = data.getUint8(1);
  console.log('当前心率:', heartRate);
});