5、获取蓝牙设备列表(getBluetoothDevices)

逃离我推掉我的手 2022-02-21 18:29 943阅读 0赞

# wx.getBluetoothDevices(Object object) #

> 基础库 1.1.0 开始支持，低版本需做[兼容处理][Link 1]。

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

## 参数 ##

### Object object ###

<table> 
 <thead> 
  <tr> 
   <th>属性</th> 
   <th>类型</th> 
   <th>默认值</th> 
   <th>必填</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>success</td> 
   <td>function</td> 
   <td>&nbsp;</td> 
   <td>否</td> 
   <td>接口调用成功的回调函数</td> 
  </tr> 
  <tr> 
   <td>fail</td> 
   <td>function</td> 
   <td>&nbsp;</td> 
   <td>否</td> 
   <td>接口调用失败的回调函数</td> 
  </tr> 
  <tr> 
   <td>complete</td> 
   <td>function</td> 
   <td>&nbsp;</td> 
   <td>否</td> 
   <td>接口调用结束的回调函数（调用成功、失败都会执行）</td> 
  </tr> 
 </tbody> 
</table>

object.success 回调函数

参数

Object res

<table> 
 <thead> 
  <tr> 
   <th>属性</th> 
   <th>类型</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>devices</td> 
   <td>Array.&lt;Object&gt;</td> 
   <td>uuid 对应的的已连接设备列表</td> 
  </tr> 
 </tbody> 
</table>

**res.devices 的结构**

<table> 
 <thead> 
  <tr> 
   <th>属性</th> 
   <th>类型</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>name</td> 
   <td>string</td> 
   <td>蓝牙设备名称，某些设备可能没有</td> 
  </tr> 
  <tr> 
   <td>deviceId</td> 
   <td>string</td> 
   <td>用于区分设备的 id</td> 
  </tr> 
  <tr> 
   <td>RSSI</td> 
   <td>number</td> 
   <td>当前蓝牙设备的信号强度</td> 
  </tr> 
  <tr> 
   <td>advertisData</td> 
   <td>ArrayBuffer</td> 
   <td>当前蓝牙设备的广播数据段中的 ManufacturerData 数据段。</td> 
  </tr> 
  <tr> 
   <td>advertisServiceUUIDs</td> 
   <td>Array.&lt;string&gt;</td> 
   <td>当前蓝牙设备的广播数据段中的 ServiceUUIDs 数据段</td> 
  </tr> 
  <tr> 
   <td>localName</td> 
   <td>string</td> 
   <td>当前蓝牙设备的广播数据段中的 LocalName 数据段</td> 
  </tr> 
  <tr> 
   <td>serviceData</td> 
   <td>Object</td> 
   <td>当前蓝牙设备的广播数据段中的 ServiceData 数据段</td> 
  </tr> 
 </tbody> 
</table>

## 注意事项 ##

*  该接口获取到的设备列表为**蓝牙模块生效期间所有搜索到的蓝牙设备**，若在蓝牙模块使用流程结束后未及时调用 [`wx.closeBluetoothAdapter`][wx.closeBluetoothAdapter] 释放资源，会存在调用该接口会返回之前的蓝牙使用流程中搜索到的蓝牙设备，可能设备已经不在用户身边，无法连接。
 *  蓝牙设备在被搜索到时，系统返回的 name 字段一般为广播包中的 LocalName 字段中的设备名称，而如果与蓝牙设备建立连接，系统返回的 name 字段会改为从蓝牙设备上获取到的 `GattName`。若需要动态改变设备名称并展示，建议使用 `localName` 字段。

lanyatest.wxml代码：

<view class="contentview">
    
      <view  class='myview' >
        
          {
       {info}}
        
    
      </view>
    
      <button type="primary" class="button" bindtap="lanyatest1">1初始化蓝牙</button>
      <button type="primary" class="button" bindtap="lanyatest2">2获取蓝牙状态</button>
      <button type="primary" class="button" bindtap="lanyatest3">3搜索周边设备</button>
      <button type="primary" class="button" bindtap="lanyatest4">4获取所有设备</button>
    </view>

