0

0

如何用Web Bluetooth API控制蓝牙设备?

幻影之瞳

幻影之瞳

发布时间:2025-10-06 10:14:01

|

1228人浏览过

|

来源于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:

DubbingX智声云配
DubbingX智声云配

多情绪免费克隆AI音频工具

下载
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();

注意事项与兼容性

Web Bluetooth 目前仅在基于 Chromium 的浏览器(如 Chrome、Edge)上支持,且必须运行在 HTTPS 环境下(localhost 除外)。

常见限制包括:

  • 只能访问 BLE 设备,不支持经典蓝牙
  • 部分操作系统权限需手动开启
  • 长时间无操作可能导致连接断开

建议在用户操作(如点击按钮)后调用 requestDevice,避免自动弹窗被拦截。

基本上就这些。只要设备服务公开且格式明确,Web Bluetooth 能轻松实现网页端控制。关键是理解 GATT 结构和服务 UUID 的匹配方式。不复杂但容易忽略细节。

相关专题

更多
chrome什么意思
chrome什么意思

chrome是浏览器的意思,由Google开发的网络浏览器,它在2008年首次发布,并迅速成为全球最受欢迎的浏览器之一。本专题为大家提供chrome相关的文章、下载、课程内容,供大家免费下载体验。

822

2023.08.11

chrome无法加载插件怎么办
chrome无法加载插件怎么办

chrome无法加载插件可以通过检查插件是否已正确安装、禁用和启用插件、清除插件缓存、更新浏览器和插件、检查网络连接和尝试在隐身模式下加载插件方法解决。更多关于chrome相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

741

2023.11.06

edge是什么浏览器
edge是什么浏览器

Edge是一款由Microsoft开发的网页浏览器,是Windows 10操作系统中默认的浏览器,其目标是提供更快、更安全、更现代化的浏览器体验。本专题为大家提供edge浏览器相关的文章、下载、课程内容,供大家免费下载体验。

1376

2023.08.21

IE浏览器自动跳转EDGE如何恢复
IE浏览器自动跳转EDGE如何恢复

ie浏览器自动跳转edge的解决办法:1、更改默认浏览器设置;2、阻止edge浏览器的自动跳转;3、更改超链接的默认打开方式;4、禁用“快速网页查看器”;5、卸载edge浏览器;6、检查第三方插件或应用程序等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

379

2024.03.05

如何解决Edge打开但没有标题的问题
如何解决Edge打开但没有标题的问题

若 Microsoft Edge 浏览器打开后无标题(窗口空白或标题栏缺失),可尝试以下方法解决: 重启 Edge:关闭所有窗口,重新启动浏览器。 重置窗口布局:右击任务栏 Edge 图标 → 选择「最大化」或「还原」。 禁用扩展:进入 edge://extensions 临时关闭插件测试。 重置浏览器设置:前往 edge://settings/reset 恢复默认配置。 更新或重装 Edge:检查最新版本,或通过控制面板修复

919

2025.04.24

http与https有哪些区别
http与https有哪些区别

http与https的区别:1、协议安全性;2、连接方式;3、证书管理;4、连接状态;5、端口号;6、资源消耗;7、兼容性。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2060

2024.08.16

传感器故障解决方法
传感器故障解决方法

传感器故障排除指南:识别故障症状(如误读或错误代码)。检查电源和连接(确保连接牢固,无损坏)。校准传感器(遵循制造商说明)。诊断内部故障(目视检查、信号测试、环境影响评估)。更换传感器(选择相同规格,遵循安装说明)。验证修复(检查信号准确性,监测异常行为)。

472

2024.06.04

c++ 根号
c++ 根号

本专题整合了c++根号相关教程,阅读专题下面的文章了解更多详细内容。

42

2026.01.23

c++空格相关教程合集
c++空格相关教程合集

本专题整合了c++空格相关教程,阅读专题下面的文章了解更多详细内容。

46

2026.01.23

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Rust 教程
Rust 教程

共28课时 | 4.8万人学习

PostgreSQL 教程
PostgreSQL 教程

共48课时 | 7.8万人学习

Git 教程
Git 教程

共21课时 | 3万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号