小程序获取连接蓝牙设备所有特征值(getBLEDeviceCharacteristics)

我们在上一章节讲解了小程序获取蓝牙设备所有service(getBLEDeviceServices)，并且在此章节获取到了三个蓝牙设备服务，它们分别为"FEE7","FEE8","FEE9",三个都是简写，详情请移步上一章节，本章节着重说下蓝牙设备的特征值的获取，不过呢，好多读者在这里迷糊了，蓝牙设备的服务，蓝牙设备的特征值到底是个什么鬼东西，其实本作者也仅仅是个软件程序员，对于硬件不是很了解，故上网查了下，摘录了一部分，讲解的我认为还是比较明了的，具体如下：

之前说到蓝牙的连接过程，那蓝牙连接之后具体是如何传数据的呢。这里做一下简要说明。

蓝牙4.0是以参数来进行数据传输的，即服务端定好一个参数，客户端可以对这个参数进行读，写，通知等操作，这个东西我们称之为特征值（characteristic），

但一个参数不够我们用，比如我们这个特征值是电量的值，另一个特征值是设备读取的温度值。

那这时候会有多个特征值，并且我们还会对它们分类，分出来的类我们称之为服务（service）。

一个设备可以有多个服务，每一个服务可以包含多个特征值。为了方便操作，每个特征值都有他的属性，例如长度（size）,权限（permission），值（value）,描述（descriptor）。

如上面文字的解释说明，我们一般接入小程序的蓝牙智能设备必须具备读、写、通知三个属性，否则无法利用微信小程序对设备进行控制(向设备发送指令，向设备写入指令，微信小程序接收硬件返回的数据)。

获取蓝牙设备特征值接口getBLEDeviceCharacteristics官方文档如下：

wx.getBLEDeviceCharacteristics(OBJECT)

获取蓝牙设备某个服务中的所有 characteristic（特征值）

OBJECT参数说明：

success返回参数：

characteristic对象

蓝牙设备characteristic(特征值)信息

properties对象

示例代码：

wx.getBLEDeviceCharacteristics({
  // 这里的 deviceId 需要已经通过 createBLEConnection 与对应设备建立链接
  deviceId: deviceId,
  // 这里的 serviceId 需要在上面的 getBLEDeviceServices 接口中获取
  serviceId: serviceId,
  success: function (res) {
    console.log('device getBLEDeviceCharacteristics:', res.characteristics)
  }
})<!--V型知识库原创 www.vxzsk.com-->

Bug & Tip

tip:传入的serviceId需要在getBLEDeviceServices获取到

tip:iOS平台上后续对特征值的read、write、notify，由于系统需要获取特征值实例，传入的 serviceId 与 characteristicId 必须由 getBLEDeviceServices 与 getBLEDeviceCharacteristics 中获取到后才能使用。建议双平台统一在建立链接后先执行 getBLEDeviceServices 与 getBLEDeviceCharacteristics 后再进行与蓝牙设备的数据交互

根据官方文档编写实现代码

根据微信小程序官方文档，getBLEDeviceCharacteristics此接口需要两个必要参数，一个是连接设备的deviceId,另一个是蓝牙设备主服务的UUID，那么在这里我们分别解释下这两个参数。

deviceId:deviceId的获取我们在第5章节已经获取到了，如果是Android 上获取到的deviceId为设备 MAC 地址，iOS 上则为设备 uuid。因此deviceId不能硬编码到代码中，如果你仅仅是测试的话用安卓手机则也可以直接写成mac地址。

serviceId:就是我们在第9章节获取到的蓝牙设备UUID,但有个疑问，主服务的UUID并不是一个，有可能是多个，例如本人蓝牙设备获取到了三个，分别是FEE7，FEE8，FEE9，那么传入参数的时候该传那个呢？嘿嘿，本人也不知道，可以问下硬件厂商，如果问不到，那就把三个分别都测试下，那个能用，用那个，经过测试，具有读、写、通知的服务UUID为FEE7，接下来的示例代码也将传入的是FEE7,那么我们就实现FEE7下面的特征值有哪些吧。

1，打开微信小程序开发工具，编写lanya.wxml  实际上此页面类似于html页面一样，代码如下

<view class="content"><!--V型知识库原创 www.vxzsk.com-->
<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>
<button type="primary" class="button" bindtap="lanya7">7获取连接设备所有特征值</button>


</view>

如上面所示，第17行代码新增了名为获取连接设备所有特征值的按钮，且绑定了一个名为lanya7的js函数，此函数便是实现获取连接设备所有特征值的方法。

2、打开lanya.js文件，实现wx.getBLEDeviceCharacteristics(OBJECT)接口代码如下：

//获取连接设备的所有特征值  
lanya7: function () {
var that = this;
var myuuid = that.data.services[2].uuid //具有读写通知属性的服务uuid
wx.getBLEDeviceCharacteristics({
// 这里的 deviceId 需要在上面的 getBluetoothDevices 或 onBluetoothDeviceFound 接口中获取
deviceId: that.data.connectedDeviceId,
// 这里的 serviceId 需要在上面的 getBLEDeviceServices 接口中获取
serviceId: myuuid,
success: function (res) {
for (var i = 0; i < res.characteristics.length; i++) {
console.log('特征值：' + res.characteristics[i].uuid)

}
console.log('device getBLEDeviceCharacteristics:', res.characteristics);

that.setData({
msg: JSON.stringify(res.characteristics),
})
},
fail: function () {
console.log("fail");
},
complete: function () {
console.log("complete");
}
})

}

