uniapp 蓝牙

### UniApp 蓝牙开发概述 在 UniApp 中，蓝牙功能的实现依赖于其内置的一系列蓝牙 API。这些 API 提供了从初始化到数据传输的功能支持[^1]。以下是关于如何使用 UniApp 的蓝牙 API 进行开发的具体说明。 --- #### 初始化蓝牙适配器 在开始任何蓝牙操作前，需调用 `uni.openBluetoothAdapter` 方法来打开设备的蓝牙模块。如果蓝牙未开启，则会提示用户手动启用蓝牙。 ```javascript uni.openBluetoothAdapter({ success(res) { console.log('蓝牙已成功启动', res); }, fail(err) { console.error('蓝牙启动失败:', err); } }); ``` 此方法用于确认当前环境是否支持蓝牙功能并激活它。 --- #### 搜索周边蓝牙设备 通过调用 `uni.startBluetoothDevicesDiscovery` 可以扫描附近的蓝牙设备列表。需要注意的是，在某些平台上可能需要额外权限声明以及动态请求位置权限。 ```javascript uni.startBluetoothDevicesDiscovery({ success() { console.log('正在发现新设备...'); }, complete() { setTimeout(() => { uni.getBluetoothDevices({ success(devicesRes) { const devices = devicesRes.devices; console.log('找到以下设备:', devices); } }); }, 2000); // 延迟获取以确保有足够时间完成扫描 } }); ``` 上述代码片段展示了如何发起一次蓝牙搜索过程，并最终打印出所检测到的所有可用外设信息。 --- #### 建立连接至目标设备 当定位到所需的目标蓝牙设备之后，可以尝试建立与其之间的通信链路。这一步骤涉及到了解服务UUID和服务特征值等内容。 ```javascript const deviceId = 'your-device-id'; // 替换为目标设备的真实ID // 创建与指定设备间的链接关系 uni.createBLEConnection({ deviceId, success(connRes) { console.log(`成功创建与 ${deviceId} 设备的 BLE 链接`, connRes); // 获取该设备的服务详情 uni.getBLEDeviceServices({ deviceId, success(servicesRes) { servicesRes.services.forEach(service => { console.log('Service found:', service.uuid); // 查询每一个service下的characteristics特性集合 uni.getBLEDeviceCharacteristics({ deviceId, serviceId: service.uuid, success(characteristicsRes) { characteristicsRes.characteristics.forEach(chara => { if (chara.properties.read || chara.properties.writeWithoutResponse || chara.properties.notify || chara.properties.indicate) { console.log('Characteristic available for interaction:', chara.uuid); } }); } }); }); } }); } }); ``` 以上脚本实现了向特定远程节点发送握手信号的动作，并进一步探索它的资源结构树形图谱。 --- #### 数据读写操作 一旦建立了稳定的双向通道后就可以执行真正的业务逻辑——即交换消息或者控制指令之类的动作啦！ 对于简单的只读场景来说： ```javascript function readDataFromRemote(deviceId, serviceId, characteristicId){ return new Promise((resolve,reject)=>{ uni.readBLECharacteristicValue({ deviceId, serviceId, characteristicId, success(readSuccess){ resolve("Read Success"); }, fail(failReason){ reject(failReason.errMsg); } }) }) } ``` 而对于更复杂的交互模式则需要用到通知机制监听远端变化情况；亦或是主动推送本地更新给对方知晓等等。 --- ### 注意事项 - 不同平台间可能存在细微差异，请参照各自官方文档调整参数设置。 - 用户隐私保护日益严格，务必遵循最新法律法规要求处理敏感个人信息采集行为。