1200字范文 > Bluetooth模块用于管理蓝牙设备搜索附近蓝牙设备实现简单数据传输

Bluetooth模块用于管理蓝牙设备搜索附近蓝牙设备实现简单数据传输

时间：2020-08-06 08:08:24

Bluetooth模块用于管理蓝牙设备，搜索附近蓝牙设备、实现简单数据传输等。

支持搜索发现所有蓝牙设备，但仅支持低功耗蓝牙ble传输协议，不支持蓝牙设备的配对连接传输大量数据。如果要连接非ble蓝牙设备，可以使用Native.js调用（请到.cn搜索bluetooth相关问答）。

方法：

closeBluetoothAdapter: 关闭蓝牙模块getBluetoothAdapterState: 获取本机蓝牙适配器状态getBluetoothDevices: 获取已搜索到的蓝牙设备getConnectedBluetoothDevices: 根据uuid获取处于已连接的设备onBluetoothAdapterStateChange: 监听蓝牙适配器状态变化事件onBluetoothDeviceFound: 监听搜索到新设备的事件openBluetoothAdapter: 初始化蓝牙模块startBluetoothDevicesDiscovery: 开始搜索附近的蓝牙设备stopBluetoothDevicesDiscovery: 停止搜寻附近的蓝牙外围设备closeBLEConnection: 断开与低功耗蓝牙设备的连接createBLEConnection: 连接低功耗蓝牙设备setBLEMTU: 设置蓝牙最大传输单元getBLEDeviceCharacteristics: 获取蓝牙设备指定服务中所有特征值(characteristic)getBLEDeviceRSSI: 获取蓝牙设备的信号强度getBLEDeviceServices: 获取蓝牙设备的所有服务(service)notifyBLECharacteristicValueChange: 启用低功耗蓝牙设备特征值变化时的notify功能，订阅特征值onBLECharacteristicValueChange: 监听低功耗蓝牙设备的特征值变化事件onBLEConnectionStateChange: 监听低功耗蓝牙设备连接状态变化事件readBLECharacteristicValue: 读取低功耗蓝牙设备指定特征值的二进制数据值writeBLECharacteristicValue: 向低功耗蓝牙设备指定特征值写入二进制数据

对象：

BluetoothDeviceInfo: 蓝牙设备信息BluetoothService: 蓝牙设备服务信息Bluetoothcharacteristic: 蓝牙设备特征值BluetoothcharacteristicProperties: 蓝牙设备特征值支持的操作类型

回调方法：

BluetoothSuccessCallback: 成功回调函数BluetoothFailCallback: 失败回调函数BluetoothCompleteCallback: 操作完成回调函数BluetoothAdapterStateChangeCallback: 蓝牙适配器状态变化事件回调函数BluetoothDeviceFoundCallback: 蓝牙适配器搜索到新设备事件回调函数BluetoothDeviceRSSICallback: 获取蓝牙设备信号强度成功回调函数BLEConnectionStateChangeCallback: 低功耗蓝牙设备连接状态变化事件回调函数BLECharacteristicValueChangeCallback: 低功耗蓝牙设备的特征值变化事件回调函数

权限：

5+功能模块（permissions）

