微信小程序获取蓝牙设备所有service,官方接口为getBLEDeviceServices,此接口非常重要,关系到蓝牙设备发送数据指令以及接收设备响应数据的成功。如果读者不清楚蓝牙设备的service也没关系,跟着教程文档做就可以,后续慢慢的就会明白。
wx.getBLEDeviceServices(OBJECT)
获取蓝牙设备所有 service(服务)
OBJECT参数说明:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
deviceId | String | 是 | 蓝牙设备 id,参考 getDevices 接口 |
success | Function | 是 | 成功则返回本机蓝牙适配器状态 |
fail | Function | 否 | 接口调用失败的回调函数 |
complete | Function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
success返回参数:
参数 | 类型 | 说明 |
---|---|---|
services | Array | 设备服务列表 |
errMsg | String | 成功:ok,错误:详细信息 |
service对象
蓝牙设备service(服务)信息
参数 | 类型 | 说明 |
---|---|---|
uuid | String | 蓝牙设备服务的 uuid |
isPrimary | Boolean | 该服务是否为主服务 |
示例代码:
wx.getBLEDeviceServices({ // 这里的 deviceId 需要已经通过 createBLEConnection 与对应设备建立链接 deviceId: deviceId, success: function (res) { console.log('device services:', res.services) } })
Bug & Tip
tip:iOS平台上后续对特征值的read、write、notify,由于系统需要获取特征值实例,传入的 serviceId 与 characteristicId 必须由 getBLEDeviceServices 与 getBLEDeviceCharacteristics 中获取到后才能使用。建议双平台统一在建立链接后先执行 getBLEDeviceServices 与 getBLEDeviceCharacteristics 后再进行与蓝牙设备的数据交互
根据官方文档编写实现代码
1,打开微信小程序开发工具,编写lanya.wxml 实际上此页面类似于html页面一样,代码如下
<view class="content"> <view>日志信息: <textarea style='border:1px solid #ccc'> {{msg}} </textarea> </view> <button type="primary" class="button" bindtap="lanya1">1初始化蓝牙适配器</button> <button type="primary" class="button" bindtap="lanya2">2本机蓝牙适配状态</button> <button type="primary" class="button" bindtap="lanya3">3搜索周边蓝牙设备</button> <button type="primary" class="button" bindtap="lanya4">4获取所有周边蓝牙设备信息</button> <block wx:for="{{devices}}" wx:key="{{test}}"> <button type="primary" class="button" id="{{item.deviceId}}" style='background-color:red' bindtap="connectTO">连接蓝牙设备{{item.name}}</button> </block> <button type="primary" class="button" bindtap="lanya5">5停止搜索周边蓝牙设备</button> <button type="primary" class="button" bindtap="lanya6">6获取蓝牙设备所有service(服务)</button> </view><!--www.vxzsk.com V型知识库原创 -->
如上述代码,新增了一个名为获取蓝牙设备所有service(服务)的按钮,且绑定的js函数为lanya6,此函数便是实现获取蓝牙设备所有service的方法,代码如下:
2、打开lanya.js文件,实现wx.getBLEDeviceServices(OBJECT)接口代码如下:
// 获取连接设备的service服务 V型知识库 www.vxzsk.com原创 lanya6: function () { var that = this; wx.getBLEDeviceServices({ // 这里的 deviceId 需要在上面的 getBluetoothDevices 或 onBluetoothDeviceFound 接口中获取 deviceId: that.data.connectedDeviceId, success: function (res) { console.log('device services:', JSON.stringify(res.services)); for(var i=0;i<res.services.length;i++){ console.log(i+"--UUID:------"+res.services[i].uuid) //var servicesUuid = res.services[i].uuid } that.setData({ services: res.services, msg: JSON.stringify(res.services), }) } }) }
如上述代码所示,蓝牙设备可能不止一个服务值,可能会存在两个及两个以上的服务,我们只要找出读写服务即可,不过此接口并不能看出蓝牙设备的读写服务是哪一个,具体读写服务如何验证接下来的章节会介绍,本章节暂不解释,只获取蓝牙设备的service。
如上述代码,当我们获取到蓝牙设备的service后,会在日志中循环打印输出这些service。
3、启动硬件蓝牙设备(例如蓝牙打印机,蓝牙锁等),打开手机蓝牙,打开手机微信app,然后点击微信小程序开发工具头部的预览按钮,会出现一个二维码,用微信app扫描此二维码,加载小程序应用。
效果如下
如上图 点击获取蓝牙设备service按钮后的效果,一共获取到三个蓝牙设备的service,分别为FEE7,FEE8,FEE9。
lanya.wxml源码
<view class="content"> <view>日志信息: <textarea style='border:1px solid #ccc'> {{msg}} </textarea> </view> <button type="primary" class="button" bindtap="lanya1">1初始化蓝牙适配器</button> <button type="primary" class="button" bindtap="lanya2">2本机蓝牙适配状态</button> <button type="primary" class="button" bindtap="lanya3">3搜索周边蓝牙设备</button> <button type="primary" class="button" bindtap="lanya4">4获取所有周边蓝牙设备信息</button> <block wx:for="{{devices}}" wx:key="{{test}}"> <button type="primary" class="button" id="{{item.deviceId}}" style='background-color:red' bindtap="connectTO">连接蓝牙设备{{item.name}}</button> </block> <button type="primary" class="button" bindtap="lanya5">5停止搜索周边蓝牙设备</button> <button type="primary" class="button" bindtap="lanya6">6获取蓝牙设备所有service(服务)</button> </view><!--V型知识库www.vxzsk.com原创-->
lanya.js源码
// pages/lanya/lanya.js www.vxzsk.com V型知识库原创 Page({ /** * 页面的初始数据 */ data: { }, /** * 生命周期函数--监听页面加载 */ onLoad: function (options) { }, /** * 生命周期函数--监听页面初次渲染完成 */ onReady: function () { }, /** * 生命周期函数--监听页面显示 */ onShow: function () { }, /** * 生命周期函数--监听页面隐藏 */ onHide: function () { }, /** * 生命周期函数--监听页面卸载 */ onUnload: function () { }, /** * 页面相关事件处理函数--监听用户下拉动作 */ onPullDownRefresh: function () { }, /** * 页面上拉触底事件的处理函数 */ onReachBottom: function () { }, /** * 用户点击右上角分享 */ onShareAppMessage: function () { }, // 初始化蓝牙适配器 lanya1: function () { var that = this; wx.openBluetoothAdapter({ success: function (res) { console.log('初始化蓝牙适配器返回' + JSON.stringify(res)) //页面日志显示 that.setData({ msg: JSON.stringify(res) }) }, fail:function(res){ console.log('初始化蓝牙适配器失败' + JSON.stringify(res)) } }) }, // 本机蓝牙适配器状态 lanya2: function () { var that = this; wx.getBluetoothAdapterState({ success: function (res) { //页面日志显示 that.setData({ msg: "本机蓝牙适配器状态" + "/" + JSON.stringify(res.errMsg) + "==是否可用:" + res.available }) }, fail:function(res){ //页面日志显示 that.setData({ msg: "本机蓝牙适配器状态" + "/" + JSON.stringify(res.errMsg) + "==是否可用:" + res.available }) } }) }, //搜索设备 lanya3: function () { var that = this; wx.startBluetoothDevicesDiscovery({ //services: ['FEE7'], success: function (res) { that.setData({ msg: "搜索设备" + JSON.stringify(res), }) console.log('搜索设备返回' + JSON.stringify(res)) } }) }, // 获取所有已发现的设备 lanya4: function () { var that = this; wx.getBluetoothDevices({ success: function (res) { that.setData({ msg: "搜索设备" + JSON.stringify(res.devices), devices: res.devices }) console.log('搜到的蓝牙设备数目:' + res.devices.length) console.log('获取到周边搜到的设备信息:' + JSON.stringify(res.devices)) } }) }, //连接设备 connectTO: function (e) { var that = this; wx.createBLEConnection({ deviceId: e.currentTarget.id, success: function (res) { console.log('连接设备返回:'+res.errMsg); that.setData({ connectedDeviceId: e.currentTarget.id, msg: "已连接" + e.currentTarget.id + '==='+'连接设备返回:'+res.errMsg, msg1: "", }) }, fail: function () { console.log("调用失败"); }, complete: function () { console.log("调用结束"); } }) console.log(that.data.connectedDeviceId); }, //停止搜索周边设备 lanya5: function () { var that = this; wx.stopBluetoothDevicesDiscovery({ success: function (res) { that.setData({ msg: "停止搜索周边设备" + "/" + JSON.stringify(res.errMsg), sousuo: res.discovering ? "在搜索。" : "未搜索。", status: res.available ? "可用。" : "不可用。", }) } }) }, // 获取连接设备的service服务 V型知识库www.vxzsk.com原创 lanya6: function () { var that = this; wx.getBLEDeviceServices({ // 这里的 deviceId 需要在上面的 getBluetoothDevices 或 onBluetoothDeviceFound 接口中获取 deviceId: that.data.connectedDeviceId, success: function (res) { console.log('device services:', JSON.stringify(res.services)); for(var i=0;i<res.services.length;i++){ console.log(i+"--UUID:------"+res.services[i].uuid) //var servicesUuid = res.services[i].uuid } that.setData({ services: res.services, msg: JSON.stringify(res.services), }) } }) } })
感觉本站内容不错,读后有收获?小额赞助,鼓励网站分享出更好的教程