這個模塊做了2周鼓拧,找了很多資料文檔半火,看示例看別人的demo,最后發(fā)現(xiàn)其實還是得靠自己季俩,不吐槽了钮糖,開正文。我實現(xiàn)的小程序模塊自動連接(根據(jù)需要酌住,可改手動)店归,是在小程序初始化完成時開始自動調(diào)用執(zhí)行。
大致流程:
1酪我、 開啟藍(lán)牙適配
2消痛、 獲取藍(lán)牙適配器狀態(tài),判斷設(shè)備藍(lán)牙是否可用祭示。
3肄满、 判斷藍(lán)牙適配器可用時開啟掃描藍(lán)牙設(shè)備和開啟獲取已連接的藍(lán)牙設(shè)備
4、 如果開啟掃描藍(lán)牙設(shè)備失敗5s后自動再次開啟掃描
5质涛、 開啟掃描藍(lán)牙設(shè)備成功后開啟監(jiān)聽已掃描的設(shè)備
6稠歉、 如果已掃描到的新設(shè)備含F(xiàn)eiZhi名(個人產(chǎn)品需要)的設(shè)備則開始連接該設(shè)備
7、 開啟獲取已連接藍(lán)牙設(shè)備開啟獲取設(shè)備成功后判斷以獲取的設(shè)備名包含F(xiàn)eiZhi(個人產(chǎn)品需要)字符串的設(shè)備則開始連接該設(shè)備
8汇陆、 開始獲取已連接藍(lán)牙設(shè)備沒有成功獲取到已連接的藍(lán)牙設(shè)備5s后自動重新開啟獲取怒炸。
9、 開始連接某設(shè)備時停止掃描設(shè)備毡代,停止循環(huán)獲取已連接設(shè)備阅羹。
10、連接成功后停止掃描設(shè)備教寂,停止循環(huán)獲取已連接設(shè)備捏鱼。
點擊查看:藍(lán)牙模塊連接流程圖
1、app.js的onLaunch() 方法里中調(diào)用開啟連接 this.startConnect();彈出提示框酪耕,開啟適配导梆,如果失敗提示設(shè)備藍(lán)牙不可用,同時開啟藍(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則因為用戶沒有開啟系統(tǒng)藍(lán)牙躏结。同時判斷程序還沒有開始搜索藍(lán)牙設(shè)備,調(diào)用this.startBluetoothDevicesDiscovery();開始掃描附近的藍(lán)牙設(shè)備狰域,同時調(diào)用this.getConnectedBluetoothDevices() 開啟獲取本機(jī)已配對的藍(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禀挫、獲取已配對的藍(lán)牙設(shè)備旬陡。此方法特別說明參數(shù)services(Array)是必填的拓颓,但是官方示例中以及各種坑爹demo里從沒見過有誰填寫,但是不填寫這個屬性此方法無法獲取到任何已配對設(shè)備描孟。如果要調(diào)用此方法則是需要連接特定設(shè)備驶睦,并且知道該設(shè)備的一個主服務(wù)serviceId。如果未知可以先手動連接一次想要連接的設(shè)備匿醒,然后獲取service列表场航,記錄屬性primary為true的值至少一個。
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為空的孩饼,個人產(chǎn)品開發(fā)中需要過濾devices name 不含有FeiZhi字符串的設(shè)備。
6竹挡、在第5步中發(fā)現(xiàn)了某個想配對的設(shè)備镀娶,則獲取到該設(shè)備的deviceId,然后開始配對該設(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ī)已配對設(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)牙手動配對隙券,然后再小程序中調(diào)用getConnectedBluetoothDevices() 獲取本機(jī)已配對的藍(lán)牙設(shè)備,然后過濾設(shè)備(可能獲取多個已配對的藍(lán)牙設(shè)備)闹司。將以獲取的藍(lán)牙設(shè)備deviceId放入到一個數(shù)組中調(diào)用自定義方法this.loopConnect(); 思路:通過遞歸調(diào)用獲取已配對藍(lán)牙設(shè)備的deviceId娱仔,如果獲取到了就去連接,devicesId[x] 為空說明上傳調(diào)用getConnectedBluetoothDevices()時獲取到的已配對設(shè)備全部連接失敗了游桩。則開啟重新獲取已配對藍(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('已配對的設(shè)備小程序藍(lán)牙連接失敗');
that.startBluetoothDevicesDiscovery();
that.getConnectedBluetoothDevices();
}
}
10借卧、**startConnectDevices(’loop’, array)方法盹憎,是當(dāng)獲取已配對藍(lán)牙設(shè)備進(jìn)行連接時這樣調(diào)用。其中的處理邏輯上文已經(jīng)貼出铐刘,意思就是在連接失敗后fail方法里累加一個全局變量陪每,然后回調(diào)loopConnect(array)方法。
11镰吵、手動連接檩禾,上文介紹的方法是為了直接自動連接,如果不需要自動連接疤祭,可在使用方法getBluetoothDevices() 將會獲取到已掃描到的藍(lán)牙設(shè)備的列表盼产,可以做個頁面顯示出設(shè)備名,點擊該設(shè)備開始連接勺馆。
注意:
1戏售、that.serviceId 是在初始化時設(shè)置的,由于對需要連接設(shè)備的主服務(wù)serivceId和各種特征值都是已知的因此可以這樣做草穆。如果不可知可以做一個掃描方法自己檢查特征值的用途灌灾。
2、 連接成功后的writeBLECharacteristicValue和openNotifyService操作需要注意续挟,如果同時開啟這兩項操作要先調(diào)用wirte再開啟notify(原因未知紧卒,個人心得)。
3诗祸、經(jīng)人提醒還可以再完善一下在onBlueToothAdapterStateChange()**可以監(jiān)聽藍(lán)牙適配器狀態(tài)跑芳,以此判斷連接過程中或連接后用戶開關(guān)了設(shè)備藍(lán)牙,如果判斷到關(guān)了藍(lán)牙提示請開啟直颅,如果監(jiān)聽到開啟了博个,就重新回到第1步。
最后本文屬于個人開發(fā)者的一點總結(jié)功偿,歡迎留言指導(dǎo)討論盆佣,也可以加入小程序聯(lián)盟群(536592077)一起探討學(xué)習(xí)。