如上述代码第4行，便是主服务UUID，由于本作者做了测试，测试结果FEE7具备读写通知条件，且在数组下标为2中，当然你如果知道值的话，可以直接硬编码写在这里。UUID获取请参考第9章节。

第7行为连接设备的deviceId,如果不清楚如何获得请分别参考第5章节。

从第11行代码开始循环设备的特征值。

3、启动硬件蓝牙设备(例如蓝牙打印机，蓝牙锁等)，打开手机蓝牙，打开手机微信app,然后点击微信小程序开发工具头部的预览按钮，会出现一个二维码，用微信app扫描此二维码，加载小程序应用。

打开日志效果如下：

如上图所示，红的圈部分便是获取到的特征值，一共获取到了6个特征值，现在用户更有疑问了，到底用哪一个呢？其实官方文档已经给了判断方法，具有读、写、通知操作的属性特征值properties对象便能判断出来，不清楚的读者请看上面的官方文档properties对象，判断实现方法如下：

在循环特征值的for语句里面判断

for (var i = 0; i < res.characteristics.length; i++) {
console.log('特征值：' + res.characteristics[i].uuid)
if (res.characteristics[i].properties.notify) {
console.log("获取开启notify的ServicweId：", myuuid);
console.log("获取开启notify的CharacteristicsId：", res.characteristics[i].uuid);
that.setData({
notifyServicweId: myuuid,
notifyCharacteristicsId: res.characteristics[i].uuid,

})
}
if (res.characteristics[i].properties.write) {
console.log("获取开启write的ServicweId：", myuuid);
console.log("获取开启write的CharacteristicsId：", res.characteristics[i].uuid);
that.setData({
writeServicweId: myuuid,
writeCharacteristicsId: res.characteristics[i].uuid,
})
} else if (res.characteristics[i].properties.read) {
console.log("读read操作readServicweId：", myuuid);
console.log("读read操作：readCharacteristicsId", res.characteristics[i].uuid);
that.setData({
readServicweId: myuuid,
readCharacteristicsId: res.characteristics[i].uuid,
})

}
}

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>
<button type="primary" class="button" bindtap="lanya7">7获取连接设备所有特征值</button>

<!--V型知识库原创 www.vxzsk.com-->
</view>

lanya.js源码

// pages/lanya/lanya.js www.vxzsk.com V型知识库原创
Page({

/**
   * 页面的初始数据
   */
data: {
connectedDeviceId: "", //已连接设备uuid
services: "", // 连接设备的服务
characteristics: "",   // 连接设备的状态值
writeServicweId: "", // 可写服务uuid
writeCharacteristicsId: "",//可写特征值uuid
readServicweId: "", // 可读服务uuid
readCharacteristicsId: "",//可读特征值uuid
notifyServicweId: "", //通知服务UUid
},

/**
   * 生命周期函数--监听页面加载
   */
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服务
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),
})
}
})
},
//获取连接设备的所有特征值  
lanya7: function () {
var that = this;
var myuuid = that.data.services[2].uuid //具有读写通知属性的服务uuid
console.log('myuuid' + myuuid)
wx.getBLEDeviceCharacteristics({
// 这里的 deviceId 需要在上面的 getBluetoothDevices 或 onBluetoothDeviceFound 接口中获取
deviceId: that.data.connectedDeviceId,
// 这里的 serviceId 需要在上面的 getBLEDeviceServices 接口中获取
serviceId: myuuid,
success: function (res) {
for (var i = 0; i < res.characteristics.length; i++) {
console.log('特征值：' + res.characteristics[i].uuid)
if (res.characteristics[i].properties.notify) {
console.log("获取开启notify的ServicweId：", myuuid);
console.log("获取开启notify的CharacteristicsId：", res.characteristics[i].uuid);
that.setData({
notifyServicweId: myuuid,
notifyCharacteristicsId: res.characteristics[i].uuid,

})
}
if (res.characteristics[i].properties.write) {
console.log("获取开启write的ServicweId：", myuuid);
console.log("获取开启write的CharacteristicsId：", res.characteristics[i].uuid);
that.setData({
writeServicweId: myuuid,
writeCharacteristicsId: res.characteristics[i].uuid,
})
} else if (res.characteristics[i].properties.read) {
console.log("读read操作readServicweId：", myuuid);
console.log("读read操作：readCharacteristicsId", res.characteristics[i].uuid);
that.setData({
readServicweId: myuuid,
readCharacteristicsId: res.characteristics[i].uuid,
})

}
}
console.log('device getBLEDeviceCharacteristics:', res.characteristics);

that.setData({
msg: JSON.stringify(res.characteristics),
})
},
fail: function () {
console.log("fail");
},
complete: function () {
console.log("complete");
}
})

}
})