小程序蓝牙开发

简介: 小程序蓝牙开发

前言:

记得上次分享过一篇小程序的文章《时隔两年,我开始学习微信小程序了~~仿小米手机天气预报》,那是我首次学习小程序,转眼间又过去大半年了,这次我就来谈谈--->小程序蓝牙开发。

一、你了解蓝牙吗?

蓝牙是一种无线技术标准,可实现固定设备、移动设备和楼宇个人域网之间的短距离数据交换(使用2.4—2.485GHz的ISM波段的UHF无线电波)。蓝牙技术最初由电信巨头爱立信公司于1994年创制,当时是作为RS232数据线的替代方案。蓝牙可连接多个设备,克服了数据同步的难题。

相信负责移动端开发的朋友们或大或小都有了解过“经典蓝牙”和“低功耗蓝牙”这两个代名词;而我总结了一下他们的优缺点:

1、android手机必须系统版本4.3及以上才支持BLE API。BLE蓝牙较传统蓝牙, 传输速度更快,覆盖范围更广,安全性更高,延迟更短,耗电极低等等优点;
2、传统蓝牙与BLE蓝牙通信方式也有所不同,传统的一般通过socket方式,而BLE蓝牙是通过Gatt协议来实现;
3、传统蓝牙可以用与数据量比较大的传输,如语音,音乐,较高数据量传输等;
低功耗蓝牙这样应用于实时性要求比较高,但是数据速率比较低的产品,如遥控类的,如鼠标,键盘,遥控鼠标(Air Mouse),传感设备的数据发送,如心跳带,血压计,温度传感器等一些医疗器械。

二、小程序蓝牙开发

一直以来我都是负责Android端的蓝牙软件项目开发,突然间某某某领导对我说要用小程序开发,那时我心中有一百个不爽,由于小程序的API已经对蓝牙提供支持了,我也没有什么理由去推卸了,但我只能说对领导说关于小程序蓝牙开发还不够成熟,其中可能会有兼容性问题,对于可行性问题我也不太确定,所以我也是抱着学习的心态去面对的。开始行动起来吧,相信敢于挑战,敢于付出的人,肯定有所收获的。

首先小程序开发 离不开小程序开发文档:先去了解和熟悉蓝牙API;都看一遍,对整个蓝牙开发流程也不过如此简单,都是一些api的套路罢了。

image.png

微信客户端对小程序蓝牙的支持版本为:iOS 微信客户端 6.5.6 版本开始支持,Android微信客户端 6.5.7 版本开始支持,此外还需要注意的就是Android系统需要Android4.3以上才可以使用蓝牙BLE,而小程序蓝牙只支持BLE,这点需要注意下。

1.获取当前设备平台以及微信版本,判断是否支持小程序蓝牙:

//获取当前设备平台以及微信版本
    if (app.getPlatform() == 'android' && this.versionCompare('6.5.7', app.getWxVersion())) {
      wx.showModal({
        title: '提示',
        content: '当前微信版本过低,请更新至最新版本',
        showCancel: false,
        success: function (res) {
          if (res.confirm) {
            that.backPage();
          } 
        }
      })

    } else if (app.getPlatform() == 'ios' && this.versionCompare('6.5.6', app.getWxVersion())){
      wx.showModal({
        title: '提示',
        content: '当前微信版本过低,请更新至最新版本',
        showCancel: false,
        success: function (res) {
          if (res.confirm) {
            that.backPage();
          }
        }
      })
    }

2.初始化小程序蓝牙模块,生效周期为调用wx.openBluetoothAdapter至调用wx.closeBluetoothAdapter或小程序被销毁为止。 在小程序蓝牙适配器模块生效期间,开发者可以正常调用下面的小程序API,并会收到蓝牙模块相关的on回调。

//初始化小程序蓝牙模块
  openBluetoothAdapter:function(){
    var that = this;
    wx.openBluetoothAdapter({
      success: function (res){
        var log = that.data.textLog + "打开蓝牙适配器成功!\n";
        that.setData({
          textLog: log,
          isopen:true
        });
        that.getBluetoothAdapterState();
      },
      fail: function (err){
        isopen: true;
        app.toastTap("蓝牙开关未开启");
        var log = that.data.textLog + "蓝牙开关未开启 \n";
        that.setData({
          textLog: log
        });   
      }  
    })
    //监听蓝牙适配器状态变化事件
    wx.onBluetoothAdapterStateChange(function (res) {
      console.log('onBluetoothAdapterStateChange', res)
      var isDvailable = res.available;//蓝牙适配器是否可用
      if (isDvailable) {
        that.getBluetoothAdapterState();  
      } else {
        that.stopBluetoothDevicesDiscovery();//停止搜索
        that.setData({
          devices: []
        });
        app.toastTap1("蓝牙开关未开启");
      }
    })
  }

