更新记录

v1.0.12（2024-07-12） 下载此版本

fix: 修复扫描超时无法触发错误回调

v1.0.11（2024-06-18） 下载此版本

1、fix: toConnectDevice catch报错

v1.0.10（2024-02-21） 下载此版本

修复getBLEDeviceServices函数的错误

平台兼容性

uni-app

uniapp 微信蓝牙简单操作工具可直接上手使用

npm install uni-bluetooth

github: uni-bluetooth

npm: uni-bluetooth

uni插件市场: y-bluetooth

------- 2024-01-23 更新分片写入方法(请查看下方) -------

基础使用代码：

// 创建实例
const ble = UniBluetooth.BLE({
    deviceId: 要连接的设备localName或mac地址,
    onNotify: () => {},
    onClose: () => {}
})
// 写入数据
ble.writeValue(value)

有BUG可以直接评论区提出

案例

// 向设备写入16进制的字符串 '010041240100640000000000006a46'

const value = '010041240100640000000000006a46'
const ble = UniBluetooth.BLE({
    deviceId: 设备ID,
})
ble.writeValue(value, 'hex') // 'hex'表示value的值是16进制的，另外还有'string' 和 'buffer' 两种类型

------- 2024-01-23 更新分片写入 -------

蓝牙数据超过20字节的写入方法（分片写入）

官网说明：

1、并行调用多次会存在写失败的可能性。 2、APP不会对写入数据包大小做限制，但系统与蓝牙设备会限制蓝牙4.0单次传输的数据大小，超过最大字节数后会发生写入错误，建议每次写入不超过20字节。 3、若单次写入数据过长，iOS 上存在系统不会有任何回调的情况（包括错误回调）。

解决方案：

使用代码：

// 向设备写入16进制的字符串 '010041240100640000000000006a46010041240100640000000000006a46'

const value = '010041240100640000000000006a46'
const ble = UniBluetooth.BLE({
    deviceId: 设备ID,
})
// 第三个参数为true时会自动分片写入蓝牙数据
ble.writeValue(value, 'hex', true) // 'hex'表示value的值是16进制的，另外还有'string' 和 'buffer' 两种类型

排队写入

在分片写入之后，如果第二次写入太快的话，设备可能无法识别是否为同一次写入

// 向设备写入16进制的字符串 '010041240100640000000000006a46010041240100640000000000006a46'

const value = '010041240100640000000000006a46'
const ble = UniBluetooth.BLE({
    deviceId: 设备ID,
})
// 事件1
ble.eventListWriteValue({
    value,
    endDelay: 2000, // 2000ms后执行下一个eventListWriteValue
    loop: true
})
// 下面的方法会在事件1执行完毕后两秒执行
ble.eventListWriteValue({
    value,
})

UniBluetooth.BLE()

返回参数

UniBluetooth.writeValue()

UniBluetooth.eventListWriteValue(Object) 分片写入蓝牙数据

连接流程解析：

1. 初始化蓝牙

   UniBluetooth.dealOpenAdapter()

2. 扫描匹配蓝牙

   UniBluetooth.blueScan()

3. 连接蓝牙

   UniBluetooth.createConnect()

4. 获取设备服务

   UniBluetooth.getBLEDeviceServices()

5. 匹配服务特征

   UniBluetooth.matchServicesCharacteristics()

6. 写入数据

   UniBluetooth.writeValue()

API

device参数说明

常见错误码