微信小程序——实现蓝牙设备搜索及连接功能-编程知识

在这里插入图片描述

✅作者简介：2022年博客新星第八。热爱国学的Java后端开发者，修心和技术同步精进。
🍎个人主页：Java Fans的博客
🍊个人信条：不迁怒，不贰过。小知识，大智慧。
💞当前专栏：微信小程序学习分享
✨特色专栏：国学周更-心性养成之路
🥭本文内容：微信小程序——实现蓝牙设备搜索及连接功能

文章目录

- 1、在小程序的app.json文件中添加蓝牙权限
- 2、新建一个展示蓝牙列表的界面 index
- - 2.1、在index.wxml文件中，添加如下代码：
  - 2.2、在index.wxss文件中添加如下代码：
  - 2.3、在index.js文件中相关代码及说明
- 3、测试

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 监听手机蓝牙状态的改变，也可以调用蓝牙模块的所有API。

第二步：开始搜索附近的蓝牙设备，wx.startBluetoothDevicesDiscovery(Object object)

开始搜寻附近的蓝牙外围设备。

此操作比较耗费系统资源，请在搜索到需要的设备后及时调用 wx.stopBluetoothDevicesDiscovery 停止搜索

  // 第二步 开始搜索附近的蓝牙设备startBluetoothDevicesDiscovery() {wx.startBluetoothDevicesDiscovery({allowDuplicatesKey: false,success: (res) => {console.log('开始搜索附近的蓝牙设备', res)this.onBluetoothDeviceFound()},})},

注意

考虑到蓝牙功能可以间接进行定位，安卓 6.0 及以上版本，无定位权限或定位开关未打开时，无法进行设备搜索。这种情况下，安卓 8.0.16 前，接口调用成功但无法扫描设备；8.0.16 及以上版本，会返回错误。

第三步：监听发现附近的蓝牙设备，wx.onBluetoothDeviceFound(function listener)

监听搜索到新设备的事件

  // 第三步 监听发现附近的蓝牙设备onBluetoothDeviceFound() {wx.onBluetoothDeviceFound((res) => {res.devices.forEach(device => {if (!device.name && !device.localName) { return }console.log("发现的蓝牙设备", 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.devicewx.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 创建连接，有可能导致系统持有同一设备多个连接的实例，导致调用 closeBLEConnection 的时候并不能真正的断开与设备的连接。

蓝牙连接随时可能断开，建议监听 wx.onBLEConnectionStateChange 回调事件，当蓝牙设备断开时按需执行重连操作。

若对未连接的设备或已断开连接的设备调用数据读写操作的接口，会返回 10006 错误，建议进行重连操作。

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

停止搜寻附近的蓝牙外围设备。若已经找到需要的蓝牙设备并不需要继续搜索时，建议调用该接口停止蓝牙搜索。

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