<code>{// ..."permissions":{// ..."Bluetooth": {"description": "Bluetooth"}}}</code>

closeBluetoothAdapter

关闭蓝牙模块

<code>void plus.bluetooth.closeBluetoothAdapter(options);</code>

说明：

断开所有已经建立的连接，释放系统资源，要求在蓝牙功能使用完成后调用（于openBluetoothAdapter成对使用）。关闭成功后触发options参数中的success回调，失败触发options参数中的fail回调。

参数：

options参数为json类型，包含以下属性：

success:(BluetoothSuccessCallback) 可选关闭蓝牙模块成功回调函数fail:(BluetoothFailCallback) 可选关闭蓝牙模块失败回调函数complete:(BluetoothCompleteCallback) 可选关闭蓝牙模块操作完成回调函数

调用成功或失败都会触发此回调。

返回值：

void: 无

示例：

<code>// 关闭蓝牙模块function closeBluetoothAdapter(){plus.bluetooth.closeBluetoothAdapter({success:function(e){console.log('close success: '+JSON.stringify(e));},fail:function(e){console.log('close failed: '+JSON.stringify(e));}});}</code>

uni-app使用plus注意事项

getBluetoothAdapterState

获取本机蓝牙适配器状态

<code>void plus.bluetooth.getBluetoothAdapterState(options);</code>

说明：

获取成功后触发options参数中的success回调，失败触发options参数中的fail回调。

参数：

options参数为json类型，包含以下属性：

success:(BluetoothSuccessCallback) 可选获取蓝牙适配器状态成功回调函数

回调函数参数event对象包括以下属性： discovering - Boolean类型，蓝牙适配器是否正在搜索设备； available - Boolean类型，蓝牙适配器是否可用。

fail:(BluetoothFailCallback) 可选获取蓝牙适配器状态错误回调函数complete:(BluetoothCompleteCallback) 可选获取蓝牙适配器状态操作完成回调函数

调用成功或失败都会触发此回调。

返回值：

void: 无

示例：

<code>// 获取蓝牙状态function getBluetoothState(){plus.bluetooth.getBluetoothAdapterState({success:function(e){console.log('state success: '+JSON.stringify(e));},fail:function(e){console.log('state failed: '+JSON.stringify(e));}});}</code>

uni-app使用plus注意事项

getBluetoothDevices

获取已搜索到的蓝牙设备

<code>void plus.bluetooth.getBluetoothDevices(options);</code>

说明：

包括已经和本机处于连接状态的设备。获取成功后触发options参数中的success回调，失败触发options参数中的fail回调。

参数：

options参数为json类型，包含以下属性：

success:(BluetoothSuccessCallback) 可选获取蓝牙设备成功回调函数

回调函数参数event对象包括以下属性： devices - Array<Object>，设备列表信息。

fail:(BluetoothFailCallback) 可选获取蓝牙设备失败回调函数complete:(BluetoothCompleteCallback) 可选获取蓝牙设备操作完成回调函数

调用成功或失败都会触发此回调。

返回值：

void: 无

示例：

<code>// 获取已搜索到的蓝牙设备function getBluetoothDevices(){plus.bluetooth.getBluetoothDevices({success:function(e){var devices = e.devices;console.log('get devices success: '+e.length);for(var i in devices){console.log(i+': '+JSON.stringify(devices[i]));}},fail:function(e){console.log('get devices failed: '+JSON.stringify(e));}});}</code>

uni-app使用plus注意事项

getConnectedBluetoothDevices

根据uuid获取处于已连接的设备

<code>void plus.bluetooth.getConnectedBluetoothDevices(options);</code>

说明：

获取成功后触发options参数中的success回调，失败触发options参数中的fail回调。

参数：

options参数为json类型，包含以下属性：

services:(Array[String] ) 必选要获取设备的uuid列表

蓝牙设备主service的uuid列表。

初始化成功后触发options参数中的success回调，失败触发options参数中的fail回调。

参数：

options参数为json类型，包含以下属性：

success:(BluetoothSuccessCallback) 可选初始化成功回调函数fail:(BluetoothFailCallback) 可选初始化失败回调函数complete:(BluetoothCompleteCallback) 可选初始化操作完成回调函数

调用成功或失败都会触发此回调。

返回值：

void: 无

示例：

<code>// 打开蓝牙模块function openBluetoothAdapter(){plus.bluetooth.openBluetoothAdapter({success:function(e){console.log('open success: '+JSON.stringify(e));},fail:function(e){console.log('open failed: '+JSON.stringify(e));}});}</code>

uni-app使用plus注意事项

startBluetoothDevicesDiscovery

开始搜索附近的蓝牙设备

<code>void plus.bluetooth.startBluetoothDevicesDiscovery(options);</code>

说明：

此操作比较耗费系统资源，请在搜索并连接到设备后调用stopBluetoothDevicesDiscovery方法停止搜索。搜索成功后触发options参数中的success回调，失败触发options参数中的fail回调。

参数：

options参数为json类型，包含以下属性：

services:(Array[String] ) 可选要获取设备的uuid列表allowDuplicatesKey:(Boolean) 可选是否允许重复上报同一设备

如果允许重复上报，则onBlueToothDeviceFound方法会多次上报同一设备，但是RSSI值会有不同。

interval:(Number) 可选上报设备的间隔

0表示找到新设备立即上报，其他数值根据传入的间隔上报。

success:(BluetoothSuccessCallback) 可选开始搜索成功回调函数

搜索到设备后通过onBluetoothDeviceFound设置的回调返回设备信息，此回调只是表明开始搜索。

fail:(BluetoothFailCallback) 可选开始搜索失败回调函数complete:(BluetoothCompleteCallback) 可选开始搜索操作完成回调函数

调用成功或失败都会触发此回调。

返回值：

void: 无

示例：

<code>// 开始搜索蓝牙function startBluetoothDiscovery(){plus.bluetooth.openBluetoothAdapter({success:function(e){console.log('open success: '+JSON.stringify(e));plus.bluetooth.startBluetoothDevicesDiscovery({success:function(e){console.log('start discovery success: '+JSON.stringify(e));},fail:function(e){console.log('start discovery failed: '+JSON.stringify(e));}});},fail:function(e){console.log('open failed: '+JSON.stringify(e));}});}</code>

uni-app使用plus注意事项

stopBluetoothDevicesDiscovery

停止搜寻附近的蓝牙外围设备

<code>void plus.bluetooth.stopBluetoothDevicesDiscovery(options);</code>

说明：

若已经找到需要的蓝牙设备并不需要继续搜索时，应该调用该接口停止蓝牙搜索。停止成功后触发options参数中的success回调，失败触发options参数中的fail回调。

参数：

options参数为json类型，包含以下属性：

success:(BluetoothSuccessCallback) 可选停止搜寻成功回调函数fail:(BluetoothFailCallback) 可选停止搜寻失败回调函数complete:(BluetoothCompleteCallback) 可选停止搜寻操作完成回调函数

调用成功或失败都会触发此回调。

返回值：

void: 无

示例：

<code>// 结束搜索蓝牙function stopBluetoothDiscovery(){plus.bluetooth.stopBluetoothDevicesDiscovery({success:function(e){console.log('stop discovery success: '+JSON.stringify(e));plus.bluetooth.closeBluetoothAdapter({success:function(e){console.log('close success: '+JSON.stringify(e));},fail:function(e){console.log('close failed: '+JSON.stringify(e));}});},fail:function(e){console.log('stop discovery failed: '+JSON.stringify(e));}});}</code>

uni-app使用plus注意事项

closeBLEConnection

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

<code>void plus.bluetooth.closeBLEConnection(options);</code>

参数：

options参数为json类型，包含以下属性：

deviceId:(String) 必选蓝牙设备的idsuccess:(BluetoothSuccessCallback) 可选断开连接成功回调函数fail:(BluetoothFailCallback) 可选断开连接失败回调函数complete:(BluetoothCompleteCallback) 可选断开连接操作完成回调函数

调用成功或失败都会触发此回调。

返回值：

void: 无

示例：

<code>// 断开蓝牙设备function closeConnection(){plus.bluetooth.closeBLEConnection({deviceId:deviceId,success:function(e){console.log('close success: '+JSON.stringify(e));},fail:function(e){console.log('close failed: '+JSON.stringify(e));}});}</code>

uni-app使用plus注意事项

createBLEConnection

连接低功耗蓝牙设备

<code>void plus.bluetooth.createBLEConnection(options);</code>

说明：

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

参数：

options参数为json类型，包含以下属性：

deviceId:(String) 必选蓝牙设备的idtimeout:(Number) 可选超时时间

单位为ms（毫秒），不设置此属性表示不会超时。

success:(BluetoothSuccessCallback) 可选连接成功回调函数fail:(BluetoothFailCallback) 可选连接失败回调函数complete:(BluetoothCompleteCallback) 可选连接操作完成回调函数

调用成功或失败都会触发此回调。

返回值：

void: 无

示例：

uni-app使用plus注意事项

setBLEMTU

设置蓝牙最大传输单元

<code>void plus.bluetooth.setBLEMTU(options);</code>

说明：

需在 createBLEConnection 调用成功后调用，mtu 设置范围 (22,512)。 HBuilderX2.8.4+版本支持。

参数：

options参数为json类型，包含以下属性：

deviceId:(String) 必选设备的 idmtu:(Number) 必选最大传输单元(22,512) 区间内，单位为字节（bytes）success:(BluetoothSuccessCallback) 可选设置蓝牙最大传输单元成功回调函数fail:(BluetoothFailCallback) 可选设置蓝牙最大传输单元失败回调函数complete:(BluetoothCompleteCallback) 可选设置蓝牙最大传输单元操作完成回调函数

调用成功或失败都会触发此回调。

返回值：

void: 无

平台支持：

Android - 5.1+ (支持)iOS - ALL (不支持)

示例：

uni-app使用plus注意事项

getBLEDeviceCharacteristics

获取蓝牙设备指定服务中所有特征值(characteristic)

<code>void plus.bluetooth.getBLEDeviceCharacteristics(options);</code>

参数：

options参数为json类型，包含以下属性：

deviceId:(String) 必选蓝牙设备的idserviceId:(String) 必选蓝牙服务 uuid

可通过getBLEDeviceServices获取。

success:(BluetoothSuccessCallback) 可选获取特征值成功回调函数

回调函数参数event对象包括以下属性： characteristics - Array>Bluetoothcharacteristic<类型，蓝牙设备服务的特征值列表。

fail:(BluetoothFailCallback) 可选获取特征值失败回调函数complete:(BluetoothCompleteCallback) 可选获取特征值操作完成回调函数

调用成功或失败都会触发此回调。

返回值：

void: 无

示例：

uni-app使用plus注意事项

getBLEDeviceRSSI

获取蓝牙设备的信号强度

<code>void plus.bluetooth.getBLEDeviceRSSI(options);</code>

说明：

需在 createBLEConnection 调用成功后调用。 HBuilderX2.8.4+版本支持。

参数：

options参数为json类型，包含以下属性：

deviceId:(String) 必选设备的 idsuccess:(BluetoothDeviceRSSICallback) 可选获取蓝牙设备信号强度成功回调函数

回调函数参数event对象包括以下属性： RSSI - Number类型，蓝牙设备的信号强度。

fail:(BluetoothFailCallback) 可选获取蓝牙设备信号强度失败回调函数complete:(BluetoothCompleteCallback) 可选获取蓝牙设备信号强度操作完成回调函数

调用成功或失败都会触发此回调。

返回值：

void: 无

示例：

uni-app使用plus注意事项

getBLEDeviceServices

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

<code>void plus.bluetooth.getBLEDeviceServices(options);</code>

参数：

options参数为json类型，包含以下属性：

deviceId:(String) 必选蓝牙设备的idsuccess:(BluetoothSuccessCallback) 可选获取服务成功回调函数

回调函数参数event对象包括以下属性： services - Array>BluetoothService<类型，蓝牙设备服务的特征值列表。

fail:(BluetoothFailCallback) 可选获取服务失败回调函数complete:(BluetoothCompleteCallback) 可选获取服务操作完成回调函数

调用成功或失败都会触发此回调。

返回值：

void: 无

示例：

uni-app使用plus注意事项

notifyBLECharacteristicValueChange

启用低功耗蓝牙设备特征值变化时的notify功能，订阅特征值

<code>void plus.bluetooth.notifyBLECharacteristicValueChange(options);</code>

说明：

蓝牙设备服务的特征值必须支持notify或indicate才可以成功调用。另外，必须先启用notifyBLECharacteristicValueChange才能监听到设备characteristicValueChange事件,即特征值发生变化时通过onBLECharacteristicValueChange注册的事件回调。

参数：

options参数为json类型，包含以下属性：

deviceId:(String) 必选蓝牙设备的idserviceId:(String) 必选蓝牙服务的uuidcharacteristicId:(String) 必选蓝牙特征值的uuidstate:(Boolean) 必选是否启用 notifysuccess:(BluetoothSuccessCallback) 可选订阅特征值成功回调函数fail:(BluetoothFailCallback) 可选订阅特征值失败回调函数complete:(BluetoothCompleteCallback) 可选订阅特征值操作完成回调函数

调用成功或失败都会触发此回调。

返回值：

void: 无

示例：

<code>// 蓝牙设备id，可通过onBluetoothDeviceFound方法获取var deviceId = '';// 蓝牙服务id，可通过getBLEDeviceServices方法获取var serviceId = '';// 蓝牙特征值id，可通过getBLEDeviceCharacteristics方法获取var characteristicId = '';// 启用低功耗蓝牙设备特征值变化时的notify功能function startCharacteristicsNotify(){// 监听低功耗蓝牙设备的特征值变化 plus.bluetooth.onBLECharacteristicValueChange(function(e){console.log('onBLECharacteristicValueChange: '+JSON.stringify(e));var value = buffer2hex(e.value);console.log('value(hex) = '+value);if(characteristicId == e.characteristicId){// 更新到页面显示alert('特征值变化: '+value);}});// 启用notify功能plus.bluetooth.notifyBLECharacteristicValueChange({deviceId:deviceId,serviceId:serviceId,characteristicId:characteristicId,success:function(e){var characteristics = e.characteristics;console.log('get characteristics success: '+characteristics.length);for(var i in characteristics){console.log(i+': '+JSON.stringify(characteristics[i]));}},fail:function(e){console.log('get characteristics failed: '+JSON.stringify(e));}});}</code>

uni-app使用plus注意事项

onBLECharacteristicValueChange

监听低功耗蓝牙设备的特征值变化事件

<code>void plus.bluetooth.onBLECharacteristicValueChange(callback);</code>

参数：

callback:(BLECharacteristicValueChangeCallback) 必选特征值变化回调函数

回调函数参数event对象包括以下属性： deviceId - String类型，蓝牙设备id； serviceId - String类型，蓝牙服务的uuid； characteristicId - String类型，蓝牙特征值的uuid； value - ArrayBuffer类型，特征值的最新值。

返回值：

void: 无

示例：

uni-app使用plus注意事项

onBLEConnectionStateChange

监听低功耗蓝牙设备连接状态变化事件

<code>void plus.bluetooth.onBLEConnectionStateChange(callback);</code>

说明：

包括开发者主动连接或断开连接，设备丢失，连接异常断开等。

参数：

callback:(BLEConnectionStateChangeCallback) 必选连接状态变化回调函数

回调函数参数event对象包括以下属性： deviceId - String类型，蓝牙设备id； connected - Boolean类型，是否处于已连接状态。

返回值：

void: 无

示例：

<code>// 监听蓝牙设备连接状态function listenerConnection(){plus.bluetooth.onBLEConnectionStateChange(function(e){console.log('connection state changed: '+JSON.stringify(e));});}</code>

uni-app使用plus注意事项

readBLECharacteristicValue

读取低功耗蓝牙设备指定特征值的二进制数据值

<code>void plus.bluetooth.readBLECharacteristicValue(options);</code>

说明：

指定的特征值需支持read操作才可以成功调用。并行调用多次可能导致读取失败，读取的数据需要在onBLECharacteristicValueChange方法注册的回调中获取。

参数：

options参数为json类型，包含以下属性：

deviceId:(String) 必选蓝牙设备的idserviceId:(String) 必选蓝牙服务的uuidcharacteristicId:(String) 必选蓝牙特征值的uuidsuccess:(BluetoothSuccessCallback) 可选读取特征值的二进制数据成功回调函数fail:(BluetoothFailCallback) 可选读取特征值的二进制数据失败回调函数complete:(BluetoothCompleteCallback) 可选读取特征值的二进制数据操作完成回调函数

调用成功或失败都会触发此回调。

返回值：

void: 无

示例：

uni-app使用plus注意事项

writeBLECharacteristicValue

向低功耗蓝牙设备指定特征值写入二进制数据

<code>void plus.bluetooth.writeBLECharacteristicValue(options);</code>

说明：

指定的特征值需支持write操作才可以成功调用。并行调用多次可能导致读取失败，系统可能会限制单次传输的数据大小，超过最大字节数后可能会发生写入错误，建议每次写入不超过20字节。

参数：

options参数为json类型，包含以下属性：

deviceId:(String) 必选蓝牙设备的idserviceId:(String) 必选蓝牙服务的uuidcharacteristicId:(String) 必选蓝牙特征值的uuidvalue:(ArrayBuffer) 必选要写入的数据

写入到蓝牙设备指定特征值中的二进制值。

success:(BluetoothSuccessCallback) 可选读取特征值的二进制数据成功回调函数fail:(BluetoothFailCallback) 可选读取特征值的二进制数据失败回调函数complete:(BluetoothCompleteCallback) 可选读取特征值的二进制数据操作完成回调函数

调用成功或失败都会触发此回调。

返回值：

void: 无

示例：

uni-app使用plus注意事项

BluetoothDeviceInfo

蓝牙设备信息

成功回调函数

<code>void onSuccess(Object event){}</code>

说明：

不同接口触发的成功回调参数event包含的属性存在差异，具体参考对应的接口描述说明。

参数：

event:(Object) 必选回调参数

回调参数包含的属性由调用接口决定，具体参考对应的接口描述说明。

返回值：

void: 无

BluetoothFailCallback

失败回调函数

<code>function void onFail(Exception error){// Handle errorvar code = error.code; // 错误编码var message = error.message; // 错误描述信息}</code>

参数：

error:(Exception) 必选回调参数，错误信息

可通过error.code（Number类型）获取错误编码；可通过error.message（String类型）获取错误描述信息。

返回值：

void: 无

BluetoothCompleteCallback

BLECharacteristicValueChangeCallback

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

说明：

蓝牙设备对应的特征值发生变化时触发此回调。

参数：

event:(Object) 可选返回参数

返回值：

void: 无

本内容不代表本网观点和政治立场，如有侵犯你的权益请联系我们处理。

网友评论

网友评论仅供其表达个人看法，并不表明网站立场。

Bluetooth模块用于管理蓝牙设备 搜索附近蓝牙设备 实现简单数据传输

方法：

对象：

回调方法：

权限：

closeBluetoothAdapter

说明：

参数：

返回值：

示例：

getBluetoothAdapterState

说明：

参数：

返回值：

示例：

getBluetoothDevices

说明：

参数：

返回值：

示例：

getConnectedBluetoothDevices

说明：

参数：

返回值：

示例：

onBluetoothAdapterStateChange

说明：

参数：

返回值：

示例：

onBluetoothDeviceFound

说明：

参数：

返回值：

示例：

openBluetoothAdapter

说明：

参数：

返回值：

示例：

startBluetoothDevicesDiscovery

说明：

参数：

返回值：

示例：

stopBluetoothDevicesDiscovery

说明：

参数：

返回值：

示例：

closeBLEConnection

参数：

返回值：

示例：

createBLEConnection

说明：

参数：

返回值：

示例：

setBLEMTU

说明：

参数：

返回值：

平台支持：

示例：

getBLEDeviceCharacteristics

参数：

返回值：

示例：

getBLEDeviceRSSI

说明：

参数：

返回值：

示例：

getBLEDeviceServices

参数：

返回值：

示例：

notifyBLECharacteristicValueChange

说明：

Bluetooth模块用于管理蓝牙设备搜索附近蓝牙设备实现简单数据传输