宜信同城网交流论坛技术专版技术专区Bluetooth模块用于管理蓝牙设备，搜索附近蓝牙设备、实现简单数据传输 ...Bluetooth模块用于管理蓝牙设备，搜索附近蓝牙设备、实现简单数据传输等。支持搜索发现所有蓝牙设备&#x ...

admin 发表于 2023-2-16 18:54:54

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

<div id="article_content" class="article_content clearfix">
 <link rel="stylesheet" href="https://csdnimg.cn/release/blogv2/dist/mdeditor/css/editerView/kdoc_html_views-1a98987dfd.css">
 <link rel="stylesheet" href="https://csdnimg.cn/release/blogv2/dist/mdeditor/css/editerView/ck_htmledit_views-6e43165c0a.css">
 <div id="content_views" class="htmledit_views">
 Bluetooth模块用于管理蓝牙设备，搜索附近蓝牙设备、实现简单数据传输等。
支持搜索发现所有蓝牙设备，但仅支持低功耗蓝牙ble传输协议，不支持蓝牙设备的配对连接传输大量数据。如果要连接非ble蓝牙设备，可以使用Native.js调用（请到http://ask.dcloud.net.cn搜索bluetooth相关问答）。
<h2 style="margin-left:.8em;">方法：</h2>
<ul><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122683957#plus.bluetooth.closeBluetoothAdapter">closeBluetoothAdapter</a>: 关闭蓝牙模块</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122683957#plus.bluetooth.getBluetoothAdapterState">getBluetoothAdapterState</a>: 获取本机蓝牙适配器状态</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122683957#plus.bluetooth.getBluetoothDevices">getBluetoothDevices</a>: 获取已搜索到的蓝牙设备</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122683957#plus.bluetooth.getConnectedBluetoothDevices">getConnectedBluetoothDevices</a>: 根据uuid获取处于已连接的设备</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122683957#plus.bluetooth.onBluetoothAdapterStateChange">onBluetoothAdapterStateChange</a>: 监听蓝牙适配器状态变化事件</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122683957#plus.bluetooth.onBluetoothDeviceFound">onBluetoothDeviceFound</a>: 监听搜索到新设备的事件</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122683957#plus.bluetooth.openBluetoothAdapter">openBluetoothAdapter</a>: 初始化蓝牙模块</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122683957#plus.bluetooth.startBluetoothDevicesDiscovery">startBluetoothDevicesDiscovery</a>: 开始搜索附近的蓝牙设备</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122683957#plus.bluetooth.stopBluetoothDevicesDiscovery">stopBluetoothDevicesDiscovery</a>: 停止搜寻附近的蓝牙外围设备</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122683957#plus.bluetooth.closeBLEConnection">closeBLEConnection</a>: 断开与低功耗蓝牙设备的连接</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122683957#plus.bluetooth.createBLEConnection">createBLEConnection</a>: 连接低功耗蓝牙设备</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122683957#plus.bluetooth.setBLEMTU">setBLEMTU</a>: 设置蓝牙最大传输单元</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122683957#plus.bluetooth.getBLEDeviceCharacteristics">getBLEDeviceCharacteristics</a>: 获取蓝牙设备指定服务中所有特征值(characteristic)</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122683957#plus.bluetooth.getBLEDeviceRSSI">getBLEDeviceRSSI</a>: 获取蓝牙设备的信号强度</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122683957#plus.bluetooth.getBLEDeviceServices">getBLEDeviceServices</a>: 获取蓝牙设备的所有服务(service)</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122683957#plus.bluetooth.notifyBLECharacteristicValueChange">notifyBLECharacteristicValueChange</a>: 启用低功耗蓝牙设备特征值变化时的notify功能，订阅特征值</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122683957#plus.bluetooth.onBLECharacteristicValueChange">onBLECharacteristicValueChange</a>: 监听低功耗蓝牙设备的特征值变化事件</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122683957#plus.bluetooth.onBLEConnectionStateChange">onBLEConnectionStateChange</a>: 监听低功耗蓝牙设备连接状态变化事件</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122683957#plus.bluetooth.readBLECharacteristicValue">readBLECharacteristicValue</a>: 读取低功耗蓝牙设备指定特征值的二进制数据值</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122683957#plus.bluetooth.writeBLECharacteristicValue">writeBLECharacteristicValue</a>: 向低功耗蓝牙设备指定特征值写入二进制数据</li></ul>
<h2 style="margin-left:.8em;">对象：</h2>
<ul><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122683957#plus.bluetooth.BluetoothDeviceInfo">BluetoothDeviceInfo</a>: 蓝牙设备信息</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122683957#plus.bluetooth.BluetoothService">BluetoothService</a>: 蓝牙设备服务信息</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122683957#plus.bluetooth.Bluetoothcharacteristic">Bluetoothcharacteristic</a>: 蓝牙设备特征值</li><li><ahref="https://www.html5plus.org/doc/zh_cn/bluetooth.html#plus.bluetooth.BluetoothcharacteristicProperties">BluetoothcharacteristicProperties</a>: 蓝牙设备特征值支持的操作类型</li></ul>
<h2 style="margin-left:.8em;">回调方法：</h2>
<ul><li><ahref="https://www.html5plus.org/doc/zh_cn/bluetooth.html#plus.bluetooth.BluetoothSuccessCallback">BluetoothSuccessCallback</a>: 成功回调函数</li><li><ahref="https://www.html5plus.org/doc/zh_cn/bluetooth.html#plus.bluetooth.BluetoothFailCallback">BluetoothFailCallback</a>: 失败回调函数</li><li><ahref="https://www.html5plus.org/doc/zh_cn/bluetooth.html#plus.bluetooth.BluetoothCompleteCallback">BluetoothCompleteCallback</a>: 操作完成回调函数</li><li><ahref="https://www.html5plus.org/doc/zh_cn/bluetooth.html#plus.bluetooth.BluetoothAdapterStateChangeCallback">BluetoothAdapterStateChangeCallback</a>: 蓝牙适配器状态变化事件回调函数</li><li><ahref="https://www.html5plus.org/doc/zh_cn/bluetooth.html#plus.bluetooth.BluetoothDeviceFoundCallback">BluetoothDeviceFoundCallback</a>: 蓝牙适配器搜索到新设备事件回调函数</li><li><ahref="https://www.html5plus.org/doc/zh_cn/bluetooth.html#plus.bluetooth.BluetoothDeviceRSSICallback">BluetoothDeviceRSSICallback</a>: 获取蓝牙设备信号强度成功回调函数</li><li><ahref="https://www.html5plus.org/doc/zh_cn/bluetooth.html#plus.bluetooth.BLEConnectionStateChangeCallback">BLEConnectionStateChangeCallback</a>: 低功耗蓝牙设备连接状态变化事件回调函数</li><li><ahref="https://www.html5plus.org/doc/zh_cn/bluetooth.html#plus.bluetooth.BLECharacteristicValueChangeCallback">BLECharacteristicValueChangeCallback</a>: 低功耗蓝牙设备的特征值变化事件回调函数</li></ul>
<h2 style="margin-left:.8em;">权限：</h2>
5+功能模块（permissions）
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
{
// ...
"permissions":{
// ...
"Bluetooth": {
"description": "Bluetooth"
}
}
}
</code></code></pre>
<h1 style="margin-left:0;">closeBluetoothAdapter</h1>
关闭蓝牙模块
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void plus.bluetooth.closeBluetoothAdapter(options);
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
断开所有已经建立的连接，释放系统资源，要求在蓝牙功能使用完成后调用（于openBluetoothAdapter成对使用）。关闭成功后触发options参数中的success回调，失败触发options参数中的fail回调。
<h2 style="margin-left:.8em;">参数：</h2>
options参数为json类型，包含以下属性：
<ul><li>success: ( <ahref="https://www.html5plus.org/doc/zh_cn/bluetooth.html#plus.bluetooth.BluetoothSuccessCallback">BluetoothSuccessCallback</a> ) 可选 关闭蓝牙模块成功回调函数 </li><li>fail: ( <ahref="https://www.html5plus.org/doc/zh_cn/bluetooth.html#plus.bluetooth.BluetoothFailCallback">BluetoothFailCallback</a> ) 可选 关闭蓝牙模块失败回调函数 </li><li>complete: ( <ahref="https://www.html5plus.org/doc/zh_cn/bluetooth.html#plus.bluetooth.BluetoothCompleteCallback">BluetoothCompleteCallback</a> ) 可选 关闭蓝牙模块操作完成回调函数 调用成功或失败都会触发此回调。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><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></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">getBluetoothAdapterState</h1>
获取本机蓝牙适配器状态
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void plus.bluetooth.getBluetoothAdapterState(options);
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
获取成功后触发options参数中的success回调，失败触发options参数中的fail回调。
<h2 style="margin-left:.8em;">参数：</h2>
options参数为json类型，包含以下属性：
<ul><li>success: ( <ahref="https://www.html5plus.org/doc/zh_cn/bluetooth.html#plus.bluetooth.BluetoothSuccessCallback">BluetoothSuccessCallback</a> ) 可选 获取蓝牙适配器状态成功回调函数 回调函数参数event对象包括以下属性： discovering - Boolean类型，蓝牙适配器是否正在搜索设备； available - Boolean类型，蓝牙适配器是否可用。 </li><li>fail: ( <ahref="https://www.html5plus.org/doc/zh_cn/bluetooth.html#plus.bluetooth.BluetoothFailCallback">BluetoothFailCallback</a> ) 可选 获取蓝牙适配器状态错误回调函数 </li><li>complete: ( <ahref="https://www.html5plus.org/doc/zh_cn/bluetooth.html#plus.bluetooth.BluetoothCompleteCallback">BluetoothCompleteCallback</a> ) 可选 获取蓝牙适配器状态操作完成回调函数 调用成功或失败都会触发此回调。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><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></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">getBluetoothDevices</h1>
获取已搜索到的蓝牙设备
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void plus.bluetooth.getBluetoothDevices(options);
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
包括已经和本机处于连接状态的设备。获取成功后触发options参数中的success回调，失败触发options参数中的fail回调。
<h2 style="margin-left:.8em;">参数：</h2>
options参数为json类型，包含以下属性：
<ul><li>success: ( <ahref="https://www.html5plus.org/doc/zh_cn/bluetooth.html#plus.bluetooth.BluetoothSuccessCallback">BluetoothSuccessCallback</a> ) 可选 获取蓝牙设备成功回调函数 回调函数参数event对象包括以下属性： devices - Array<Object>，设备列表信息。 </li><li>fail: ( <ahref="https://www.html5plus.org/doc/zh_cn/bluetooth.html#plus.bluetooth.BluetoothFailCallback">BluetoothFailCallback</a> ) 可选 获取蓝牙设备失败回调函数 </li><li>complete: ( <ahref="https://www.html5plus.org/doc/zh_cn/bluetooth.html#plus.bluetooth.BluetoothCompleteCallback">BluetoothCompleteCallback</a> ) 可选 获取蓝牙设备操作完成回调函数 调用成功或失败都会触发此回调。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><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></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">getConnectedBluetoothDevices</h1>
根据uuid获取处于已连接的设备
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void plus.bluetooth.getConnectedBluetoothDevices(options);
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
获取成功后触发options参数中的success回调，失败触发options参数中的fail回调。
<h2 style="margin-left:.8em;">参数：</h2>
options参数为json类型，包含以下属性：
<ul><li>services: ( Array ) 必选 要获取设备的uuid列表 蓝牙设备主service的uuid列表。 </li><li>success: ( <ahref="https://www.html5plus.org/doc/zh_cn/bluetooth.html#plus.bluetooth.BluetoothSuccessCallback">BluetoothSuccessCallback</a> ) 可选 获取已连接设备成功回调函数 回调函数参数event对象包括以下属性： devices - Array<BluetoothDeviceInfo>，设备列表信息（只包含name和deviceId属性）。 </li><li>fail: ( <ahref="https://www.html5plus.org/doc/zh_cn/bluetooth.html#plus.bluetooth.BluetoothFailCallback">BluetoothFailCallback</a> ) 可选 获取已连接设备失败回调函数 </li><li>complete: ( <ahref="https://www.html5plus.org/doc/zh_cn/bluetooth.html#plus.bluetooth.BluetoothCompleteCallback">BluetoothCompleteCallback</a> ) 可选 获取已连接设备操作完成回调函数 调用成功或失败都会触发此回调。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 获取已连接的蓝牙设备
function getConnectedDevices(){
plus.bluetooth.getConnectedBluetoothDevices({
success:function(e){
var devices = e.devices;
console.log('connected devices success: '+e.length);
for(var i in devices){
console.log(i+': '+JSON.stringify(devices[i]));
}
},
fail:function(e){
console.log('connected devices failed: '+JSON.stringify(e));
}
});
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">onBluetoothAdapterStateChange</h1>
监听蓝牙适配器状态变化事件
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void plus.bluetooth.onBluetoothAdapterStateChange(changeCB);
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
蓝牙适配器状态发生变化时触发回调。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>changeCB: ( <ahref="https://blog.csdn.net/qq_40575646/article/details/122683957#plus.bluetooth.BluetoothAdapterStateChangeCallback">BluetoothAdapterStateChangeCallback</a> ) 必选 状态变化回调函数 回调函数参数event对象包括以下属性： discovering - Boolean类型，蓝牙适配器是否正在搜索设备； available - Boolean类型，蓝牙适配器是否可用。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 监听状态变化
function listenerStateChange(){
plus.bluetooth.onBluetoothAdapterStateChange(function(e){
console.log('state changed: '+JSON.stringify(e));
});
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">onBluetoothDeviceFound</h1>
监听搜索到新设备的事件
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void plus.bluetooth.onBluetoothDeviceFound(callback);
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
搜索到新设备时触发回调。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>callback: ( <ahref="https://blog.csdn.net/qq_40575646/article/details/122683957#plus.bluetooth.BluetoothDeviceFoundCallback">BluetoothDeviceFoundCallback</a> ) 必选 搜索到新设备回调函数 回调函数参数event对象包括以下属性： devices - Array<BluetoothDeviceInfo>，设备列表信息。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 监听发现新设备
function listenerDeviceFound(){
plus.bluetooth.onBluetoothDeviceFound(function(e){
var devices = e.devices;
console.log('device found: '+e.length);
for(var i in devices){
console.log(i+': '+JSON.stringify(devices[i]));
}
});
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">openBluetoothAdapter</h1>
初始化蓝牙模块
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void plus.bluetooth.openBluetoothAdapter(options);
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
初始化成功后触发options参数中的success回调，失败触发options参数中的fail回调。
<h2 style="margin-left:.8em;">参数：</h2>
options参数为json类型，包含以下属性：
<ul><li>success: ( <ahref="https://www.html5plus.org/doc/zh_cn/bluetooth.html#plus.bluetooth.BluetoothSuccessCallback">BluetoothSuccessCallback</a> ) 可选 初始化成功回调函数 </li><li>fail: ( <ahref="https://www.html5plus.org/doc/zh_cn/bluetooth.html#plus.bluetooth.BluetoothFailCallback">BluetoothFailCallback</a> ) 可选 初始化失败回调函数 </li><li>complete: ( <ahref="https://www.html5plus.org/doc/zh_cn/bluetooth.html#plus.bluetooth.BluetoothCompleteCallback">BluetoothCompleteCallback</a> ) 可选 初始化操作完成回调函数 调用成功或失败都会触发此回调。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><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></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">startBluetoothDevicesDiscovery</h1>
开始搜索附近的蓝牙设备
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void plus.bluetooth.startBluetoothDevicesDiscovery(options);
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
此操作比较耗费系统资源，请在搜索并连接到设备后调用stopBluetoothDevicesDiscovery方法停止搜索。搜索成功后触发options参数中的success回调，失败触发options参数中的fail回调。
<h2 style="margin-left:.8em;">参数：</h2>
options参数为json类型，包含以下属性：
<ul><li>services: ( Array ) 可选 要获取设备的uuid列表 </li><li>allowDuplicatesKey: ( Boolean ) 可选 是否允许重复上报同一设备 如果允许重复上报，则onBlueToothDeviceFound方法会多次上报同一设备，但是RSSI值会有不同。 </li><li>interval: ( Number ) 可选 上报设备的间隔 0表示找到新设备立即上报，其他数值根据传入的间隔上报。 </li><li>success: ( <ahref="https://www.html5plus.org/doc/zh_cn/bluetooth.html#plus.bluetooth.BluetoothSuccessCallback">BluetoothSuccessCallback</a> ) 可选 开始搜索成功回调函数 搜索到设备后通过onBluetoothDeviceFound设置的回调返回设备信息，此回调只是表明开始搜索。 </li><li>fail: ( <ahref="https://www.html5plus.org/doc/zh_cn/bluetooth.html#plus.bluetooth.BluetoothFailCallback">BluetoothFailCallback</a> ) 可选 开始搜索失败回调函数 </li><li>complete: ( <ahref="https://www.html5plus.org/doc/zh_cn/bluetooth.html#plus.bluetooth.BluetoothCompleteCallback">BluetoothCompleteCallback</a> ) 可选 开始搜索操作完成回调函数 调用成功或失败都会触发此回调。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><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></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">stopBluetoothDevicesDiscovery</h1>
停止搜寻附近的蓝牙外围设备
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void plus.bluetooth.stopBluetoothDevicesDiscovery(options);
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
若已经找到需要的蓝牙设备并不需要继续搜索时，应该调用该接口停止蓝牙搜索。停止成功后触发options参数中的success回调，失败触发options参数中的fail回调。
<h2 style="margin-left:.8em;">参数：</h2>
options参数为json类型，包含以下属性：
<ul><li>success: ( <ahref="https://www.html5plus.org/doc/zh_cn/bluetooth.html#plus.bluetooth.BluetoothSuccessCallback">BluetoothSuccessCallback</a> ) 可选 停止搜寻成功回调函数 </li><li>fail: ( <ahref="https://www.html5plus.org/doc/zh_cn/bluetooth.html#plus.bluetooth.BluetoothFailCallback">BluetoothFailCallback</a> ) 可选 停止搜寻失败回调函数 </li><li>complete: ( <ahref="https://www.html5plus.org/doc/zh_cn/bluetooth.html#plus.bluetooth.BluetoothCompleteCallback">BluetoothCompleteCallback</a> ) 可选 停止搜寻操作完成回调函数 调用成功或失败都会触发此回调。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><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></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">closeBLEConnection</h1>
断开与低功耗蓝牙设备的连接
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void plus.bluetooth.closeBLEConnection(options);
</code></code></pre>
<h2 style="margin-left:.8em;">参数：</h2>
options参数为json类型，包含以下属性：
<ul><li>deviceId: ( String ) 必选 蓝牙设备的id </li><li>success: ( <ahref="https://www.html5plus.org/doc/zh_cn/bluetooth.html#plus.bluetooth.BluetoothSuccessCallback">BluetoothSuccessCallback</a> ) 可选 断开连接成功回调函数 </li><li>fail: ( <ahref="https://www.html5plus.org/doc/zh_cn/bluetooth.html#plus.bluetooth.BluetoothFailCallback">BluetoothFailCallback</a> ) 可选 断开连接失败回调函数 </li><li>complete: ( <ahref="https://www.html5plus.org/doc/zh_cn/bluetooth.html#plus.bluetooth.BluetoothCompleteCallback">BluetoothCompleteCallback</a> ) 可选 断开连接操作完成回调函数 调用成功或失败都会触发此回调。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><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></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">createBLEConnection</h1>
连接低功耗蓝牙设备
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void plus.bluetooth.createBLEConnection(options);
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
若之前已有搜索过某个蓝牙设备，并成功建立连接，可直接传入之前搜索获取的deviceId尝试连接该设备，无需进行搜索操作。
<h2 style="margin-left:.8em;">参数：</h2>
options参数为json类型，包含以下属性：
<ul><li>deviceId: ( String ) 必选 蓝牙设备的id </li><li>timeout: ( Number ) 可选 超时时间 单位为ms（毫秒），不设置此属性表示不会超时。 </li><li>success: ( <ahref="https://www.html5plus.org/doc/zh_cn/bluetooth.html#plus.bluetooth.BluetoothSuccessCallback">BluetoothSuccessCallback</a> ) 可选 连接成功回调函数 </li><li>fail: ( <ahref="https://www.html5plus.org/doc/zh_cn/bluetooth.html#plus.bluetooth.BluetoothFailCallback">BluetoothFailCallback</a> ) 可选 连接失败回调函数 </li><li>complete: ( <ahref="https://www.html5plus.org/doc/zh_cn/bluetooth.html#plus.bluetooth.BluetoothCompleteCallback">BluetoothCompleteCallback</a> ) 可选 连接操作完成回调函数 调用成功或失败都会触发此回调。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 蓝牙设备id，可通过onBluetoothDeviceFound方法获取
var deviceId = '';
// 连接蓝牙设备
function createConnection(){
plus.bluetooth.createBLEConnection({
deviceId:deviceId,
success:function(e){
console.log('create connection success: '+JSON.stringify(e));
},
fail:function(e){
console.log('create connection failed: '+JSON.stringify(e));
}
});
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">setBLEMTU</h1>
设置蓝牙最大传输单元
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void plus.bluetooth.setBLEMTU(options);
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
需在 createBLEConnection 调用成功后调用，mtu 设置范围 (22,512)。 HBuilderX2.8.4+版本支持。
<h2 style="margin-left:.8em;">参数：</h2>
options参数为json类型，包含以下属性：
<ul><li>deviceId: ( String ) 必选 设备的 id </li><li>mtu: ( Number ) 必选 最大传输单元(22,512) 区间内，单位为字节（bytes） </li><li>success: ( <ahref="https://www.html5plus.org/doc/zh_cn/bluetooth.html#plus.bluetooth.BluetoothSuccessCallback">BluetoothSuccessCallback</a> ) 可选 设置蓝牙最大传输单元成功回调函数 </li><li>fail: ( <ahref="https://www.html5plus.org/doc/zh_cn/bluetooth.html#plus.bluetooth.BluetoothFailCallback">BluetoothFailCallback</a> ) 可选 设置蓝牙最大传输单元失败回调函数 </li><li>complete: ( <ahref="https://www.html5plus.org/doc/zh_cn/bluetooth.html#plus.bluetooth.BluetoothCompleteCallback">BluetoothCompleteCallback</a> ) 可选 设置蓝牙最大传输单元操作完成回调函数 调用成功或失败都会触发此回调。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">平台支持：</h2>
<ul><li>Android - 5.1+ (支持)</li><li>iOS - ALL (不支持)</li></ul>
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 蓝牙设备id，可通过onBluetoothDeviceFound方法获取
var deviceId = '';
// 连接蓝牙设备设置最大传输单元
function createConnection(){
plus.bluetooth.createBLEConnection({
deviceId:deviceId,
success:function(e){
console.log('create connection success: '+JSON.stringify(e));
plus.bluetooth.setBLEMTU({
 deviceId:deviceId,
 mtu:512,
 success:function(e){
console.log('set MTU success: '+JSON.stringify(e));
 },
 fail:function(e){
console.log('set MTU failed: '+JSON.stringify(e));
 }
});
},
fail:function(e){
console.log('create connection failed: '+JSON.stringify(e));
}
});
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">getBLEDeviceCharacteristics</h1>
获取蓝牙设备指定服务中所有特征值(characteristic)
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void plus.bluetooth.getBLEDeviceCharacteristics(options);
</code></code></pre>
<h2 style="margin-left:.8em;">参数：</h2>
options参数为json类型，包含以下属性：
<ul><li>deviceId: ( String ) 必选 蓝牙设备的id </li><li>serviceId: ( String ) 必选 蓝牙服务 uuid 可通过getBLEDeviceServices获取。 </li><li>success: ( <ahref="https://www.html5plus.org/doc/zh_cn/bluetooth.html#plus.bluetooth.BluetoothSuccessCallback">BluetoothSuccessCallback</a> ) 可选 获取特征值成功回调函数 回调函数参数event对象包括以下属性： characteristics - Array>Bluetoothcharacteristic<类型，蓝牙设备服务的特征值列表。 </li><li>fail: ( <ahref="https://www.html5plus.org/doc/zh_cn/bluetooth.html#plus.bluetooth.BluetoothFailCallback">BluetoothFailCallback</a> ) 可选 获取特征值失败回调函数 </li><li>complete: ( <ahref="https://www.html5plus.org/doc/zh_cn/bluetooth.html#plus.bluetooth.BluetoothCompleteCallback">BluetoothCompleteCallback</a> ) 可选 获取特征值操作完成回调函数 调用成功或失败都会触发此回调。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 蓝牙设备id，可通过onBluetoothDeviceFound方法获取
var deviceId = '';
// 蓝牙服务uuid，可通过getBLEDeviceServices方法获取
var serviceId = '';
// 获取蓝牙设备指定服务中所有特征值
function getCharacteristics(){
plus.bluetooth.getBLEDeviceCharacteristics({
deviceId:deviceId,
serviceId:serviceId,
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></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">getBLEDeviceRSSI</h1>
获取蓝牙设备的信号强度
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void plus.bluetooth.getBLEDeviceRSSI(options);
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
需在 createBLEConnection 调用成功后调用。 HBuilderX2.8.4+版本支持。
<h2 style="margin-left:.8em;">参数：</h2>
options参数为json类型，包含以下属性：
<ul><li>deviceId: ( String ) 必选 设备的 id </li><li>success: ( <ahref="https://blog.csdn.net/qq_40575646/article/details/122683957#plus.bluetooth.BluetoothDeviceRSSICallback">BluetoothDeviceRSSICallback</a> ) 可选 获取蓝牙设备信号强度成功回调函数 回调函数参数event对象包括以下属性： RSSI - Number类型，蓝牙设备的信号强度。 </li><li>fail: ( <ahref="https://www.html5plus.org/doc/zh_cn/bluetooth.html#plus.bluetooth.BluetoothFailCallback">BluetoothFailCallback</a> ) 可选 获取蓝牙设备信号强度失败回调函数 </li><li>complete: ( <ahref="https://www.html5plus.org/doc/zh_cn/bluetooth.html#plus.bluetooth.BluetoothCompleteCallback">BluetoothCompleteCallback</a> ) 可选 获取蓝牙设备信号强度操作完成回调函数 调用成功或失败都会触发此回调。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 蓝牙设备id，可通过onBluetoothDeviceFound方法获取
var deviceId = '';
// 连接蓝牙设备获取信号强度
function createConnection(){
plus.bluetooth.createBLEConnection({
deviceId:deviceId,
success:function(e){
console.log('create connection success: '+JSON.stringify(e));
plus.bluetooth.getBLEDeviceRSSI({
 deviceId:deviceId,
 success:function(e){
console.log('RSSI: '+e.RSSI);
 },
 fail:function(e){
console.log('get RSSI failed: '+JSON.stringify(e));
 }
});
},
fail:function(e){
console.log('create connection failed: '+JSON.stringify(e));
}
});
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">getBLEDeviceServices</h1>
获取蓝牙设备的所有服务(service)
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void plus.bluetooth.getBLEDeviceServices(options);
</code></code></pre>
<h2 style="margin-left:.8em;">参数：</h2>
options参数为json类型，包含以下属性：
<ul><li>deviceId: ( String ) 必选 蓝牙设备的id </li><li>success: ( <ahref="https://www.html5plus.org/doc/zh_cn/bluetooth.html#plus.bluetooth.BluetoothSuccessCallback">BluetoothSuccessCallback</a> ) 可选 获取服务成功回调函数 回调函数参数event对象包括以下属性： services - Array>BluetoothService<类型，蓝牙设备服务的特征值列表。 </li><li>fail: ( <ahref="https://www.html5plus.org/doc/zh_cn/bluetooth.html#plus.bluetooth.BluetoothFailCallback">BluetoothFailCallback</a> ) 可选 获取服务失败回调函数 </li><li>complete: ( <ahref="https://www.html5plus.org/doc/zh_cn/bluetooth.html#plus.bluetooth.BluetoothCompleteCallback">BluetoothCompleteCallback</a> ) 可选 获取服务操作完成回调函数 调用成功或失败都会触发此回调。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 蓝牙设备id，可通过onBluetoothDeviceFound方法获取
var deviceId = '';
// 获取蓝牙设备的所有服务
function getServices(){
plus.bluetooth.getBLEDeviceServices({
deviceId:deviceId,
success:function(e){
var services = e.services;
console.log('get services success: '+services.length);
for(var i in services){
console.log(i+': '+JSON.stringify(services[i]));
}
},
fail:function(e){
console.log('get services failed: '+JSON.stringify(e));
}
});
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">notifyBLECharacteristicValueChange</h1>
启用低功耗蓝牙设备特征值变化时的notify功能，订阅特征值
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void plus.bluetooth.notifyBLECharacteristicValueChange(options);
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
蓝牙设备服务的特征值必须支持notify或indicate才可以成功调用。另外，必须先启用notifyBLECharacteristicValueChange才能监听到设备characteristicValueChange事件,即特征值发生变化时通过onBLECharacteristicValueChange注册的事件回调。
<h2 style="margin-left:.8em;">参数：</h2>
options参数为json类型，包含以下属性：
<ul><li>deviceId: ( String ) 必选 蓝牙设备的id </li><li>serviceId: ( String ) 必选 蓝牙服务的uuid </li><li>characteristicId: ( String ) 必选 蓝牙特征值的uuid </li><li>state: ( Boolean ) 必选 是否启用 notify </li><li>success: ( <ahref="https://www.html5plus.org/doc/zh_cn/bluetooth.html#plus.bluetooth.BluetoothSuccessCallback">BluetoothSuccessCallback</a> ) 可选 订阅特征值成功回调函数 </li><li>fail: ( <ahref="https://www.html5plus.org/doc/zh_cn/bluetooth.html#plus.bluetooth.BluetoothFailCallback">BluetoothFailCallback</a> ) 可选 订阅特征值失败回调函数 </li><li>complete: ( <ahref="https://www.html5plus.org/doc/zh_cn/bluetooth.html#plus.bluetooth.BluetoothCompleteCallback">BluetoothCompleteCallback</a> ) 可选 订阅特征值操作完成回调函数 调用成功或失败都会触发此回调。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><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></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">onBLECharacteristicValueChange</h1>
监听低功耗蓝牙设备的特征值变化事件
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void plus.bluetooth.onBLECharacteristicValueChange(callback);
</code></code></pre>
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>callback: ( <ahref="https://blog.csdn.net/qq_40575646/article/details/122683957#plus.bluetooth.BLECharacteristicValueChangeCallback">BLECharacteristicValueChangeCallback</a> ) 必选 特征值变化回调函数 回调函数参数event对象包括以下属性： deviceId - String类型，蓝牙设备id； serviceId - String类型，蓝牙服务的uuid； characteristicId - String类型，蓝牙特征值的uuid； value - ArrayBuffer类型，特征值的最新值。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><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></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">onBLEConnectionStateChange</h1>
监听低功耗蓝牙设备连接状态变化事件
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void plus.bluetooth.onBLEConnectionStateChange(callback);
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
包括开发者主动连接或断开连接，设备丢失，连接异常断开等。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>callback: ( <ahref="https://blog.csdn.net/qq_40575646/article/details/122683957#plus.bluetooth.BLEConnectionStateChangeCallback">BLEConnectionStateChangeCallback</a> ) 必选 连接状态变化回调函数 回调函数参数event对象包括以下属性： deviceId - String类型，蓝牙设备id； connected - Boolean类型，是否处于已连接状态。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 监听蓝牙设备连接状态
function listenerConnection(){
plus.bluetooth.onBLEConnectionStateChange(function(e){
console.log('connection state changed: '+JSON.stringify(e));
});
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">readBLECharacteristicValue</h1>
读取低功耗蓝牙设备指定特征值的二进制数据值
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void plus.bluetooth.readBLECharacteristicValue(options);
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
指定的特征值需支持read操作才可以成功调用。并行调用多次可能导致读取失败，读取的数据需要在onBLECharacteristicValueChange方法注册的回调中获取。
<h2 style="margin-left:.8em;">参数：</h2>
options参数为json类型，包含以下属性：
<ul><li>deviceId: ( String ) 必选 蓝牙设备的id </li><li>serviceId: ( String ) 必选 蓝牙服务的uuid </li><li>characteristicId: ( String ) 必选 蓝牙特征值的uuid </li><li>success: ( <ahref="https://www.html5plus.org/doc/zh_cn/bluetooth.html#plus.bluetooth.BluetoothSuccessCallback">BluetoothSuccessCallback</a> ) 可选 读取特征值的二进制数据成功回调函数 </li><li>fail: ( <ahref="https://www.html5plus.org/doc/zh_cn/bluetooth.html#plus.bluetooth.BluetoothFailCallback">BluetoothFailCallback</a> ) 可选 读取特征值的二进制数据失败回调函数 </li><li>complete: ( <ahref="https://www.html5plus.org/doc/zh_cn/bluetooth.html#plus.bluetooth.BluetoothCompleteCallback">BluetoothCompleteCallback</a> ) 可选 读取特征值的二进制数据操作完成回调函数 调用成功或失败都会触发此回调。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 蓝牙设备id，可通过onBluetoothDeviceFound方法获取
var deviceId = '';
// 蓝牙服务id，可通过getBLEDeviceServices方法获取
var serviceId = '';
// 蓝牙特征值id，可通过getBLEDeviceCharacteristics方法获取
var characteristicId = '';
// 读取低功耗蓝牙设备的特征值
function readCharacteristics(){
plus.bluetooth.readBLECharacteristicValue({
deviceId:deviceId,
serviceId:serviceId,
characteristicId:characteristicId,
success:function(e){
console.log('read characteristics success: '+JSON.stringify(e));
},
fail:function(e){
console.log('read characteristics failed: '+JSON.stringify(e));
}
});
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">writeBLECharacteristicValue</h1>
向低功耗蓝牙设备指定特征值写入二进制数据
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void plus.bluetooth.writeBLECharacteristicValue(options);
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
指定的特征值需支持write操作才可以成功调用。并行调用多次可能导致读取失败，系统可能会限制单次传输的数据大小，超过最大字节数后可能会发生写入错误，建议每次写入不超过20字节。
<h2 style="margin-left:.8em;">参数：</h2>
options参数为json类型，包含以下属性：
<ul><li>deviceId: ( String ) 必选 蓝牙设备的id </li><li>serviceId: ( String ) 必选 蓝牙服务的uuid </li><li>characteristicId: ( String ) 必选 蓝牙特征值的uuid </li><li>value: ( ArrayBuffer ) 必选 要写入的数据 写入到蓝牙设备指定特征值中的二进制值。 </li><li>success: ( <ahref="https://blog.csdn.net/qq_40575646/article/details/122683957#plus.bluetooth.BluetoothSuccessCallback">BluetoothSuccessCallback</a> ) 可选 读取特征值的二进制数据成功回调函数 </li><li>fail: ( <ahref="https://blog.csdn.net/qq_40575646/article/details/122683957#plus.bluetooth.BluetoothFailCallback">BluetoothFailCallback</a> ) 可选 读取特征值的二进制数据失败回调函数 </li><li>complete: ( <ahref="https://blog.csdn.net/qq_40575646/article/details/122683957#plus.bluetooth.BluetoothCompleteCallback">BluetoothCompleteCallback</a> ) 可选 读取特征值的二进制数据操作完成回调函数 调用成功或失败都会触发此回调。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 蓝牙设备id，可通过onBluetoothDeviceFound方法获取
var deviceId = '';
// 蓝牙服务id，可通过getBLEDeviceServices方法获取
var serviceId = '';
// 蓝牙特征值id，可通过getBLEDeviceCharacteristics方法获取
var characteristicId = '';
// 要写入的数据
var value = new ArrayBuffer(8);
var iv = new Int32Array(value);
iv[0] = 120, iv[2]=100;
// 写入低功耗蓝牙设备的特征值
function writeCharacteristics(){
plus.bluetooth.writeBLECharacteristicValue({
deviceId:deviceId,
serviceId:serviceId,
characteristicId:characteristicId,
value:value,
success:function(e){
console.log('write characteristics success: '+JSON.stringify(e));
},
fail:function(e){
console.log('write characteristics failed: '+JSON.stringify(e));
}
});
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">BluetoothDeviceInfo</h1>
蓝牙设备信息
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
interface BluetoothDeviceInfo {
readonly attribute String name;
readonly attribute String deviceId;
readonly attribute Number RSSI;
readonly attribute ArrayBuffer advertisData;
readonly attribute Array<String> advertisServiceUUIDs;
readonly attribute String localName;
readonly attribute JSON serviceData;
}
</code></code></pre>
<h2 style="margin-left:.8em;">属性：</h2>
<ul><li>name: (String 类型 )蓝牙设备名称 某些设备可能没有此字段值。 </li><li>deviceId: (String 类型 )蓝牙设备的id</li><li>RSSI: (Number 类型 )蓝牙设备的信号强度</li><li>advertisData: (ArrayBuffer 类型 )蓝牙设备的广播数据段中的ManufacturerData数据段</li><li>advertisServiceUUIDs: (Array 类型 )蓝牙设备的广播数据段中的ServiceUUIDs数据段</li><li>localName: (String 类型 )蓝牙设备的广播数据段中的LocalName数据段</li><li>serviceData: (JSON 类型 )蓝牙设备的广播数据段中的ServiceData数据段</li></ul>
<h1 style="margin-left:0;">BluetoothService</h1>
蓝牙设备服务信息
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
interface BluetoothService {
readonly attribute String uuid;
readonly attribute Boolean isPrimary;
}
</code></code></pre>
<h2 style="margin-left:.8em;">属性：</h2>
<ul><li>uuid: (String 类型 )蓝牙设备服务的uuid</li><li>isPrimary: (Boolean 类型 )是否为设备的主服务</li></ul>
<h1 style="margin-left:0;">Bluetoothcharacteristic</h1>
蓝牙设备特征值
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
interface Bluetoothcharacteristic {
readonly attribute String uuid;
readonly attribute BluetoothcharacteristicProperties properties;
}
</code></code></pre>
<h2 style="margin-left:.8em;">属性：</h2>
<ul><li>uuid: (String 类型 )蓝牙设备特征值的uuid</li><li>properties: (<ahref="https://blog.csdn.net/qq_40575646/article/details/122683957#plus.bluetooth.BluetoothcharacteristicProperties">BluetoothcharacteristicProperties</a> 类型 )设备特征值支持的操作类型</li></ul>
<h1 style="margin-left:0;">BluetoothcharacteristicProperties</h1>
蓝牙设备特征值支持的操作类型
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
interface BluetoothcharacteristicProperties {
readonly attribute Boolean read;
readonly attribute Boolean write;
readonly attribute Boolean notify;
readonly attribute Boolean indicate;
}
</code></code></pre>
<h2 style="margin-left:.8em;">属性：</h2>
<ul><li>read: (Boolean 类型 )特征值是否支持read操作</li><li>write: (Boolean 类型 )特征值是否支持write操作</li><li>notify: (Boolean 类型 )特征值是否支持notify操作</li><li>indicate: (Boolean 类型 )特征值是否支持indicate操作</li></ul>
<h1 style="margin-left:0;">BluetoothSuccessCallback</h1>
成功回调函数
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void onSuccess(Object event){
}
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
不同接口触发的成功回调参数event包含的属性存在差异，具体参考对应的接口描述说明。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>event: ( Object ) 必选 回调参数 回调参数包含的属性由调用接口决定，具体参考对应的接口描述说明。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h1 style="margin-left:0;">BluetoothFailCallback</h1>
失败回调函数
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
function void onFail(Exception error){
// Handle error
var code = error.code; // 错误编码
var message = error.message; // 错误描述信息
}
</code></code></pre>
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>error: ( Exception ) 必选 回调参数，错误信息 可通过error.code（Number类型）获取错误编码； 可通过error.message（String类型）获取错误描述信息。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h1 style="margin-left:0;">BluetoothCompleteCallback</h1>
操作完成回调函数
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
function void onComplete(Object event){
}
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
调用成功或失败都会触发此回调。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>event: ( Object ) 可选 回调参数 调用成功时回调参数与BluetoothSuccessCallback一致，调用失败时回调参数与BluetoothFailCallback一致。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h1 style="margin-left:0;">BluetoothAdapterStateChangeCallback</h1>
蓝牙适配器状态变化事件回调函数
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
function void onStateChange(Object event){
// event.available
// event.discovering
}
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
蓝牙适配器状态发生变化时触发此回调。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>event: ( Object ) 可选 返回参数 回调函数参数event对象包括以下属性： available - Boolean，蓝牙适配器是否可用； discovering - Boolean，蓝牙适配器是否处于搜索状态。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h1 style="margin-left:0;">BluetoothDeviceFoundCallback</h1>
蓝牙适配器搜索到新设备事件回调函数
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
function void onDeviceFound(Object event){
// event.devices
}
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
搜索到蓝牙设备时触发此回调。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>event: ( Object ) 可选 返回参数 回调函数参数event对象包括以下属性： devices - Array<BluetoothDeviceInfo>，设备列表信息。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h1 style="margin-left:0;">BluetoothDeviceRSSICallback</h1>
获取蓝牙设备信号强度成功回调函数
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
function void onDeviceRSSI(Object event){
// event.RSSI
}
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
获取蓝牙设备信号强度时触发此回调。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>event: ( Object ) 可选 返回参数 回调函数参数event对象包括以下属性： RSSI - Number，信号强度。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h1 style="margin-left:0;">BLEConnectionStateChangeCallback</h1>
低功耗蓝牙设备连接状态变化事件回调函数
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
function void onStateChange(Object event){
// event.deviceId
// event.connected
}
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
蓝牙设备连接状态发生变化时触发此回调。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>event: ( Object ) 可选 返回参数 回调函数参数event对象包括以下属性： deviceId - String类型，蓝牙设备id； connected - Boolean类型，是否处于已连接状态。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h1 style="margin-left:0;">BLECharacteristicValueChangeCallback</h1>
低功耗蓝牙设备的特征值变化事件回调函数
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
function void onValueChange(Object event){
// event.deviceId
// event.serviceId
// event.characteristicId
// event.value
}
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
蓝牙设备对应的特征值发生变化时触发此回调。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>event: ( Object ) 可选 返回参数 回调函数参数event对象包括以下属性： deviceId - String类型，蓝牙设备id； serviceId - String类型，蓝牙服务的uuid； characteristicId - String类型，蓝牙特征值的uuid； value - ArrayBuffer类型，特征值的最新值。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
 </div>
 </div>
 <div id="treeSkill"></div>

页: [1]

宜信同城网交流论坛's Archiver

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