uni-app 蓝牙开发

一. 前言

Uni-App 是一个使用 Vue.js 开发(所有)前端应用的框架,能够编译到 iOSAndroid、快应用以及各种小程序等多个平台。因此,如果你需要快速开发一款跨平台的应用,比如在 H5、小程序、iOSAndroid 等多个平台上线,那么 Uni-App 是一个不错的选择。

Uni-App 进行多平台开发的优势不言而喻,同时主要因为它拥有许多跨端的 API 兼容支持和条件编译,在各个平台可以使用同一套 API 或通过条件编译使用不同的代码。

以上说了这么多,今天我们主要学习蓝牙连接相关的 API,同时也是为了后续开发蓝牙打印功能打基础。

蓝牙功能的开发是移动应用中非常常见的一项特性,可以用于设备间的数据传输等场景。关于蓝牙连接的功能,Uni-App 提供了一系列的 API 来帮助开发者快速地实现跨平台应用开发。下面我总结了一张图,标识需要了解的蓝牙连接核心 API.

二. 蓝牙主要功能

Uni-App 提供的蓝牙 API 允许我们开发时主要实现以下功能:

  • 扫描并连接到蓝牙设备
  • 发现已连接设备的服务和特征值
  • 向设备发送数据
  • 接收设备发送的数据

流程图:

关于开发时进行蓝牙连接的流程,我总结了以下这张图:

三. 蓝牙核心 API 介绍

蓝牙 API 分为通用蓝牙 API 和低功耗蓝牙的 API,这里主要介绍低功耗蓝牙,应用场景广泛。

通用蓝牙 API

AppHarmonyH5微信小程序支付宝小程序百度小程序抖音小程序飞书小程序QQ小程序快手小程序京东小程序元服务
xxxxxxx
1.初始化蓝牙模块

当开始使用蓝牙前,需要先初始化蓝牙模块,初始化蓝牙适配器成功后才可以继续使用其他的 API

uni.openBluetoothAdapter({success: function (res) {console.log('初始化蓝牙适配器成功', res)},fail: function (err) {console.error('初始化蓝牙适配器失败', err)}
})
2. 开始搜索蓝牙设备

初始化成功后,就可以通过调用 startBluetoothDevicesDiscovery 方法开始搜索附近的蓝牙设备:

注意:此操作比较耗费系统资源,请在搜索并连接到设备后调用  uni.stopBluetoothDevicesDiscovery  方法停止搜索。

uni.startBluetoothDevicesDiscovery({success: function (res) {console.log('开始搜索蓝牙设备', res)},fail: function (err) {console.error('开始搜索蓝牙设备失败', err)}
})

说明:App 端目前仅支持发现 BLE 低功耗蓝牙设备,其实我们也主要和低功耗蓝牙设备建立通信关系。一般为发送指令(开关机、蓝牙打印等),接收数据(蓝牙温度记录仪)

3. 停止搜索蓝牙设备

当不再需要继续搜索设备时,可以调用 stopBluetoothDevicesDiscovery 停止搜索:

uni.stopBluetoothDevicesDiscovery({success: function (res) {console.log('停止搜索蓝牙设备', res)},fail: function (err) {console.error('停止搜索蓝牙设备失败', err)}
})
4. 监听已发现的蓝牙设备

通过 onBluetoothDeviceFound 方法获取当前已发现的蓝牙设备列表,此方式是回调方法,只要发现了新的蓝牙设备,都会进入该回调:

uni.onBluetoothDeviceFound(function (devices) {console.log('new device list has founded')console.dir(devices)
})
5. 获取已发现的蓝牙设备列表

通过 getBluetoothDevices 方法获取在蓝牙模块生效期间所有已发现的蓝牙设备。包括已经和本机处于连接状态的设备。

uni.getBluetoothDevices({success: function (res) {console.log('已发现的蓝牙设备', res.devices)},fail: function (err) {console.error('获取已发现的蓝牙设备列表失败', err)}
})

 

6. 关闭蓝牙模块

通过调用 closeBluetoothAdapter 方法将关闭蓝牙模块,断开所有已建立的连接并释放系统资源。

调用该方法将断开所有已建立的连接并释放系统资源。一般在使用蓝牙流程完毕后,主动调用该方法,可在页面生命周期中使用。 应与  uni.openBluetoothAdapter 成对调用。