3.获取本机蓝牙适配器状态

getBluetoothAdapterState: function () {
    var that = this;
    wx.getBluetoothAdapterState({
      success: function (res) {
        var isDiscov = res.discovering;//是否正在搜索设备
        var isDvailable = res.available;//蓝牙适配器是否可用
        if (isDvailable) {
          var log = that.data.textLog + "本机蓝牙适配器状态:可用 \n";
          that.setData({
            textLog: log
          });
          if (!isDiscov){
            that.startBluetoothDevicesDiscovery();
          }else{
            var log = that.data.textLog + "已在搜索设备 \n";
            that.setData({
              textLog: log
            });
          }
        }
      }
    })
  }

4.开始扫描附近的蓝牙外围设备。注意,该操作比较耗费系统资源,请在搜索并连接到设备后调用 stop 方法停止搜索。

wx.startBluetoothDevicesDiscovery({
      services: [],// 以微信硬件平台的蓝牙智能灯为例,主服务的 UUID 是 FEE7。传入这个参数:services: ['FEE7'],只搜索主服务 UUID 为 FEE7 的设备
      allowDuplicatesKey: true,  //是否允许重复上报同一设备, 如果允许重复上报,则onDeviceFound 方法会多次上报同一设备,但是 RSSI(信号) 值会有不同
      success: function (res) {
        var log = that.data.textLog + "扫描附近的蓝牙外围设备成功,准备监听寻找新设备:" + res+"\n";
        that.setData({
          textLog: log
        });
        that.onBluetoothDeviceFound();  //监听寻找到新设备的事件
      }
    });

5.监听寻找到新设备的事件;Android 上获取到的deviceId为设备 MAC 地址,iOS 上则为设备 uuid。因此deviceId不能硬编码到代码中

//监听寻找到新设备的事件
  onBluetoothDeviceFound:function() {
    var that = this;
    wx.onBluetoothDeviceFound(function(res) {
      res.devices.forEach(function (device) {
        if (!device.name && !device.localName) {
          return
        }
        const foundDevices = that.data.devices;       
        const idx = inArray(foundDevices, 'deviceId', device.deviceId);       
        const data = {};
        if (idx === -1) {
          data[`devices[${foundDevices.length}]`] = device
        } else {
          data[`devices[${idx}]`] = device
        }
        that.setData(data)
      })
    })
  }

至此整个过程就完成了对设备的搜索操作,这时就可以对扫描到的设备id以及name,进行处理;不过这个过程需要注意的是:安卓和IOS差别很大,安卓设备地址就是mac地址,但是IOS无法获取mac地址,所以设备地址是针对本机范围有效的UUID,所以这里需要注意。剩下的就是蓝牙设备的连接、读、写、还有监听获取返回值了。

6.连接低功耗蓝牙设备。

wx.createBLEConnection({  // 这里的 deviceId 需要已经通过 createBLEConnection 与对应设备建立链接  
 deviceId: deviceId,
  success: function (res) { 
   console.log(res)
  }
})

当使用此方法成功连接蓝牙设备后,需要使用方法:wx.stopBluetoothDevicesDiscovery() 关闭蓝牙扫描功能,释放资源,减少消耗。

7.获取蓝牙设备所有 service(服务)

//获取蓝牙设备所有 service(服务)
  getBLEDeviceServices:function(devId) {
    var that = this;
    wx.getBLEDeviceServices({
      deviceId:devId,
      success: function(res) {
        for (let i = 0; i < res.services.length; i++) {
          if (res.services[i].isPrimary) {//该服务是否为主服务
            var log = that.data.textLog + "该服务是否为主服务:" + res.services[i].isPrimary + "\n";
            that.setData({
              textLog: log
            });

          }
        }
      }
    })
  }

8.获取到服务ID后,就可以获取蓝牙设备某个服务中的所有 characteristic(特征值)

