微信開(kāi)發(fā)BLE小程序前期準(zhǔn)備工作：
- 微信小程序藍(lán)牙開(kāi)發(fā)文檔
- 微信開(kāi)發(fā)工具 至于這個(gè)軟件是nw.js寫(xiě)的 為什么不支持linux 我也不知道
- 需要的藍(lán)牙設(shè)備 （此文將只針對(duì)BLE設(shè)備進(jìn)行說(shuō)明）
- 如果你是快應(yīng)用的開(kāi)發(fā)者甘桑，請(qǐng)自行腦補(bǔ)快應(yīng)用api 如果我沒(méi)觀察錯(cuò)玛瘸，大部分api都長(zhǎng)一個(gè)樣 快應(yīng)用藍(lán)牙文檔
// 快應(yīng)用這個(gè)例子 ‘FEE7’和微信的一毛一樣审残，這個(gè)serviceuuid是微信硬件平臺(tái)的藍(lán)牙智能燈
bluetooth.startDevicesDiscovery({
services: ['FEE7'],
success: function() {
console.log('success')
}
})
微信藍(lán)牙API
微信有操作藍(lán)牙適配器的操作有4個(gè)。
// 初始化(打開(kāi))藍(lán)牙適配器
wx.openBluetoothAdapter
// 關(guān)閉藍(lán)牙模塊
wx.closeBluetoothAdapter
// 獲取本機(jī)藍(lán)牙適配器狀態(tài)
wx.getBluetoothAdapterState
// 監(jiān)聽(tīng)藍(lán)牙適配器狀態(tài)變化事件
wx.onBluetoothAdapterStateChange
注： 打開(kāi)藍(lán)牙設(shè)備適配器不等于手機(jī)端藍(lán)牙開(kāi)關(guān)，此操作是基于微信層面打開(kāi)微信的藍(lán)牙開(kāi)關(guān)彤蔽，若系統(tǒng)藍(lán)牙未打開(kāi) wx.closeBluetoothAdapter 會(huì)調(diào)用失敗，<font color="red">若系統(tǒng)沒(méi)有賦予微信藍(lán)牙權(quán)限，部分機(jī)型無(wú)報(bào)錯(cuò)拯爽。</font>
掃描獲取周?chē)O(shè)備操作4個(gè)
// 開(kāi)始搜尋附近的藍(lán)牙外圍設(shè)備
wx.startBluetoothDevicesDiscovery
// 停止搜尋附近的藍(lán)牙外圍設(shè)備
wx.stopBluetoothDevicesDiscovery
// 獲取所有已發(fā)現(xiàn)的藍(lán)牙設(shè)備
wx.getBluetoothDevices
// 監(jiān)聽(tīng)尋找到新設(shè)備的事件
wx.onBluetoothDeviceFound
- wx.startBluetoothDevicesDiscovery 和 wx.onBluetoothDeviceFound 是配對(duì)使用，藍(lán)牙設(shè)備通信api基本上都為訂閱式的薄霜，與傳統(tǒng)http通信有很大的不同某抓。搜索藍(lán)牙可以通過(guò)serviceuuid區(qū)分，包含數(shù)組中任意一個(gè)service都將被搜索到惰瓜。
- 由于業(yè)務(wù)需求否副，需要格式化藍(lán)牙廣播消息和名稱(chēng)篩選,wx.getBluetoothDevices 此API獲取的都是原始搜索數(shù)據(jù)，故不建議使用崎坊，自行維護(hù)一份格式化后的list备禀。
- 在低版本IOS端微信上會(huì)出現(xiàn)重復(fù)的藍(lán)牙設(shè)備，但是wx.startBluetoothDevicesDiscovery中已經(jīng)聲明了非重復(fù)上報(bào)
allowDuplicatesKey：false奈揍。
藍(lán)牙連接操作2個(gè)
// 連接低功耗藍(lán)牙設(shè)備
wx.createBLEConnection
// 斷開(kāi)與低功耗藍(lán)牙設(shè)備的連接
wx.closeBLEConnection
- 藍(lán)牙斷開(kāi)操作極其耗時(shí)曲尸，親測(cè)設(shè)備斷開(kāi)經(jīng)常長(zhǎng)達(dá)10秒及以上，故不推薦使用男翰，斷開(kāi)藍(lán)牙建議使用 wx.closeBluetoothAdapter 直接關(guān)閉藍(lán)牙模塊另患，簡(jiǎn)單粗暴迅速，但是這樣每次操作藍(lán)牙設(shè)備都要先調(diào)用打開(kāi)適配器蛾绎。
讀寫(xiě)B(tài)LE特征值操作8個(gè)
// 根據(jù) uuid 獲取處于已連接狀態(tài)的設(shè)備
wx.getConnectedBluetoothDevices
// 獲取藍(lán)牙設(shè)備所有 service（服務(wù)）
wx.getBLEDeviceServices
// 獲取藍(lán)牙設(shè)備所有 characteristic（特征值）
wx.getBLEDeviceCharacteristics
// 讀取低功耗藍(lán)牙設(shè)備的特征值的二進(jìn)制數(shù)據(jù)值
wx.readBLECharacteristicValue
// 向低功耗藍(lán)牙設(shè)備特征值中寫(xiě)入二進(jìn)制數(shù)據(jù)
wx.writeBLECharacteristicValue
// 啟用低功耗藍(lán)牙設(shè)備特征值變化時(shí)的 notify 功能
wx.notifyBLECharacteristicValueChange
// 監(jiān)聽(tīng)低功耗藍(lán)牙設(shè)備的特征值變化
wx.onBLECharacteristicValueChange
// 監(jiān)聽(tīng)低功耗藍(lán)牙連接的連接狀態(tài)改變
wx.onBLEConnectionStateChange
藍(lán)牙serviceuuid 一般用于區(qū)別不同的設(shè)備昆箕，基本上每個(gè)ID對(duì)應(yīng)一個(gè)BLE藍(lán)牙產(chǎn)品。
每一個(gè)serviceuuid又對(duì)應(yīng)不同的
characteristic租冠，這些characteristic通常包含read/write/write/indicate中的一種或多著屬性（具體看藍(lán)牙協(xié)議自定）
小程序內(nèi)通過(guò)service 與 characteristic組合去監(jiān)聽(tīng)或發(fā)送消息鹏倘，
必須設(shè)備的特征支持 notify 或者 indicate 才可以成功調(diào)用監(jiān)聽(tīng)，支持read才可以調(diào)用寫(xiě)入二進(jìn)制數(shù)據(jù)顽爹。
藍(lán)牙開(kāi)發(fā)流程
搜索藍(lán)牙設(shè)備
// part 1.
// 關(guān)閉藍(lán)牙模塊 防止之前還有藍(lán)牙緩存 先關(guān)閉再打開(kāi)纤泵，以防萬(wàn)一
wx.closeBluetoothAdapter({
// 接口調(diào)用結(jié)束的回調(diào)函數(shù)
success: function () {
// 初始化藍(lán)牙模塊
wx.openBluetoothAdapter({
success: function () {
// 獲取本機(jī)藍(lán)牙適配器狀態(tài) 很少使用
// wx.getBluetoothAdapterState({
// success: function (res) {
// console.log(res)
// },
// })
// 開(kāi)始搜尋附近的藍(lán)牙外圍設(shè)備
wx.startBluetoothDevicesDiscovery({
//不允許重復(fù)上報(bào)設(shè)備（低版本ios 有概率出現(xiàn)失效，表現(xiàn)為同設(shè)備不同RSSI信號(hào)強(qiáng)度）
allowDuplicatesKey: false,
// 搜索到藍(lán)牙的上報(bào)頻率镜粤，每120毫秒上報(bào)一次搜索到的設(shè)備
interval: 120,
// 業(yè)務(wù)需求捏题，我司設(shè)備都包含這兩個(gè)service玻褪，此處是包含任意一個(gè)就可以被搜到
services: ['0000FFC0', '0000FFF0'],
success: function () {
//do somthing... 一般式用于初始化一些屬性
},
})
},
// 失敗時(shí)調(diào)用彈窗告訴用戶藍(lán)牙尚未打開(kāi)
fail: function () {
wx.showModal({
title: '提示',
content: '請(qǐng)檢查手機(jī)藍(lán)牙是否打開(kāi)',
showCancel: false,
success: function () {
// do something
},
})
},
})
},
})
// part 2. 這部分屬于重點(diǎn)，用于找到設(shè)備后的訂閱操作
// 找到新的藍(lán)牙設(shè)備
// 此處是接受一個(gè)obj包含120毫秒內(nèi)找到的符合要求的設(shè)備
wx.onBluetoothDeviceFound(function (obj) {
// 這個(gè)list是未過(guò)濾的list
const list = []
// 過(guò)濾后可見(jiàn)的
const viewList=[]
// 對(duì)象中的 devices 對(duì)象才是真身
const {
devices
} = obj
for (let device of devices) {
// 獲取設(shè)備類(lèi)型 機(jī)密操作 在廣播值中獲取真實(shí)的mac地址 設(shè)備類(lèi)型等等操作 用于兼容ios設(shè)備 此操作需要設(shè)備固件寫(xiě)入mac
const bleType = getType(device)
// 根據(jù)協(xié)議解析廣播包
if (device.advertisData) {
// 根據(jù)不同的設(shè)備解析不同的協(xié)議
device.advertisData = formatterAdvertis(device.advertisData, bleType)
}
device.bleType = bleType
list.push(device)
// 過(guò)濾設(shè)備是否可見(jiàn)
if (deviceCanView(device)) {
viewList.push(device)
}
}
// 由于120毫秒setData調(diào)用一次在一些低端機(jī)型上過(guò)于卡頓這里做了一下間隔涉馅，由于前期數(shù)據(jù)量較小归园，也方便首頁(yè)加載顯示，所以第二次第五次也進(jìn)行刷新稚矿，否則每1200毫秒刷刷新一次庸诱。
if (that.data.cnt % 10 == 0 || [2, 5].includes(that.data.cnt)) {
that.setData({
viewList: [...that.data.viewList,...viewList]
})
}
// 計(jì)數(shù)
that.data.cnt++
// 直接賦值不會(huì)出發(fā)頁(yè)面數(shù)據(jù)變化 安心賦值非過(guò)濾數(shù)據(jù)
that.data.devicesList = [...that.data.devicesList, ...list]
})
// part 3.
// 監(jiān)聽(tīng)藍(lán)牙斷開(kāi) 重置一些屬性
wx.onBLEConnectionStateChange(function (res) {
// 連接斷開(kāi)后操作
if (!res.connected) {
// dosomthing
Dialog.close()
wx.showToast({
title: '藍(lán)牙已斷開(kāi)',
icon: 'success',
duration: 500,
})
}
})
連接藍(lán)牙設(shè)備
// part 1. 連接上設(shè)備 并監(jiān)聽(tīng)notify
// 設(shè)置MTU最大傳輸單元
// 怎么碩呢，這個(gè)東西是因?yàn)橹傲骺財(cái)?shù)據(jù)晤揣，數(shù)據(jù)過(guò)長(zhǎng)所以需要設(shè)置一下桥爽，僅安卓有效，ios設(shè)備會(huì)自動(dòng)協(xié)商
wx.setBLEMTU({
// 這個(gè)id 就是蘋(píng)果設(shè)備的uuid 安卓設(shè)備的mac地址
deviceId: device.deviceId,
mtu: 160,
success: (res) => {
console.log("setBLEMTU success")
},
fail: (res) => {
console.log("setBLEMTU fail", res)
}
});
wx.getBLEDeviceServices({
// 這個(gè)id 就是蘋(píng)果設(shè)備的uuid 安卓設(shè)備的mac地址
deviceId: device.deviceId,
success: function (serviceRes) {
// 每個(gè)設(shè)備都有一個(gè)或多個(gè)service 所以這里拿到的是一個(gè)list 大家按需求去過(guò)濾
const services = serviceRes.services.filter(item => item.uuid.startsWith('0000FFF0'))[0]
wx.getBLEDeviceCharacteristics({
deviceId: device.deviceId,
serviceId: services.uuid,
success: function (characterRes) {
// 特征值也是一樣的昧识，每個(gè)service都包含不同的特征值钠四，拿到的也是個(gè)list
// 寫(xiě)入特征值 這個(gè)特征值用于向設(shè)備寫(xiě)入二進(jìn)制數(shù)據(jù)
const characteristics = characterRes.characteristics.filter(item => item.uuid.startsWith('0000FFF1'))[0]
// notify特征值 這個(gè)特征值用于監(jiān)聽(tīng)notify
const notifyCharacteristics = characterRes.characteristics.filter(item => item.uuid.startsWith('0000FFF4'))[0]
// 啟動(dòng)廣播
wx.notifyBLECharacteristicValueChange({
state: true,
deviceId: device.deviceId,
serviceId: services.uuid,
characteristicId: notifyCharacteristics.uuid,
success: function (_) {
// dosomething...
},
fail: function (e) {
console.log('啟用notify失敗', e)
},
})
},
})
},
})
// part 2. 向設(shè)備寫(xiě)入二進(jìn)制數(shù)據(jù)
wx.writeBLECharacteristicValue({
// 這個(gè)id 就是蘋(píng)果設(shè)備的uuid 安卓設(shè)備的mac地址
deviceId: device.deviceId,
// 所需要的特征值
serviceId: services.uuid,
// 設(shè)備用于notify的特征值
characteristicId: characteristics.uuid,
// 二進(jìn)制數(shù)據(jù) Arraybuffer 一般都是封裝好的二進(jìn)制協(xié)議包
value: buffer,
success: function (res) {
if (toast) {
wx.showToast({
title: '發(fā)送成功',
icon: 'success',
duration: 500,
})
}
},
fail: function (res) {
wx.showToast({
title: '發(fā)送失敗',
icon: 'error',
duration: 500,
})
},
complete: callBack
})
藍(lán)牙搜索，連接跪楞，寫(xiě)入缀去，監(jiān)聽(tīng)的操作基本都在上述這些，還有一些比如read操作甸祭，由于實(shí)際開(kāi)發(fā)并未涉及所以未列出缕碎。
補(bǔ)充一些基礎(chǔ)知識(shí)
1.微信BLE藍(lán)牙通信
2.低功耗藍(lán)牙協(xié)議解讀
3.JavaScript 之二進(jìn)制家族
4.BLE藍(lán)牙協(xié)議分析
