微信小程序實現(xiàn)藍牙設備搜索及連接功能示例詳解

更新時間：2023年06月12日 10:56:51 作者：Java?Fans

這篇文章主要介紹了微信小程序實現(xiàn)藍牙設備搜索及連接功能,本文通過實例代碼給大家介紹的非常詳細，對大家的學習或工作具有一定的參考借鑒價值，需要的朋友可以參考下

1、在小程序的app.json文件中添加藍牙權限

在app.json中寫入如下代碼

  "permission": {
    "scope.userLocation": {
      "desc": "你的位置信息將用于小程序定位"
    },
    "scope.bluetooth": {
      "desc": "你的藍牙信息將用于小程序連接設備"
    }
  },

2、新建一個展示藍牙列表的界面 index

在pages目錄下，新建一個Page，命名為index，生成如下文件：

2.1、在index.wxml文件中，添加如下代碼：

<view class="container">
  <view class="title">藍牙設備列表</view>
  <view class="list">
    <block wx:for="{{devices}}" wx:key="index">
      <view class="item" bindtap="connectDevice" data-device="{{item}}">
        <view class="name">{{item.name}}</view>
        <view class="rssi">信號強度：{{item.RSSI}}</view>
      </view>
    </block>
  </view>
</view>

2.2、在index.wxss文件中添加如下代碼：

.container {
  display: flex;
  flex-direction: column;
  align-items: center;
  justify-content: center;
  height: 100vh;
}
.title {
  font-size: 24px;
  font-weight: bold;
  margin-bottom: 20px;
}
.list {
  width: 100%;
}
.item {
  display: flex;
  flex-direction: row;
  align-items: center;
  justify-content: space-between;
  padding: 10px;
  border-bottom: 1px solid #eee;
}
.name {
  font-size: 16px;
  font-weight: bold;
}
.rssi {
  font-size: 14px;
  color: #999;
}

2.3、在index.js文件中相關代碼及說明

第一步：藍牙初始化，wx.openBluetoothAdapter(Object object);

初始化藍牙模塊。iOS 上開啟主機/從機（外圍設備）模式時需分別調用一次，并指定對應的 mode。

  // 第一步，藍牙初始化成功
  onLoad: function () {
    wx.openBluetoothAdapter({
      success: (res) => {
        console.log('第一步，藍牙初始化成功', res)
        //開始搜索附近藍牙
        this.startBluetoothDevicesDiscovery()
      },
      fail: (res) => {
        console.log("第一步、藍牙初始化失敗", res);
        wx.showToast({ title: '藍牙初始化失敗', icon: 'none' })
      }
    })
  },

注意

其他藍牙相關 API 必須在 wx.openBluetoothAdapter 調用之后使用。否則 API 會返回錯誤（errCode=10000）。

在用戶藍牙開關未開啟或者手機不支持藍牙功能的情況下，調用 wx.openBluetoothAdapter 會返回錯誤（errCode=10001），表示手機藍牙功能不可用。此時小程序藍牙模塊已經初始化完成，可通過 wx.onBluetoothAdapterStateChange 監(jiān)聽手機藍牙狀態(tài)的改變，也可以調用藍牙模塊的所有API。

第二步：開始搜索附近的藍牙設備，wx.startBluetoothDevicesDiscovery(Object object)

開始搜尋附近的藍牙外圍設備。

此操作比較耗費系統(tǒng)資源，請在搜索到需要的設備后及時調用 wx.stopBluetoothDevicesDiscovery 停止搜索

  // 第二步 開始搜索附近的藍牙設備
  startBluetoothDevicesDiscovery() {
    wx.startBluetoothDevicesDiscovery({
      allowDuplicatesKey: false,
      success: (res) => {
        console.log('開始搜索附近的藍牙設備', res)
        this.onBluetoothDeviceFound()
      },
    })
  },

注意

考慮到藍牙功能可以間接進行定位，安卓 6.0 及以上版本，無定位權限或定位開關未打開時，無法進行設備搜索。這種情況下，安卓 8.0.16 前，接口調用成功但無法掃描設備；8.0.16 及以上版本，會返回錯誤。

第三步：監(jiān)聽發(fā)現(xiàn)附近的藍牙設備，wx.onBluetoothDeviceFound(function listener)

監(jiān)聽搜索到新設備的事件

  // 第三步 監(jiān)聽發(fā)現(xiàn)附近的藍牙設備
  onBluetoothDeviceFound() {
    wx.onBluetoothDeviceFound((res) => {
      res.devices.forEach(device => {
        if (!device.name && !device.localName) { return }
        console.log("發(fā)現(xiàn)的藍牙設備", device)
        this.data.devices.push(device)
        this.setData({ devices: this.data.devices })
      })
    })
  },

注意

若在 wx.onBluetoothDeviceFound 回調了某個設備，則此設備會添加到 wx.getBluetoothDevices 接口獲取到的數組中。

第四步：建立連接，wx.createBLEConnection(Object object)

連接藍牙低功耗設備。

若小程序在之前已有搜索過某個藍牙設備，并成功建立連接，可直接傳入之前搜索獲取的 deviceId 直接嘗試連接該設備，無需再次進行搜索操作。

  // 第四步、 建立連接
  connectDevice: function (e) {
    const device = e.currentTarget.dataset.device
    wx.createBLEConnection({
      deviceId: device.deviceId,
      success: (res) => {
        console.log('createBLEConnection success', res)
        wx.showToast({ title: '藍牙連接成功', icon: 'none' })
        this.stopBluetoothDevicesDiscovery()
        wx.navigateTo({
          url: '/pages/main/main?deviceId=' + device.deviceId
        })
      },
      fail: (res) => {
        wx.showToast({ title: '藍牙連接失敗', icon: 'none' })
      }
    })
  },

注意

請保證盡量成對的調用 wx.createBLEConnection 和 wx.closeBLEConnection 接口。安卓如果重復調用 wx.createBLEConnection 創(chuàng)建連接，有可能導致系統(tǒng)持有同一設備多個連接的實例，導致調用 closeBLEConnection 的時候并不能真正的斷開與設備的連接。

藍牙連接隨時可能斷開，建議監(jiān)聽 wx.onBLEConnectionStateChange 回調事件，當藍牙設備斷開時按需執(zhí)行重連操作。

若對未連接的設備或已斷開連接的設備調用數據讀寫操作的接口，會返回 10006 錯誤，建議進行重連操作。

第五步：停止搜索，wx.stopBluetoothDevicesDiscovery(Object object)

停止搜尋附近的藍牙外圍設備。若已經找到需要的藍牙設備并不需要繼續(xù)搜索時，建議調用該接口停止藍牙搜索。

  // 第五步、 停止搜索
  stopBluetoothDevicesDiscovery(){
    wx.stopBluetoothDevicesDiscovery({
      success: function(res) {
        console.log('停止搜索成功');
      },
      fail: function(res) {
        console.log('停止搜索失敗');
      }
    });
  }

其中，devices在data中定義如下：