//获取蓝牙设备某个服务中的所有 characteristic(特征值)
  getBLEDeviceCharacteristics: function (deviceId, serviceId){
    var that = this;
    wx.getBLEDeviceCharacteristics({
      deviceId: deviceId,
      serviceId: serviceId,
      success: function (res) {
        for (let i = 0; i < res.characteristics.length; i++) {
          let item = res.characteristics[i]
          if (item.properties.read) {//该特征值是否支持 read 操作
            var log = that.data.textLog + "该特征值支持 read 操作:" + item.uuid + "\n";
            that.setData({
              textLog: log,
              readCharacteristicId: item.uuid
            });
          }
          if (item.properties.write) {//该特征值是否支持 write 操作
            var log = that.data.textLog + "该特征值支持 write 操作:" + item.uuid + "\n";
            that.setData({
              textLog: log,
              writeCharacteristicId: item.uuid,
              canWrite:true
            });
          }
          if (item.properties.notify) {//该特征值是否支持 notify或indicate 操作
            var log = that.data.textLog + "该特征值支持 notify 操作:" + item.uuid + "\n";
            that.setData({
              textLog: log,
              notifyCharacteristicId: item.uuid,
            });
            that.notifyBLECharacteristicValueChange();
          }

        }

      }
    })
  }

至此,我们已经获取了 读的特征值UUID,有些设备不支持读操作的话,就没有这个UUID;我们还获取了写操作的UUID,如果没有此UUID的话,我们的设备就不支持写入指令操作;我们还获取了notify UUID,是用来执行广播监听事件的,就是写入指令后,蓝牙设备有返回数值,都可以监听接收。

9.开启监听蓝牙设备的返回值,读写操作成功后的返回值也是在下面onBLECharacteristicValueChange这个方法获取,这里相当于Android蓝牙BLE的开启广播监听。

notifyBLECharacteristicValueChange:function(){
    var that = this;
    wx.notifyBLECharacteristicValueChange({
      state: true, // 启用 notify 功能
      deviceId: that.data.deviceId,
      serviceId: that.data.serviceId,
      characteristicId: that.data.notifyCharacteristicId,
      success: function (res) {
        var log = that.data.textLog + "notify启动成功\n";
        that.setData({ 
          textLog: log,
        });
        that.onBLECharacteristicValueChange();   //监听特征值变化

      },
      fail: function (res) {
        wx.showToast({
          title: 'notify启动失败',
          mask: true
        });
        setTimeout(function () {
          wx.hideToast();
        }, 2000)
      }
    })

  },
  //监听低功耗蓝牙设备的特征值变化。必须先启用notify接口才能接收到设备推送的notification。
  onBLECharacteristicValueChange:function(){
    var that = this;
    var log = that.data.textLog + "准备监听低功耗蓝牙设备的特征值变化\n";
    that.setData({
      textLog: log,
    });
    wx.onBLECharacteristicValueChange(function (res) {
      var log = that.data.textLog + "监听低功耗蓝牙设备的特征值变化\n";
      that.setData({
        textLog: log,
      });
      // var resValue = that.ab2hext(res.value); //16进制字符串  

    });
  }

10.最后一步,读或写操作;这里需要注意的是:小程序中对蓝牙数据的传递是使用ArrayBuffer的二进制类型来的,所以在我们的使用过程中需要进行转码再进行读或者写操作。

//读
wx.readBLECharacteristicValue({
  // 这里的 deviceId 需要已经通过 createBLEConnection 与对应设备建立链接  [**new**]
  deviceId: deviceId,
  // 这里的 serviceId 需要在上面的 getBLEDeviceServices 接口中获取
  serviceId: serviceId,
  // 这里的 characteristicId 需要在上面的 getBLEDeviceCharacteristics 接口中获取
  characteristicId: characteristicId,
  success: function (res) {
    console.log('readBLECharacteristicValue:', res.errCode)
  }
})


、、、、、


//写
wx.writeBLECharacteristicValue({
  // 这里的 deviceId 需要在上面的 getBluetoothDevices 或 onBluetoothDeviceFound 接口中获取
  deviceId: deviceId,
  // 这里的 serviceId 需要在上面的 getBLEDeviceServices 接口中获取
  serviceId: serviceId,
  // 这里的 characteristicId 需要在上面的 getBLEDeviceCharacteristics 接口中获取
  characteristicId: characteristicId,
  // 这里的value是ArrayBuffer类型
  value: buffer,
  success: function (res) {
    console.log('writeBLECharacteristicValue success', res.errMsg)
  }
})

 、、、、、 

 //写
wx.writeBLECharacteristicValue({
  // 这里的 deviceId 需要在上面的 getBluetoothDevices 或 onBluetoothDeviceFound 接口中获取 
 deviceId: deviceId,  
// 这里的 serviceId 需要在上面的 getBLEDeviceServices 接口中获取  
serviceId: serviceId, 
 // 这里的 characteristicId 需要在上面的 getBLEDeviceCharacteristics 接口中获取  
characteristicId: characteristicId, 
 // 这里的value是ArrayBuffer类型  
value: buffer, 
 success: function (res) { 
   console.log('writeBLECharacteristicValue success', res.errMsg) 
 }
}
)