uni.closeBluetoothAdapter({success(res) {console.log(res)}
})

 低功耗蓝牙 API

AppHarmonyH5微信小程序支付宝小程序百度小程序抖音小程序飞书小程序QQ小程序快手小程序京东小程序元服务
xxxxxxx
1. 连接到蓝牙设备

选择一个设备后,可以通过设备 ID 调用 createBLEConnection 方法建立与该设备的连接:

uni.createBLEConnection({deviceId: '目标设备ID',success: function (res) {console.log('连接蓝牙设备成功', res)},fail: function (err) {console.error('连接蓝牙设备失败', err)}
})
2. 获取蓝牙设备的服务

连接成功后,可以通过设备 ID 调用 getBLEDeviceServices 方法获取该设备提供的服务:

uni.getBLEDeviceServices({deviceId: '目标设备ID',success: function (res) {console.log('获取蓝牙设备服务成功', res.services)},fail: function (err) {console.error('获取蓝牙设备服务失败', err)}
})
3. 获取服务中的特征值

获取服务成功后,可以通过备 ID,服务 ID 调用 getBLEDeviceCharacteristics 方法获取特定服务下的特征值:

uni.getBLEDeviceCharacteristics({deviceId: '目标设备ID',serviceId: '服务ID',success: function (res) {console.log('获取蓝牙设备特征值成功', res.characteristics)},fail: function (err) {console.error('获取蓝牙设备特征值失败', err)}
})
4. 向蓝牙设备写入数据

确定了要使用的特征值后,可以使用 writeBLECharacteristicValue 方法向蓝牙设备写入数据:

注意:只有获取到支持读写的特征值后,才可以像蓝牙设备写入数据。

uni.writeBLECharacteristicValue({deviceId: '目标设备ID',serviceId: '服务ID',characteristicId: '特征值ID',value: new ArrayBuffer(2), // 示例数据success: function (res) {console.log('向蓝牙设备写入数据成功', res)},fail: function (err) {console.error('向蓝牙设备写入数据失败', err)}
})

说明:蓝牙打印机主要会使用该 API,将在下一文章中说明。

5. 监听来自蓝牙设备的数据

如果需要接收来自蓝牙设备的数据,可以监听 onBLECharacteristicValueChange 事件:

uni.onBLECharacteristicValueChange(function (res) {console.log('接收到蓝牙设备数据', res.value)
})
6. 断开蓝牙连接

通过调用 closeBLEConnection 断开与低功耗蓝牙设备的连接。

uni.closeBLEConnection({deviceId,success(res) {console.log(res)}
})

四. 使用蓝牙 API 前的准备

Uni-App 中使用蓝牙功能时,尤其是真机(AndroidiOS),需要添加蓝牙打包模块;除此之外,还需要确保在 manifest.json 文件中正确声明所需的蓝牙权限,并在运行时请求这些权限。

1. 添加蓝牙模块

2. Android 权限

处理 Android 蓝牙权限需要在 manifest.json 中声明权限,首先,打开你的 manifest.json 文件,并在 app-plus 节点下添加所需的蓝牙权限。

注意:根据不同的 Android 版本,你可能需要声明不同的权限。

基本权限

manifest.json 配置如下权限:

{"app-plus": {"distribute": {"android": {"permissions": ["android.permission.BLUETOOTH", "android.permission.BLUETOOTH_ADMIN"]}}}
}
高级权限(Android 12 及以上)

如果应用需要扫描附近的蓝牙设备,还需要声明 ACCESS_FINE_LOCATION 权限,从 Android 12 开始,还需要声明 BLUETOOTH_SCANBLUETOOTH_CONNECTBLUETOOTH_ADVERTISE 权限:

{"app-plus": {"distribute": {"android": {"permissions": ["android.permission.BLUETOOTH","android.permission.BLUETOOTH_ADMIN","android.permission.ACCESS_FINE_LOCATION","android.permission.BLUETOOTH_SCAN","android.permission.BLUETOOTH_CONNECT","android.permission.BLUETOOTH_ADVERTISE"]}}}
}

3. iOS

对于 iOS 平台,和 Android 平台类似,同样的需要 在manifest.json 文件,并在 app-plus 节点下添加所需的蓝牙权限。需要声明 NSBluetoothAlwaysUsageDescriptionNSBluetoothPeripheralUsageDescription,并在其中提供用途说明。

