支付宝小程序蓝牙 快速接入

基本流程

对于有蓝牙接入需求的开发者，需要通过以下步骤完成蓝牙接入：

初始化蓝牙接口(my.openBluetoothAdapter)

初始化事件监听

蓝牙适配器状态监听(my.onBluetoothAdapterStateChange)

蓝牙发现事件监听(my.onBluetoothDeviceFound)

蓝牙连接状态事件监听(my.onBLEConnectionStateChanged)

搜索设备(my.startBluetoothDevicesDiscovery)

查找设备并连接(my.connectBLEDevice)

停止搜索设备(my.stopBluetoothDevicesDiscovery)

遍历蓝牙外设服务和特征

获取服务(my.getBLEDeviceServices)

获取特征(my.getBLEDeviceCharacteristics)

监听特征值变化事件通知(my.onBLECharacteristicValueChange)

设置读特征通知模式(my.notifyBLECharacteristicValueChange)

读写数据

向设备的特征值写数据(my.writeBLECharacteristicValue)

向设备的特征值读数据(my.readBLECharacteristicValue)

断开连接(my.disconnectBLEDevice)

关闭蓝牙适配器(my.closeBluetoothAdapter)

业务流程图

调用示例

//初始化
my.openBluetoothAdapter({
success: (res) => {
console.log(res);
}
});
//注册发现事件
my.onBluetoothDeviceFound({
success: (res) => {
let device = res.devices[0];
//连接发现的设备
my.connectBLEDevice({
deviceId: deviceId,
success: (res) => {
console.log(res)
},
fail:(res) => {
},
complete: (res)=>{
}
});
//停止搜索
my.stopBluetoothDevicesDiscovery({
success: (res) => {
console.log(res)
},
fail:(res) => {
},
complete: (res)=>{
}
});
}
});
//注册连接事件
my.onBLEConnectionStateChanged({
success: (res) => {
console.log(res);
if (res.connected) {
//开始读写notify等操作
my.notifyBLECharacteristicValueChange({
deviceId: deviceId,
serviceId: serviceId,
characteristicId: characteristicId,
success: (res) => {
console.log(res)
},
fail:(res) => {
},
complete: (res)=>{
}
});
}
}
});
//注册接收read或notify的数据
my.onBLECharacteristicValueChange({
success: (res) => {
console.log(res);
}
});
//开始搜索
my.startBluetoothDevicesDiscovery({
services: ['fff0'],
success: (res) => {
console.log(res)
},
fail:(res) => {
},
complete: (res)=>{
}
});
//断开连接
my.disconnectBLEDevice({
deviceId: deviceId,
success: (res) => {
console.log(res)
},
fail:(res) => {
},
complete: (res)=>{
}
});
//注销事件
my.offBluetoothDeviceFound();
my.offBLEConnectionStateChanged();
my.offBLECharacteristicValueChange();
//退出蓝牙模块
my.closeBluetoothAdapter({
success: (res) => {
},
fail:(res) => {
},
complete: (res)=>{
}
});

常见问题

支持版本 android4.3以上支持ble

ios6以上都支持

deviceId，android取到的是蓝牙的mac地址(11:22:33:44:55:66)，ios取到的是UUID(00000000-0000-0000-0000-000000000000这种格式)

调startBluetoothDevicesDiscovery接口搜索不到设备，请确保设备发出了广播。如果接口中有传入services，请确保设备的广播内容中包含了service的UUID

连接设备失败，请确认传入的deviceId是否正确，以及设备发出的信号是否足够强，在信号弱的时候可能会出现连接不上的情况

写数据失败，查看传入的deviceId、serviceId、characteristicId格式是否正确，deviceId是否已连接上(onBLEConnectionStateChanged这个事件中可以监听连接状态变化，getConnectedBluetoothDevices这个方法可以拿到)，确保是在连接状态下调写入方法，查看characteristicId是否属于这个service，以及这个特征值是否支持写

读数据失败，同上，查看这个特征值是否支持读

收不到数据通知，请确认调了notifyBLECharacteristicValueChange这个方法以及传入的参数是否正确，传入的characteristicId特征值是否支持notify或indicate，以及确认硬件是否发出了通知。注意调用notifyBLECharacteristicValueChange方法的以及注册onBluetoothDeviceFound事件的顺序，最好是在连接之后就调用notifyBLECharacteristicValueChange方法。

事件回调多次调用，是由于多次匿名函数注册监听同一事件，因此建议每次调用on方法监听事件之前，先调用off方法，关闭之前的事件监听。