查看小程序蓝牙api也会发现如下tip:
image.png

就是要控制单次传送的指令,确保不要超过20个字节,如果超过了,就要进行分包发送了,也就是每次分20个字节,分成多次发送,如果是Android开发的话,可以调整MTU的大小,但是小程序没有封装这个方法,所以只能分包也是可以的。

在学习小程序蓝牙的过程中,我也写了个demo:小程序蓝牙demo,希望能帮助到大家,并且也能趁此机会和大家交流,望多多指教。

相关文章
|
13天前
|
人工智能 小程序
一步步开发AI运动小程序】二、引入插件
随着人工智能技术的发展,阿里体育等公司推出的“乐动力”、“天天跳绳”等AI运动APP广受欢迎。本文将引导您从零开始开发一个AI运动小程序,使用“云智AI运动识别小程序插件”。内容包括新建uni-app项目、配置插件、部署模型、安装依赖包、全局初始化和调用插件对象。
|
12天前
|
小程序 搜索推荐 数据挖掘
跳绳打卡小程序开发多钱费用
跳绳打卡小程序通过智能手机即可轻松使用,无需额外设备,只需一根跳绳即可开始您的健康之旅。它结合了便捷性、互动性和个性化设置,让跳绳这项运动变得更加有趣和高效
|
14天前
|
小程序 JavaScript 前端开发
uni-app开发微信小程序:四大解决方案,轻松应对主包与vendor.js过大打包难题
uni-app开发微信小程序:四大解决方案,轻松应对主包与vendor.js过大打包难题
281 1
|
10天前
|
存储 传感器 小程序
跳绳计数小程序开发系统
首先,我们需要明确跳绳计数小程序的核心功能:为用户提供跳绳计数的便捷方式。这意味着小程序需要能够准确地记录用户的跳绳次数,并为用户提供清晰、直观的计数展示。
|
10天前
|
人工智能 编解码 小程序
【一步步开发AI运动小程序】四、小程序如何抽帧
随着AI技术的发展,阿里体育等公司推出的“乐动力”、“天天跳绳”等APP使云上运动会、线上健身等概念备受关注。本文将引导您从零开始开发一个AI运动小程序,利用“云智AI运动识别小程序插件”。文中详细介绍了微信小程序抽帧的相关API、设置及注意事项,帮助开发者更好地实现AI运动功能。下篇将介绍人体识别技术,敬请期待。
|
11天前
|
传感器 存储 小程序
跳绳计数小程序开发
跳绳计数小程序旨在通过智能设备(如手机或智能手表)记录用户在跳绳过程中的次数、时间、速度等关键数据,为用户提供便捷的运动记录和数据分析服务
|
10天前
|
小程序 搜索推荐 前端开发
小剧场短剧影视小程序开发
小剧场短剧影视小程序旨在为用户提供一个便捷、互动的平台,让用户能够随时随地观看、分享和评论各类小剧场短剧。通过小程序,用户可以浏览热门短剧、搜索感兴趣的内容、参与社区互动,以及享受个性化的推荐服务。
|
11天前
|
小程序 搜索推荐 前端开发
短剧小程序开发案例
首先,明确你的短剧平台的目标用户群体和他们的需求。比如,年轻用户可能更倾向于轻松、幽默的短剧内容,而家庭用户则可能更偏爱教育、亲子类的短剧。了解用户需求有助于你设计更符合他们口味的功能和界面
|
11天前
|
机器学习/深度学习 人工智能 小程序
【一步步开发AI运动小程序】三、运动识别处理流程
随着人工智能技术的发展,阿里体育等公司推出的“乐动力”、“天天跳绳”等AI运动APP备受关注。本文将引导您从零开始开发一个AI运动小程序,使用“云智AI运动识别小程序插件”。文章介绍了视频帧、帧率FPS、抽帧和人体识别等基本概念,并详细说明了处理流程,包括抽帧、人体识别检测、骨骼图绘制和运动分析等步骤。下篇将介绍如何在小程序中实现抽帧。
|
14天前
|
JavaScript 小程序 开发者
uni-app开发实战:利用Vue混入(mixin)实现微信小程序全局分享功能,一键发送给朋友、分享到朋友圈、复制链接
uni-app开发实战:利用Vue混入(mixin)实现微信小程序全局分享功能,一键发送给朋友、分享到朋友圈、复制链接
159 0