manifest.json 配置如下权限:

{"app-plus": {"distribute": {"ios": {"permissions": {"NSBluetoothAlwaysUsageDescription": "需要蓝牙权限以连接和控制外部设备","NSBluetoothPeripheralUsageDescription": "需要蓝牙权限以连接和控制外部设备"}}}}
}

4. 运行时请求权限

Uni-App 中,你可以使用 uni.authorize 方法来请求运行时权限。以下示例代码,表示如何在应用启动时请求蓝牙相关权限:

export default {data() {return {}},onReady() {this.checkAndRequestPermissions()},methods: {checkAndRequestPermissions() {const permissions = ['scope.bluetooth', 'scope.location']// 检查权限uni.getSetting({success: res => {let authResult = truepermissions.forEach(permission => {if (!res.authSetting[permission]) {authResult = falsereturn}})if (!authResult) {// 请求权限this.requestPermissions()} else {// 已经有权限,可以进行蓝牙操作this.initBluetooth()}}})},requestPermissions() {const permissions = ['scope.bluetooth', 'scope.location']permissions.forEach(permission => {uni.authorize({scope: permission,success: () => {console.log(`权限 ${permission} 请求成功`)},fail: err => {console.error(`权限 ${permission} 请求失败`, err)uni.showModal({title: '提示',content: '请在设置中开启蓝牙和位置权限',showCancel: false})}})})},initBluetooth() {uni.openBluetoothAdapter({success: res => {console.log('初始化蓝牙适配器成功', res)// 继续进行蓝牙操作},fail: err => {console.error('初始化蓝牙适配器失败', err)}})}}
}

5. 处理用户拒绝权限的情况

如果用户拒绝了权限请求,可以通过 uni.showModal 方法提示用户在设置中手动开启权限。如下所示:

uni.showModal({title: '提示',content: '请在设置中开启蓝牙和位置权限',confirmText: '去设置',success: res => {if (res.confirm) {uni.openSetting({success: settingData => {console.log('用户设置结果', settingData)}})}}
})

 

五. 注意事项

在使用蓝牙 API 时,请确保用户已经开启了手机的蓝牙功能和位置信息。

  1. 蓝牙 API 调用时机:蓝牙相关 API 的抵用必须在  uni.openBluetoothAdapter 调用之后使用,否则 API 会返回错误(errCode=10000)。

  2. 在用户蓝牙开关未开启或者手机不支持蓝牙功能的情况下,调用  uni.openBluetoothAdapter 会返回错误(errCode=10001),表示手机蓝牙功能不可用。

  3. 版本兼容性:部分蓝牙 API 可能因操作系统版本不同而有所差异,具体请参考官方文档。

  4. 用户提示:确保在请求蓝牙权限时提供清晰的提示信息,告知用户为什么需要这些权限。

  5. 蓝牙状态检查:在初始化蓝牙适配器之前,应检查蓝牙是否已开启。可以使用 uni.getBluetoothAdapterState 方法来检查蓝牙状态,如下代码:

uni.getBluetoothAdapterState({success: res => {if (!res.discovering && !res.available) {uni.showModal({title: '提示',content: '请确保蓝牙已开启',showCancel: false})}},fail: err => {console.error('检查蓝牙适配器状态失败', err)}
})

六. 官方api文档

通过以上的蓝牙连接核心 API 的了解,基本可以在 Uni-App 中正确声明和请求蓝牙权限,并且和低功耗蓝牙建立连接,并成功获取蓝牙设备的服务和特征值。

 

#uni.setBLEMTU(OBJECT)

2.8.4+

设置蓝牙最大传输单元。需在 uni.createBLEConnection调用成功后调用,mtu 设置范围 (22,512)。安卓5.1以上有效。

OBJECT 参数说明

属性类型默认值必填说明
deviceIdstring用于区分设备的 id
mtunumber最大传输单元(22,512) 区间内,单位 bytes
successfunction接口调用成功的回调函数
failfunction接口调用失败的回调函数
completefunction接口调用结束的回调函数(调用成功、失败都会执行)

#uni.writeBLECharacteristicValue(OBJECT)

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

OBJECT 参数说明

属性类型默认值必填说明
deviceIdstring蓝牙设备 id
serviceIdstring蓝牙特征值对应服务的 uuid
characteristicIdstring蓝牙特征值的 uuid
valueArrayBuffer蓝牙设备特征值对应的二进制值
writeTypestring蓝牙特征值的写模式设置,有两种模式,iOS 优先 write,安卓优先 writeNoResponse 。微信小程序支持
successfunction接口调用成功的回调函数
failfunction接口调用失败的回调函数
completefunction接口调用结束的回调函数(调用成功、失败都会执行)

writeType

属性说明
write强制回复写,不支持时报错
writeNoResponse强制无回复写,不支持时报错

#错误

错误码错误信息说明
0ok正常
10000not init未初始化蓝牙适配器
10001not available当前蓝牙适配器不可用
10002no device没有找到指定设备
10003connection fail连接失败
10004no service没有找到指定服务
10005no characteristic没有找到指定特征值
10006no connection当前连接已断开
10007property not support当前特征值不支持此操作
10008system error其余所有系统上报的异常
10009system not supportAndroid 系统特有,系统版本低于 4.3 不支持 BLE
10010already connect已连接
10011need pin配对设备需要配对码
10012operate time out连接超时
10013invalid_data连接 deviceId 为空或者是格式不正确

#注意

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

#示例代码

// 向蓝牙设备发送一个0x00的16进制数据
const buffer = new ArrayBuffer(1)
const dataView = new DataView(buffer)
dataView.setUint8(0, 0)
uni.writeBLECharacteristicValue({// 这里的 deviceId 需要在 getBluetoothDevices 或 onBluetoothDeviceFound 接口中获取deviceId,// 这里的 serviceId 需要在 getBLEDeviceServices 接口中获取serviceId,// 这里的 characteristicId 需要在 getBLEDeviceCharacteristics 接口中获取characteristicId,// 这里的value是ArrayBuffer类型value: buffer,success(res) {console.log('writeBLECharacteristicValue success', res.errMsg)}
})

#uni.readBLECharacteristicValue(OBJECT)

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

OBJECT 参数说明

属性类型默认值必填说明
deviceIdstring蓝牙设备 id
serviceIdstring蓝牙特征值对应服务的 uuid
characteristicIdstring蓝牙特征值的 uuid
successfunction接口调用成功的回调函数
failfunction接口调用失败的回调函数
completefunction接口调用结束的回调函数(调用成功、失败都会执行)

#错误

错误码错误信息说明
0ok正常
10000not init未初始化蓝牙适配器
10001not available当前蓝牙适配器不可用
10002no device没有找到指定设备
10003connection fail连接失败
10004no service没有找到指定服务
10005no characteristic没有找到指定特征值
10006no connection当前连接已断开
10007property not support当前特征值不支持此操作
10008system error其余所有系统上报的异常
10009system not supportAndroid 系统特有,系统版本低于 4.3 不支持 BLE
10010already connect已连接
10011need pin配对设备需要配对码
10012operate time out连接超时
10013invalid_data连接 deviceId 为空或者是格式不正确

#注意

  • 并行调用多次会存在读失败的可能性。
  • 接口读取到的信息需要在 onBLECharacteristicValueChange 方法注册的回调中获取。

#示例代码

// 必须在这里的回调才能获取
uni.onBLECharacteristicValueChange(function (characteristic) {console.log('characteristic value comed:', characteristic)
})
uni.readBLECharacteristicValue({// 这里的 deviceId 需要已经通过 createBLEConnection 与对应设备建立链接deviceId,// 这里的 serviceId 需要在 getBLEDeviceServices 接口中获取serviceId,// 这里的 characteristicId 需要在 getBLEDeviceCharacteristics 接口中获取characteristicId,success(res) {console.log('readBLECharacteristicValue:', res.errCode)}
})

#uni.onBLEConnectionStateChange(CALLBACK)

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

CALLBACK 返回参数

属性类型说明
deviceIdstring蓝牙设备ID
connectedboolean是否处于已连接状态

#示例代码

uni.onBLEConnectionStateChange(function (res) {// 该方法回调中可以用于处理连接意外断开等异常情况console.log(`device ${res.deviceId} state has changed, connected: ${res.connected}`)
})

#uni.onBLECharacteristicValueChange(CALLBACK)

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

CALLBACK 返回参数

属性类型说明
deviceIdstring蓝牙设备 id
serviceIdstring蓝牙特征值对应服务的 uuid
characteristicIdstring蓝牙特征值的 uuid
valueArrayBuffer特征值最新的值

#示例代码

// ArrayBuffer转16进度字符串示例
function ab2hex(buffer) {const hexArr = Array.prototype.map.call(new Uint8Array(buffer),function (bit) {return ('00' + bit.toString(16)).slice(-2)})return hexArr.join('')
}
uni.onBLECharacteristicValueChange(function (res) {console.log(`characteristic ${res.characteristicId} has changed, now is ${res.value}`)console.log(ab2hex(res.value))
})

#uni.notifyBLECharacteristicValueChange(OBJECT)

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

OBJECT 参数说明

属性类型默认值必填说明
deviceIdstring蓝牙设备 id
serviceIdstring蓝牙特征值对应服务的 uuid
characteristicIdstring蓝牙特征值的 uuid
stateboolean是否启用 notify
successfunction接口调用成功的回调函数
failfunction接口调用失败的回调函数
completefunction接口调用结束的回调函数(调用成功、失败都会执行)

#错误

错误码错误信息说明
0ok正常
10000not init未初始化蓝牙适配器
10001not available当前蓝牙适配器不可用
10002no device没有找到指定设备
10003connection fail连接失败
10004no service没有找到指定服务
10005no characteristic没有找到指定特征值
10006no connection当前连接已断开
10007property not support当前特征值不支持此操作
10008system error其余所有系统上报的异常
10009system not supportAndroid 系统特有,系统版本低于 4.3 不支持 BLE
10010already connect已连接
10011need pin配对设备需要配对码
10012operate time out连接超时
10013invalid_data连接 deviceId 为空或者是格式不正确

#注意

  • 订阅操作成功后需要设备主动更新特征值的 value,才会触发 uni.onBLECharacteristicValueChange 回调。
  • 安卓平台上,在调用 notifyBLECharacteristicValueChange 成功后立即调用 writeBLECharacteristicValue 接口,在部分机型上会发生 10008 系统错误

#示例代码

uni.notifyBLECharacteristicValueChange({state: true, // 启用 notify 功能// 这里的 deviceId 需要已经通过 createBLEConnection 与对应设备建立链接deviceId,// 这里的 serviceId 需要在 getBLEDeviceServices 接口中获取serviceId,// 这里的 characteristicId 需要在 getBLEDeviceCharacteristics 接口中获取characteristicId,success(res) {console.log('notifyBLECharacteristicValueChange success', res.errMsg)}
})

#uni.getBLEDeviceServices(OBJECT)

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

OBJECT 参数说明

属性类型默认值必填说明
deviceIdstring蓝牙设备 id
successfunction接口调用成功的回调函数
failfunction接口调用失败的回调函数
completefunction接口调用结束的回调函数(调用成功、失败都会执行)

success 返回参数说明:

属性类型说明
servicesArray<Object>设备服务列表

res.services 的结构

属性类型说明
uuidstring蓝牙设备服务的 uuid
isPrimaryboolean该服务是否为主服务

#错误

错误码错误信息说明
0ok正常
10000not init未初始化蓝牙适配器
10001not available当前蓝牙适配器不可用
10002no device没有找到指定设备
10003connection fail连接失败
10004no service没有找到指定服务
10005no characteristic没有找到指定特征值
10006no connection当前连接已断开
10007property not support当前特征值不支持此操作
10008system error其余所有系统上报的异常
10009system not supportAndroid 系统特有,系统版本低于 4.3 不支持 BLE
10010already connect已连接
10011need pin配对设备需要配对码
10012operate time out连接超时
10013invalid_data连接 deviceId 为空或者是格式不正确

#示例代码

uni.getBLEDeviceServices({// 这里的 deviceId 需要已经通过 createBLEConnection 与对应设备建立链接deviceId,success(res) {console.log('device services:', res.services)}
})

#uni.getBLEDeviceRSSI(OBJECT)

2.8.4+

获取蓝牙设备的信号强度。

OBJECT 参数说明

属性类型默认值必填说明
deviceIdstring蓝牙设备 id
successfunction接口调用成功的回调函数
failfunction接口调用失败的回调函数
completefunction接口调用结束的回调函数(调用成功、失败都会执行)

#uni.getBLEDeviceCharacteristics(OBJECT)

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

OBJECT 参数说明

属性类型默认值必填说明
deviceIdstring蓝牙设备 id
serviceIdstring蓝牙服务 uuid,需要使用 getBLEDeviceServices 获取
successfunction接口调用成功的回调函数
failfunction接口调用失败的回调函数
completefunction接口调用结束的回调函数(调用成功、失败都会执行)

success 返回参数说明:

属性类型说明
characteristicsArray<Object>设备服务列表

res.characteristics 的结构

属性类型说明
uuidstring蓝牙设备特征值的 uuid
propertiesObject该特征值支持的操作类型

properties 的结构

属性类型说明
readboolean该特征值是否支持 read 操作
writeboolean该特征值是否支持 write 操作
notifyboolean该特征值是否支持 notify 操作
indicateboolean该特征值是否支持 indicate 操作

#错误

错误码错误信息说明
0ok正常
10000not init未初始化蓝牙适配器
10001not available当前蓝牙适配器不可用
10002no device没有找到指定设备
10003connection fail连接失败
10004no service没有找到指定服务
10005no characteristic没有找到指定特征值
10006no connection当前连接已断开
10007property not support当前特征值不支持此操作
10008system error其余所有系统上报的异常
10009system not supportAndroid 系统特有,系统版本低于 4.3 不支持 BLE

#示例代码

uni.getBLEDeviceCharacteristics({// 这里的 deviceId 需要已经通过 createBLEConnection 与对应设备建立链接deviceId,// 这里的 serviceId 需要在 getBLEDeviceServices 接口中获取serviceId,success(res) {console.log('device getBLEDeviceCharacteristics:', res.characteristics)}
})

#uni.createBLEConnection(OBJECT)

连接低功耗蓝牙设备。

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

OBJECT 参数说明

属性类型默认值必填说明
deviceIdstring用于区分设备的 id
timeoutnumber超时时间,单位ms,不填表示不会超时,京东小程序不支持
successfunction接口调用成功的回调函数
failfunction接口调用失败的回调函数
completefunction接口调用结束的回调函数(调用成功、失败都会执行)

#错误

错误码错误信息说明
0ok正常
10000not init未初始化蓝牙适配器
10001not available当前蓝牙适配器不可用
10002no device没有找到指定设备
10003connection fail连接失败
10004no service没有找到指定服务
10005no characteristic没有找到指定特征值
10006no connection当前连接已断开
10007property not support当前特征值不支持此操作
10008system error其余所有系统上报的异常
10009system not supportAndroid 系统特有,系统版本低于 4.3 不支持 BLE
10010already connect已连接
10011need pin配对设备需要配对码
10012operate time out连接超时
10013invalid_data连接 deviceId 为空或者是格式不正确

#注意

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

#示例代码

uni.createBLEConnection({// 这里的 deviceId 需要已经通过 createBLEConnection 与对应设备建立链接deviceId,success(res) {console.log(res)}
})

#uni.closeBLEConnection(OBJECT)

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

OBJECT 参数说明

属性类型默认值必填说明
deviceIdstring用于区分设备的 id
successfunction接口调用成功的回调函数
failfunction接口调用失败的回调函数
completefunction接口调用结束的回调函数(调用成功、失败都会执行)

#错误

错误码错误信息说明
0ok正常
10000not init未初始化蓝牙适配器
10001not available当前蓝牙适配器不可用
10002no device没有找到指定设备
10003connection fail连接失败
10004no service没有找到指定服务
10005no characteristic没有找到指定特征值
10006no connection当前连接已断开
10007property not support当前特征值不支持此操作
10008system error其余所有系统上报的异常
10009system not supportAndroid 系统特有,系统版本低于 4.3 不支持 BLE
10010already connect已连接
10011need pin配对设备需要配对码
10012operate time out连接超时
10013invalid_data连接 deviceId 为空或者是格式不正确

#示例代码

uni.closeBLEConnection({deviceId,success(res) {console.log(res)}
})

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.rhkb.cn/news/480231.html

如若内容造成侵权/违法违规/事实不符,请联系长河编程网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

C语言——海龟作图(对之前所有内容复习)

一.问题描述 海龟作图 设想有一只机械海龟&#xff0c;他在C程序控制下在屋里四处爬行。海龟拿了一只笔&#xff0c;这支笔或者朝上&#xff0c;或者朝下。当笔朝下时&#xff0c;海龟用笔画下自己的移动轨迹&#xff1b;当笔朝上时&#xff0c;海龟在移动过程中什么也不画。 …

【Maven】继承和聚合

5. Maven的继承和聚合 5.1 什么是继承 Maven 的依赖传递机制可以一定程度上简化 POM 的配置&#xff0c;但这仅限于存在依赖关系的项目或模块中。当一个项目的多个模块都依赖于相同 jar 包的相同版本&#xff0c;且这些模块之间不存在依赖关系&#xff0c;这就导致同一个依赖…

Android 性能优化:内存优化(理论篇)

内存作为App程序运行最重要的资源之一&#xff0c;需要运行过程中做到合理的资源分配与回收&#xff0c;不合理的内存占用轻则使得用户应用程序运行卡顿、ANR、黑屏&#xff0c;重则导致用户应用程序发生 OOM&#xff08;out of memory&#xff09;崩溃。喜马直播随着近些年的业…

技能之发布自己的依赖到npm上

目录 开始 解决 步骤一&#xff1a; 步骤二&#xff1a; 步骤三&#xff1a; 运用 一直以为自己的项目在github上有了&#xff08;之传了github&#xff09;就可以进行npm install下载&#xff0c;有没有和我一样萌萌的同学。没事&#xff0c;萌萌乎乎的不犯罪。 偶然的机…

【选择排序和交换排序】直接选择排序、堆排序、冒泡排序、快速排序

【选择排序和交换排序】直接选择排序、堆排序、冒泡排序、快速排序 1. 选择排序1.1 直接选择排序1.1.1详细过程1.1.2 代码实现1.1.3 复杂度和稳定性 1.2 堆排序 2. 交换排序2.1 冒泡排序2.1.1 代码实现2.1.2 复杂度和稳定性 2.2 快速排序——挖坑法2.2.1详细过程2.2.2 代码实现…

DI依赖注入详解

DI依赖注入 声明了一个成员变量&#xff08;对象&#xff09;之后&#xff0c;在该对象上面加上注解AutoWired注解&#xff0c;那么在程序运行时&#xff0c;该对象自动在IOC容器中寻找对应的bean对象&#xff0c;并且将其赋值给成员变量&#xff0c;完成依赖注入。 AutoWire…

51c大模型~合集79

我自己的原文哦~ https://blog.51cto.com/whaosoft/12661268 #还是回谷歌好 创业一年半&#xff0c;胖了30斤&#xff0c;AI大佬感叹 回到大厂&#xff0c;和老领导重聚。 「由于工作强度和不健康的生活方式&#xff0c;我已胖了 15 公斤。」 本周一&#xff0c;知名 AI 学…

工业AI质检 AI质检智能系统 尤劲恩(上海)信息科技有限公司

来的现代化工厂&#xff0c;将逐步被无人化车间取代&#xff0c;无人工厂除了产线自动化&#xff0c;其无人质检将是绕不开的话题。尤劲恩致力于帮助工业制造领域上下游工厂减员增效、提高品质效率&#xff0c;真正实现无人质检IQC/IPQC/OQC的在线质检系统。分析生产环节真实品…

【CSS in Depth 2 精译_062】第 10 章 CSS 中的容器查询(@container)概述 + 10.1 容器查询的一个简单示例

当前内容所在位置&#xff08;可进入专栏查看其他译好的章节内容&#xff09; 【第十章 CSS 容器查询】 ✔️ 10.1 容器查询的一个简单示例 ✔️ 10.1.1 容器尺寸查询的用法 ✔️ 10.2 深入理解容器10.3 与容器相关的单位10.4 容器样式查询的用法10.5 本章小结 文章目录 第 10…

ELK(Elasticsearch + logstash + kibana + Filebeat + Kafka + Zookeeper)日志分析系统

文章目录 前言架构软件包下载 一、准备工作1. Linux 网络设置2. 配置hosts文件3. 配置免密登录4. 设置 NTP 时钟同步5. 关闭防火墙6. 关闭交换分区7. 调整内存映射区域数限制8. 调整文件、进程、内存资源限制 二、JDK 安装1. 解压软件2. 配置环境变量3. 验证软件 三、安装 Elas…

视频汇聚平台Liveweb国标GB28181视频平台监控中心设计

在现代安防视频监控领域&#xff0c;Liveweb视频汇聚平台以其卓越的兼容性和灵活的拓展能力&#xff0c;为用户提供了一套全面的解决方案。该平台不仅能够实现视频的远程监控、录像、存储与回放等基础功能&#xff0c;还涵盖了视频转码、视频快照、告警、云台控制、语音对讲以及…

Linux 内核 调用堆栈打印函数

文章目录 内核函数调用堆栈打印1. dump_stack()一、作用二、工作原理三、实现方式四、示例实际演示 2.WARN_ON()3. panic()一、函数作用二、函数行为三、panic() 函数的参数四、使用场景 4. BUG_ON()使用场景 内核函数调用堆栈打印 1. dump_stack() dump_stack()是Linux内核中…

C语言——指针初阶(一)

目录 一.什么是指针&#xff1f;&#xff1f;&#xff1f; 指针是什么&#xff1f; 指针变量&#xff1a; 总结&#xff1a; 总结&#xff1a; 二.指针和指针类型 指针-整数&#xff1a; 总结&#xff1a; 指针的解引用 总结&#xff1a; 三.野指针 如何规避野指针 往期…

【Redis】Redis 预备知识

目录 1. 基本全局命令 KEYS EXISTS DEL EXPIRE TTL TYPE 2. 数据结构和内部编码 3. 单线程架构 Redis 提供了5种数据结构&#xff0c;理解每种数据结构的特点对于 Redis 开发运维非常重要&#xff0c;同时掌握每种数据结构的常见命令&#xff0c;会在使用 Redis 的时…

Facebook广告无法投放是什么原因?

Facebook作为全球知名的社媒平台&#xff0c;同时也成为许多知名海外企业的广告首选。但很投手在投放过程中也发现&#xff0c;Facebook 广告投放失败或者被拒投&#xff0c;那到底为什么呢&#xff1f; 其实Facebook广告有着非常严格的审核制度&#xff0c;通常投放失败可能是…

【uniapp】轮播图

前言 Uniapp的swiper组件是一个滑块视图容器组件&#xff0c;可以在其中放置多个轮播图或滑动卡片。它是基于微信小程序的swiper组件进行封装&#xff0c;可以在不同的平台上使用&#xff0c;如微信小程序、H5、App等。 效果图 前端代码 swiper组件 <template><vi…

【JavaEE】多线程(3)

首先回顾一下线程不安全的原因&#xff1a; 线程是随机调度&#xff0c;抢占式执行的修改共享数据&#xff0c;多个线程修改同一个变量多个线程修改共享数据的操作不是原子性&#xff0c;&#xff08;count是3个CPU指令&#xff0c;但是赋值操作就是原子性的&#xff09;内存可…

(0基础保姆教程)-JavaEE开课啦!--12课程(Spring MVC注解 + Vue2.0 + Mybatis)-实验10

一、常见的SpringMVC注解有哪些&#xff1f; 1.Controller&#xff1a;用于声明一个类为 Spring MVC 控制器。 2.RequestMapping&#xff1a;用于将 HTTP 请求映射到特定的处理方法上。可以指定请求类型&#xff08;GET、POST等&#xff09;和URL路径。 3.GetMapping&#xff…

20241124 Typecho 视频插入插件

博文免不了涉及到视频插入这些,网上的插件都或多或少的比较重,和Typecho的风格不搭配 后面就有了DPlay插件精简而来的VideoInsertion插件 VideoInsertion: Typecho 视频插入插件 目录结构 rockhinlink-ht2:/var/www/html/typecho/usr/plugins/VideoInsertion$ tree -h [4.…

网络地址转换

NAT概述 解决公有地址不足&#xff0c;并且分配不均匀的问题 公有地址&#xff1a;由专门的机构管理、分配&#xff0c;可以在因特网上直接通信 私有地址&#xff1a;组织和个人可以任意使用&#xff0c;只能在内网使用的IP地址 A、B、C类地址中各预留了一些私有IP地址 A&…