首页 > web前端 > js教程 > 正文

javascript怎样操作蓝牙设备?_javascript的Web Bluetooth API如何使用?

狼影
发布: 2025-12-23 16:46:15
原创
693人浏览过
Web Bluetooth API允许HTTPS或localhost环境下通过用户交互调用requestDevice()、connect()、getPrimaryService()、readValue()等异步方法与BLE设备通信,Chrome/Edge/Opera支持,Safari/Firefox不支持。

javascript怎样操作蓝牙设备?_javascript的web bluetooth api如何使用?

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):

造物云营销设计
造物云营销设计

造物云是一个在线3D营销设计平台,0基础也能做电商设计

造物云营销设计 97
查看详情 造物云营销设计

立即学习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 结构和实时日志
  • 遇到 NotFoundErrorSecurityError,优先检查是否 HTTPS、是否用户触发、是否设备未广播

基本上就这些。Web Bluetooth 功能明确但权限谨慎,写起来不复杂,但容易忽略安全上下文和用户交互要求。

以上就是javascript怎样操作蓝牙设备?_javascript的Web Bluetooth API如何使用?的详细内容,更多请关注php中文网其它相关文章!

java速学教程(入门到精通)
java速学教程(入门到精通)

java怎么学习?java怎么入门?java在哪学?java怎么学才快?不用担心,这里为大家提供了java速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载
来源:php中文网
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
最新问题
开源免费商场系统广告
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

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