低功耗蓝牙

jd.readBLECharacteristicValue(Object object)

读取低功耗蓝牙设备的特征值的二进制数据值。注意：必须设备的特征值支持 read 才可以成功调用。

错误

注意

• 接口读取到的信息需要在 onBLECharacteristicValueChange 方法注册的回调中获取。

jd.onBLEConnectionStateChange(function callback)

监听低功耗蓝牙连接状态的改变事件。包括开发者主动连接或断开连接，设备丢失，连接异常断开等等

参数

function callback

低功耗蓝牙连接状态的改变事件的回调函数

参数

Object res

jd.onBLECharacteristicValueChange(function callback)

监听低功耗蓝牙设备的特征值变化事件。必须先启用 notifyBLECharacteristicValueChange 接口才能接收到设备推送的 notification。

参数

function callback

低功耗蓝牙设备的特征值变化事件的回调函数

参数

Object res

jd.notifyBLECharacteristicValueChange(Object object)

启用低功耗蓝牙设备特征值变化时的 notify 功能，订阅特征值。 注意：必须设备的特征值支持 notify 或者 indicate 才可以成功调用。 另外，必须先启用 notifyBLECharacteristicValueChange 才能监听到设备 characteristicValueChange 事件

错误

注意

• 订阅操作成功后需要设备主动更新特征值的 value，才会触发 jd.onBLECharacteristicValueChange 回调

jd.getBLEDeviceServices(Object object)

获取蓝牙设备所有服务(service)。

参数

Object object

success参数说明

services结构说明

错误

jd.getBLEDeviceCharacteristics(Object object)

获取蓝牙设备某个服务中所有特征值(characteristic)。

参数

Object object

success参数说明

characteristics结构说明

properties结构说明

错误

jd.createBLEConnection(Object object)

连接低功耗蓝牙设备。 若小程序在之前已有搜索过某个蓝牙设备，并成功建立连接，可直接传入之前搜索获取的 deviceId 直接尝试连接该设备，无需进行搜索操作。

参数

Object object

错误

注意

• 请保证尽量成对的调用 createBLEConnection 和 closeBLEConnection 接口。安卓如果多次调用 createBLEConnection 创建连接，有可能导致系统持有同一设备多个连接的实例，导致调用 closeBLEConnection 的时候并不能真正的断开与设备的连接。
• 蓝牙连接随时可能断开，建议监听 jd.onBLEConnectionStateChange 回调事件，当蓝牙设备断开时按需执行重连操作
• 若对未连接的设备或已断开连接的设备调用数据读写操作的接口，会返回 10006 错误，建议进行重连操作。

jd.closeBLEConnection(Object object)

断开与低功耗蓝牙设备的连接。

参数

Object object

错误

jd.writeBLECharacteristicValue(Object object)

向低功耗蓝牙设备特征值中写入二进制数据。注意：必须设备的特征值支持 write 才可以成功调用。

参数

Object object

错误

注意

• 并行调用多次会存在写失败的可能性。
• 小程序不会对写入数据包大小做限制，但系统与蓝牙设备会限制蓝牙4.0单次传输的数据大小，超过最大字节数后会发生写入错误，建议每次写入不超过20字节。
• 若单次写入数据过长，iOS 上存在系统不会有任何回调的情况（包括错误回调）。
• 安卓平台上，在调用 notifyBLECharacteristicValueChange 成功后立即调用 writeBLECharacteristicValue 接口，在部分机型上会发生 10008 系统错误