lanyatest.js代码：

// pages/lanyatest/lanyatest.js
    Page({
    
      /**
       * 页面的初始数据
       */
      data: {
        info:"未初始化蓝牙适配器"
      },
    
      lanyatest1(event){
        var that = this;
        wx.openBluetoothAdapter({
          success: function (res) {
            console.log('初始化蓝牙适配器成功')
            //页面日志显示
            that.setData({
              info: '初始化蓝牙适配器成功'
            })
          },
          fail: function (res) {
            console.log('请打开蓝牙和定位功能')
            that.setData({
              info: '请打开蓝牙和定位功能'
            })
          }
        })
      },
    
    
    
      lanyatest2(event){
        var that = this;
        wx.getBluetoothAdapterState({
    
          success: function (res) {
    
            //打印相关信息
            console.log(JSON.stringify(res.errMsg) + "\n蓝牙是否可用：" + res.available);
    
            that.setData({
              info: JSON.stringify(res.errMsg) +"\n蓝牙是否可用：" + res.available
            })
    
          },
          fail: function (res) {
    
            //打印相关信息
            console.log(JSON.stringify(res.errMsg) + "\n蓝牙是否可用：" + res.available);
    
            that.setData({
              info: JSON.stringify(res.errMsg) + "\n蓝牙是否可用：" + res.available
            })
    
          }
          
        })
    
      },
    
    
    
      lanyatest3(event){
        var that = this;
        wx.startBluetoothDevicesDiscovery({
          services: ['FEE7'], //如果填写了此UUID，那么只会搜索出含有这个UUID的设备，建议一开始先不填写或者注释掉这一句
          success: function (res) {
            that.setData({
              info: "搜索设备" + JSON.stringify(res),
            })
            console.log('搜索设备返回' + JSON.stringify(res))
    
          }
        })
    
      },
    
    
    
    
      lanyatest4(event){
        var that = this;
        wx.getBluetoothDevices({
          success: function (res) {
    
            that.setData({
              info: "设备列表\n" + JSON.stringify(res.devices),
              devices: res.devices
            })
            console.log('搜设备数目：' + res.devices.length)
            console.log('设备信息：\n' + JSON.stringify(res.devices)+"\n")
          }
        })
    
      }
    
    
    
    
    
    
    
    //我删除了自动生成的生命周期函数
    
    })

lanyatest.wxss代码：

/* pages/lanyatest/lanyatest.wxss */
    .vertical{
      display: flex;
      flex-direction: column;
    }
    
    /**index.wxss**/
    .horizontal{
      display: flex;
      flex-direction: row;
    }
    
    .btinfo{
      height:100px;
    }
    
    .contentview {
    margin: 0 10px;
    }
     
    .button {
    margin: 5px;
    }
    
    .myview{
      height:200px;
      word-break:break-all;/* 自动换行 */
    }

# 真机调试结果： #

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM0MjM0MDg3_size_16_color_FFFFFF_t_70][]

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM0MjM0MDg3_size_16_color_FFFFFF_t_70 1][]

# 开发心得： #

记得更新一下WXSS文件，更新了心得属性，否则文本显示不完全

如果搜索不到蓝牙设备，请查看定位服务和微信定位权限是否打开，如果填写了lanyatest3中的services参数，建议注释掉之后重新运行

[Link 1]: https://developers.weixin.qq.com/miniprogram/dev/framework/compatibility.html
[wx.closeBluetoothAdapter]: https://developers.weixin.qq.com/miniprogram/dev/api/wx.closeBluetoothAdapter.html
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM0MjM0MDg3_size_16_color_FFFFFF_t_70]: /images/20220221/a57886a97e0145069c0a7b19fe2101bd.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM0MjM0MDg3_size_16_color_FFFFFF_t_70 1]: /images/20220221/3894ffd06fee41afa91ef34eb7bee58b.png