原生微信小程序蓝牙开发(一）

基础库 1.1.0 开始支持，低版本需做兼容处理。

以 Promise 风格 调用：支持

用户授权：需要 scope.bluetooth

小程序插件：支持，需要小程序基础库版本不低于 1.9.6

第一步：初始化蓝牙适配器 wx.openBluetoothAdapter

初始化蓝牙模块。iOS 上开启主机/从机（外围设备）模式时需分别调用一次，并指定对应的 mode。

参数

Object object

属性	类型	默认值	必填	说明	最低版本
mode	string	central	否	蓝牙模式，可作为主/从设备，仅 iOS 需要。	2.10.0
success	function		否	接口调用成功的回调函数
fail	function		否	接口调用失败的回调函数
complete	function		否	接口调用结束的回调函数（调用成功、失败都会执行）

mode属性合法值为：

合法值	说明
central	主机模式
peripheral	从机（外围设备）模式

其中进行监听蓝牙连接状态  wx.onBLEConnectionStateChange

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

参数

function listener

蓝牙低功耗连接状态改变事件的监听函数

参数

Object res

属性	类型	说明
deviceId	string	蓝牙设备 id
connected	boolean	是否处于已连接状态

官方文档：wx.openBluetoothAdapter(Object object) | 微信开放文档

// 初始化
  initBlue: function (e) {
    const that = this;
    wx.openBluetoothAdapter({
      success: (res) => {
        that.setData({
          "setInfo.initBlueText": "蓝牙初始化成功",
        });
        // 监听蓝牙连接状态改变
        wx.onBLEConnectionStateChange(function (res) {
          // 从连接状态断开
          if (!res.connected) {
            that.setData({
              setInfo: {
                connected: "已断开",
              },
            });
            return;
          }
        });
        this.findBlue(); // 搜索周边
      },
      fail: (res) => {
        that.setData({
          "setInfo.initBlueText":
            "蓝牙初始化失败，请在手机设置中打开蓝牙以使用该功能",
        });
        //如果手机上的蓝牙没有打开，可以提醒用户
        if (!that.data.openDoor) {
          wx.showModal({
            title: "提示",
            content: "请在手机设置中打开蓝牙以使用该功能",
            showCancel: false,
            confirmText: "我已打开",
            success(res) {
              if (res.confirm) {
                that.refresh();
              }
            },
          });
        }
      },
    });
  },

调用 wx.openBluetoothAdapter api初始化蓝牙模块。

注意：

1. 后面其他的蓝牙相关api，必须要在 wx.openBluetoothAdapter 初始化过后才能调用，不然要报错
2. 如果手机蓝牙没有打开的话会在 wx.openBluetoothAdapter 的 fail 里面返回错误信息errCode=10001
3. 此功能只有在手机调试或者预览的时候才能使用
4. 如果需要监听蓝牙连接的状态需要使用 wx.onBLEConnectionStateChange 来监听并且需要在蓝牙初始化成功过后再调用，当断开连接连接的时候可以实时监听，并做出相应的提示给用户。
5. this 会随着上下文环境而变换它的指向，所以在当前作用域中设置一个变量用来存储 this 可以防止在其他地方找不到 this 的错误。

当初始化成功后就可以进行下一步操作——搜索周边设备（点击可直接跳转）