這個(gè)模塊做了2周,找了很多資料文檔,看示例看別人的demo,最后發(fā)現(xiàn)其實(shí)還是得靠自己,不吐槽了,開正文。我實(shí)現(xiàn)的小程序模塊自動(dòng)連接(根據(jù)需要,可改手動(dòng)),是在小程序初始化完成時(shí)開始自動(dòng)調(diào)用執(zhí)行。
大致流程:
1、 開啟藍(lán)牙適配
2、 獲取藍(lán)牙適配器狀態(tài),判斷設(shè)備藍(lán)牙是否可用。
3、 判斷藍(lán)牙適配器可用時(shí)開啟掃描藍(lán)牙設(shè)備和開啟獲取已連接的藍(lán)牙設(shè)備
4、 如果開啟掃描藍(lán)牙設(shè)備失敗5s后自動(dòng)再次開啟掃描
5、 開啟掃描藍(lán)牙設(shè)備成功后開啟監(jiān)聽已掃描的設(shè)備
6、 如果已掃描到的新設(shè)備含F(xiàn)eiZhi名(個(gè)人產(chǎn)品需要)的設(shè)備則開始連接該設(shè)備
7、 開啟獲取已連接藍(lán)牙設(shè)備開啟獲取設(shè)備成功后判斷以獲取的設(shè)備名包含F(xiàn)eiZhi(個(gè)人產(chǎn)品需要)字符串的設(shè)備則開始連接該設(shè)備
8、 開始獲取已連接藍(lán)牙設(shè)備沒有成功獲取到已連接的藍(lán)牙設(shè)備5s后自動(dòng)重新開啟獲取。
9、 開始連接某設(shè)備時(shí)停止掃描設(shè)備,停止循環(huán)獲取已連接設(shè)備。
10、連接成功后停止掃描設(shè)備,停止循環(huán)獲取已連接設(shè)備。
點(diǎn)擊查看:藍(lán)牙模塊連接流程圖
1、app.js的onLaunch() 方法里中調(diào)用開啟連接 this.startConnect();彈出提示框,開啟適配,如果失敗提示設(shè)備藍(lán)牙不可用,同時(shí)開啟藍(lán)牙適配器狀態(tài)監(jiān)聽。
startConnect: function () {
var that = this;
wx.showLoading({
title: '開啟藍(lán)牙適配'
});
wx.openBluetoothAdapter({
success: function (res) {
console.log("初始化藍(lán)牙適配器");
console.log(res);
that.getBluetoothAdapterState();
},
fail: function (err) {
console.log(err);
wx.showToast({
title: '藍(lán)牙初始化失敗',
icon: 'success',
duration: 2000
})
setTimeout(function () {
wx.hideToast()
}, 2000)
}
});
wx.onBluetoothAdapterStateChange(function (res) {
var available = res.available;
if (available) {
that.getBluetoothAdapterState();
}
})
}
2、初始化藍(lán)牙適配器成功,調(diào)用this.getBluetoothAdapterState() 獲取本機(jī)藍(lán)牙適配器狀態(tài),判斷是否可用,available為false則因?yàn)橛脩魶]有開啟系統(tǒng)藍(lán)牙。同時(shí)判斷程序還沒有開始搜索藍(lán)牙設(shè)備,調(diào)用this.startBluetoothDevicesDiscovery();開始掃描附近的藍(lán)牙設(shè)備,同時(shí)調(diào)用this.getConnectedBluetoothDevices() 開啟獲取本機(jī)已配對(duì)的藍(lán)牙設(shè)備。
startConnect: function () {
var that = this;
wx.showLoading({
title: '開啟藍(lán)牙適配'
});
wx.openBluetoothAdapter({
success: function (res) {
console.log("初始化藍(lán)牙適配器");
console.log(res);
that.getBluetoothAdapterState();
},
fail: function (err) {
console.log(err);
wx.showToast({
title: '藍(lán)牙初始化失敗',
icon: 'success',
duration: 2000
})
setTimeout(function () {
wx.hideToast()
}, 2000)
}
});
wx.onBluetoothAdapterStateChange(function (res) {
var available = res.available;
if (available) {
that.getBluetoothAdapterState();
}
})
}
3、開始搜索藍(lán)牙設(shè)備startBluetoothDevicesDiscovery() , 提示藍(lán)牙搜索。
startBluetoothDevicesDiscovery: function () {
var that = this;
wx.showLoading({
title: '藍(lán)牙搜索'
});
wx.startBluetoothDevicesDiscovery({
services: [],
allowDuplicatesKey: false,
success: function (res) {
if (!res.isDiscovering) {
that.getBluetoothAdapterState();
} else {
that.onBluetoothDeviceFound();
}
},
fail: function (err) {
console.log(err);
}
});
}
4、獲取已配對(duì)的藍(lán)牙設(shè)備。此方法特別說明參數(shù)services(Array)是必填的,但是官方示例中以及各種坑爹demo里從沒見過有誰填寫,但是不填寫這個(gè)屬性此方法無法獲取到任何已配對(duì)設(shè)備。如果要調(diào)用此方法則是需要連接特定設(shè)備,并且知道該設(shè)備的一個(gè)主服務(wù)serviceId。如果未知可以先手動(dòng)連接一次想要連接的設(shè)備,然后獲取service列表,記錄屬性primary為true的值至少一個(gè)。
getConnectedBluetoothDevices: function () {
var that = this;
wx.getConnectedBluetoothDevices({
services: [that.serviceId],
success: function (res) {
console.log("獲取處于連接狀態(tài)的設(shè)備", res);
var devices = res['devices'], flag = false, index = 0, conDevList = [];
devices.forEach(function (value, index, array) {
if (value['name'].indexOf('FeiZhi') != -1) {
// 如果存在包含F(xiàn)eiZhi字段的設(shè)備
flag = true;
index += 1;
conDevList.push(value['deviceId']);
that.deviceId = value['deviceId'];
return;
}
});
if (flag) {
this.connectDeviceIndex = 0;
that.loopConnect(conDevList);
} else {
if (!this.getConnectedTimer) {
that.getConnectedTimer = setTimeout(function () {
that.getConnectedBluetoothDevices();
}, 5000);
}
}
},
fail: function (err) {
if (!this.getConnectedTimer) {
that.getConnectedTimer = setTimeout(function () {
that.getConnectedBluetoothDevices();
}, 5000);
}
}
});
}
5、開啟藍(lán)牙搜索功能失敗,則回到第2步重新檢查藍(lán)牙是適配器是否可用,開啟藍(lán)牙搜索功能成功后開啟發(fā)現(xiàn)附近藍(lán)牙設(shè)備事件監(jiān)聽。this.onBluetoothDeviceFound()
onBluetoothDeviceFound: function () {
var that = this;
console.log('onBluetoothDeviceFound');
wx.onBluetoothDeviceFound(function (res) {
console.log('new device list has founded')
console.log(res);
if (res.devices[0]) {
var name = res.devices[0]['name'];
if (name != '') {
if (name.indexOf('FeiZhi') != -1) {
var deviceId = res.devices[0]['deviceId'];
that.deviceId = deviceId;
console.log(that.deviceId);
that.startConnectDevices();
}
}
}
})
}
此方法可自定義過濾一些無效的藍(lán)牙設(shè)備比如name為空的,個(gè)人產(chǎn)品開發(fā)中需要過濾devices name 不含有FeiZhi字符串的設(shè)備。
6、在第5步中發(fā)現(xiàn)了某個(gè)想配對(duì)的設(shè)備,則獲取到該設(shè)備的deviceId,然后開始配對(duì)該設(shè)備 this.startConnectDevices()。
startConnectDevices: function (ltype, array) {
var that = this;
clearTimeout(that.getConnectedTimer);
that.getConnectedTimer = null;
clearTimeout(that.discoveryDevicesTimer);
that.stopBluetoothDevicesDiscovery();
this.isConnectting = true;
wx.createBLEConnection({
deviceId: that.deviceId,
success: function (res) {
if (res.errCode == 0) {
setTimeout(function () {
that.getService(that.deviceId);
}, 5000)
}
},
fail: function (err) {
console.log('連接失敗:', err);
if (ltype == 'loop') {
that.connectDeviceIndex += 1;
that.loopConnect(array);
} else {
that.startBluetoothDevicesDiscovery();
that.getConnectedBluetoothDevices();
}
},
complete: function () {
console.log('complete connect devices');
this.isConnectting = false;
}
});
}
開啟連接后為了避免出現(xiàn)沖突,一旦開啟連接則終止掃描附近藍(lán)牙設(shè)備,終止讀取本機(jī)已配對(duì)設(shè)備。
7、連接成功后根據(jù)deiviceId獲取設(shè)備的所有服務(wù)。this.getService(deviceId);
getService: function (deviceId) {
var that = this;
// 監(jiān)聽藍(lán)牙連接
wx.onBLEConnectionStateChange(function (res) {
console.log(res);
});
// 獲取藍(lán)牙設(shè)備service值
wx.getBLEDeviceServices({
deviceId: deviceId,
success: function (res) {
that.getCharacter(deviceId, res.services);
}
})
}
8、讀取服務(wù)的特征值。
getCharacter: function (deviceId, services) {
var that = this;
services.forEach(function (value, index, array) {
if (value == that.serviceId) {
that.serviceId = array[index];
}
});
wx.getBLEDeviceCharacteristics({
deviceId: deviceId,
serviceId: that.serviceId,
success: function (res) {
that.writeBLECharacteristicValue(deviceId, that.serviceId, that.characterId_write);
that.openNotifyService(deviceId, that.serviceId, that.characterId_read);
},
fail: function (err) {
console.log(err);
},
complete: function () {
console.log('complete');
}
})
}
9、如果掃描到的設(shè)備中沒有想要連接的設(shè)備,可以嘗試使用系統(tǒng)藍(lán)牙手動(dòng)配對(duì),然后再小程序中調(diào)用getConnectedBluetoothDevices() 獲取本機(jī)已配對(duì)的藍(lán)牙設(shè)備,然后過濾設(shè)備(可能獲取多個(gè)已配對(duì)的藍(lán)牙設(shè)備)。將以獲取的藍(lán)牙設(shè)備deviceId放入到一個(gè)數(shù)組中調(diào)用自定義方法this.loopConnect(); 思路:通過遞歸調(diào)用獲取已配對(duì)藍(lán)牙設(shè)備的deviceId,如果獲取到了就去連接,devicesId[x] 為空說明上傳調(diào)用getConnectedBluetoothDevices()時(shí)獲取到的已配對(duì)設(shè)備全部連接失敗了。則開啟重新獲取已配對(duì)藍(lán)牙設(shè)備,并開啟掃描附近藍(lán)牙設(shè)備。
loopConnect: function (devicesId) {
var that = this;
var listLen = devicesId.length;
if (devicesId[this.connectDeviceIndex]) {
this.deviceId = devicesId[this.connectDeviceIndex];
this.startConnectDevices('loop', devicesId);
} else {
console.log('已配對(duì)的設(shè)備小程序藍(lán)牙連接失敗');
that.startBluetoothDevicesDiscovery();
that.getConnectedBluetoothDevices();
}
}
10、**startConnectDevices(’loop’, array)方法,是當(dāng)獲取已配對(duì)藍(lán)牙設(shè)備進(jìn)行連接時(shí)這樣調(diào)用。其中的處理邏輯上文已經(jīng)貼出,意思就是在連接失敗后fail方法里累加一個(gè)全局變量,然后回調(diào)loopConnect(array)方法。
11、手動(dòng)連接,上文介紹的方法是為了直接自動(dòng)連接,如果不需要自動(dòng)連接,可在使用方法getBluetoothDevices() 將會(huì)獲取到已掃描到的藍(lán)牙設(shè)備的列表,可以做個(gè)頁面顯示出設(shè)備名,點(diǎn)擊該設(shè)備開始連接。
注意:
1、that.serviceId 是在初始化時(shí)設(shè)置的,由于對(duì)需要連接設(shè)備的主服務(wù)serivceId和各種特征值都是已知的因此可以這樣做。如果不可知可以做一個(gè)掃描方法自己檢查特征值的用途。
2、 連接成功后的writeBLECharacteristicValue和openNotifyService操作需要注意,如果同時(shí)開啟這兩項(xiàng)操作要先調(diào)用wirte再開啟notify(原因未知,個(gè)人心得)。
3、經(jīng)人提醒還可以再完善一下在onBlueToothAdapterStateChange()**可以監(jiān)聽藍(lán)牙適配器狀態(tài),以此判斷連接過程中或連接后用戶開關(guān)了設(shè)備藍(lán)牙,如果判斷到關(guān)了藍(lán)牙提示請(qǐng)開啟,如果監(jiān)聽到開啟了,就重新回到第1步。
最后本文屬于個(gè)人開發(fā)者的一點(diǎn)總結(jié),歡迎留言指導(dǎo)討論,也可以加入小程序聯(lián)盟群(536592077)一起探討學(xué)習(xí)。