前言

连接蓝牙

开启蓝牙适配器

发现蓝牙

前言

原因是公司要搞个共享单车给内部员工使用，所以需要用手机连接锁蓝牙，然后扫码开锁。这个时候就要看看uni-app的蓝牙模块了。

uni-app的蓝牙模块看起来只支持低功耗蓝牙，即ble蓝牙。

然后公司就找了个厂商，这个厂商就给了我一份文档，如下图所示，

这份文档呢有一些指令，指令如下图，可以看到这些指令呢都是一些16进制的数据，即发送给蓝牙的数据为，0xfe 0x66 0x00 0x21 0x00 （app->车锁的模块）

最后的CRC是将前面的数据加密。

最后车锁会返回给APP数据，即车锁->app模块。

厂家的蓝牙锁就是市面上常见的，如下图，有一个二维码，扫一下二维码开锁就是需要实现的逻辑。

连接蓝牙

首先需要开启蓝牙适配器，发现蓝牙，然后连接蓝牙。

对应模块分别为，

开启蓝牙适配器

发现蓝牙

当startBluetoothDevicesDiscovery调用后，搜索到的蓝牙就会在onBluetoothDeviceFound中被搜索到，

devices返回的数据如下，而本次的目标就是name:BleLock。

{
"devices": [
{
"deviceId": "2A:40:6F:28:24:90",
"name": "",
"RSSI": -53,
"localName": "",
           .......
}
]
}

{
"devices": [
{
"deviceId": "32:71:0D:BF:43:FA",
"name": "",
"RSSI": -57,
"localName": "",
           .......
}
]
}

{
"devices": [
{
"deviceId": "ED:C0:93:EF:0D:C5",
"name": "BleLock",
"RSSI": -45,
           .......
}
]
}

连接蓝牙

与上面方法对应的还有，停止搜索，关闭蓝牙连接，关闭蓝牙适配器，在Uni-app的API中蓝牙栏目都有对应方法。

当发现到目标蓝牙后，一般就调用停止搜索方法，连接上蓝牙完成任务后就关闭蓝牙连接，关闭蓝牙适配器。

即调用顺序为：打开蓝牙适配器--> 监听搜索--> 开始搜索--> (发现目标蓝牙后) 关闭搜索-->

连接蓝牙--> 发送蓝牙指令 --> 断开蓝牙--> 关闭蓝牙适配器。

当然，打开蓝牙适配器只需要在onLoad中执行即可，不需要多次执行，但在我实际操作中，我发现有时候打开蓝牙适配器成功后，依旧无法连接蓝牙。

所以我每次在扫码时都是按照上述顺序来操作一遍，扫一次码走一遍流程，大不了失败后多扫码几次。

收发蓝牙数据

当连接上蓝牙后，需要收发蓝牙数据，收发蓝牙数据需要先获取服务ID，再获取特征值，即下图中的serviceId和characteristicId。

获取服务ID

调用此方法后，发现会输出如下数据，此处的uuid就是serviceId

[
{
"uuid": "00001800-0000-1000-8000-00805F9B34FB",
"isPrimary": true
},
{
"uuid": "00001801-0000-1000-8000-00805F9B34FB",
"isPrimary": true
},
{
"uuid": "6E400001-E6AC-A7E7-B1B3-E699BAE8D000",
"isPrimary": true
}
]

此时需要循环遍历每个serviceId获取到特征值，但是在厂商中只有6e4开头获取到的特征值才能操作蓝牙，所以就只需要提取此处6e4开头的serviceId即可。

获取特征值

下面的uuid就是特征值，其实都写数据只需要write:true和notify:true的特征值即可。

read:true表示支持读取蓝牙数据，

write:true表示支持向蓝牙写数据，

notify:true 表示支持监听蓝牙返回的数据，

[
{
"uuid": "6E400003-E6AC-A7E7-B1B3-E699BAE8D000",
"properties": {
"read": false,
"write": false,
"notify": true,
"indicate": false
}
},
{
"uuid": "6E400002-E6AC-A7E7-B1B3-E699BAE8D000",
"properties": {
"read": false,
"write": true,
"notify": false,
"indicate": false
}
}
]

读取蓝牙数据

一般是在连接蓝牙成功后就需要调用如下方法，在notify方法成功后就需要调用onBLECharacteristicValueChange方法，监听返回。

uni.notifyBLECharacteristicValueChange({
	state: true, // 启用 notify 功能
	// 这里的 deviceId 需要已经通过 createBLEConnection 与对应设备建立链接
	deviceId: ths.deviceInfo.deviceId,
	// 这里的 serviceId 需要在 getBLEDeviceServices 接口中获取
	serviceId: serviceId,
	// 这里的 characteristicId 需要在 getBLEDeviceCharacteristics 接口中获取
	characteristicId: characteristicId,
	success(res) {
		// 必须在这里的回调才能获取
		uni.onBLECharacteristicValueChange(function(res) {
			var receiveValue = ths.ab2hex(res.value) //2进制数据转为16进制字符串
			console.log("蓝牙返回数据为："+receiveValue)
			
		})

		//获取key  此处一定要延迟，要等Notify成功后才能发送
		setTimeout(function(){
			ths.unlock();//开锁
		},2000);

	},
	fail(res) {
		console.log(res)
		ths.startNotify = false;
	},
})

// ArrayBuffer转16进度字符串示例
function ab2hex(buffer) {
  const hexArr = Array.prototype.map.call(
    new Uint8Array(buffer),
    function (bit) {
      return ('00' + bit.toString(16)).slice(-2)
    }
  )
  return hexArr.join('')
}

蓝牙返回的数据是二进制的，是无法打印出来，所以需要转换为字符串。

写蓝牙数据

向蓝牙写入的是二进制数据，所以需要转为二进制，

根据厂商文档需要开锁，那么需要写入 0xfe 0x66 0x00 0x21 0x00

// 向蓝牙设备发送一个0x00的16进制数据
const buffer = new ArrayBuffer(6)
const dataView = new DataView(buffer)
dataView.setUint8(0,0xFE);//STX
dataView.setUint8(1,0x66);//NUM
dataView.setUint8(2,0x00);//通信秘钥 Key
dataView.setUint8(3,0x21);//CMd
dataView.setUint8(4,0x00);//LEN

dataView.setUint8(5,0xB4);//CRC
dataView.setUint8(6,0xF6);

uni.writeBLECharacteristicValue({
	// 这里的 deviceId 需要在 getBluetoothDevices 或 onBluetoothDeviceFound 接口中获取
	deviceId:deviceIdValue,
	// 这里的 serviceId 需要在 getBLEDeviceServices 接口中获取
	serviceId:serviceIdValue,
	// 这里的 characteristicId 需要在 getBLEDeviceCharacteristics 接口中获取
	characteristicId:characteristicIdValue,
	// 这里的value是ArrayBuffer类型
	value: buffer,
	success(res) {
	  console.log('writeBLECharacteristicValue success', res)
	},
	fail(res) {
		console.log(res)
	},
})

注意此处的success返回，只是告诉你蓝牙写成功否，并不是蓝牙的返回数据，蓝牙的返回数据在 onBLECharacteristicValueChange 中。

此时到这里应该是能操作蓝牙了，但是uni-app中还遇到一些坑。

遇到的坑

获取serviceId的坑

刚连接蓝牙成功时就调用getBLEDeviceServices获取，结果一直报蓝牙未连接，解决的方式是加个setTimeout，如果延迟后还获取不到serviceId，那么用户就重新扫码吧。

connectBle() {
	var ths = this; 
	uni.createBLEConnection({
		// 这里的 deviceId 需要已经通过 createBLEConnection 与对应设备建立链接
		deviceId:ths.deviceInfo.deviceId,
		success(res) {
			//此处也需要延迟，刚连接上时，无法获取到特征值
			setTimeout(function(){
				ths.getServices();
			},2000)
		},
		fail(res) {
			ths.showModalInfo("连接蓝牙失败");
		},
		complete(res) { //无论有没有连上蓝牙，都要停止搜索
			ths.stopFindBluetooth(); //停止搜索蓝牙
		}
	})
},

特征值不支持读写

可以看到获取到了如下特征值，有write:true的（00002A00-0000-1000-8000-00805F9B34FB），但是用这个特征值写数据，你会发现就是写不了，会报特征值不支持写入。

原因是厂商设置了只支持6e4开头的特征值，麻蛋的，当时我以为是uni-app获取特征值数据错了呢！

[
{
"uuid": "00002A00-0000-1000-8000-00805F9B34FB",
"properties": {
"read": true,
"write": true,
"notify": false,
"indicate": false
}
},
{
"uuid": "00002A01-0000-1000-8000-00805F9B34FB",
"properties": {
"read": true,
"write": false,
"notify": false,
"indicate": false
}
},
{
"uuid": "00002A04-0000-1000-8000-00805F9B34FB",
"properties": {
"read": true,
"write": false,
"notify": false,
"indicate": false
}
}
]

notify成功后立刻写蓝牙数据

如下图可以看到，在notify成功后，我当时是立刻调用解锁方法，结果一直没有蓝牙数据返回，甚至写数据还报特征值不支持写入，no connection等，

这个鬼原因我也不知道，后面加个延迟解决了，推测应该是success调用应该不是真正的成功，需要等一会，

但不得不说，这个延迟就是定时炸弹，谁也不知道需要延迟多久。

可以看到在连接蓝牙成功后获取serviceId，Notify后发送指令都是需要延迟，明明给出success了，结果还是无法去调用。

针对这个问题，去看了官网，好像也没啥回应，大部分人也是延迟一下。

工具方法

/**
 * 将一个比如abcd的字符串转为16进制数据
 * @param {Object} str
 */
function stringToHex(str) {
	var hexArray = [];
	for (var i = 0; i < str.length; i++) {
		var hexStr = str.charCodeAt(i).toString(16);
		hexArray.push(str16(hexStr));
	}
	return hexArray;
}

var str = "yOTmK50z"
var dataArray = stringToHex("yOTmK50z"); //返回16进制的数组 0x79, 0x4f, 0x54, 0x6d, 0x4b, 0x35, 0x30,0x7a


/**
 * 将字符串变为16进制数据
 * @param {Object} str  16进制的字符串样式，不能是随便的字符串
 */
function str16(str) {
	return parseInt(str, 16);
}

var hexStr = "0c"; //对应16进制，对应10进制12
var num = str16(str);//返回12，也可以是0x0c，两者一样


/**
 * 将一个十进制的数变为十六进制的字符串
 * @param {Object} value
 */
function int2HexStr(value) {
	return value.toString(16);
}

var num = 12;
var hexStr = int2HexStr(num) //返回 0c


/**
 * 字符串分割为数组，2位一个
 * @param {Object} str
 */
function str2intArray(str) {
	var length = str.length / 2;
	var data = [];
	for (var i = 0; i < length; i++) {
		data[i] = str16(str.substring(i * 2, (i + 1) * 2));
	}
	return data;
}

//0x79, 0x4f, 0x54, 0x6d, 0x4b, 0x35, 0x30,0x7a
var hexStr = "794f546d4b35307a"
var dataArray = str2intArray(hexStr) //变为一个数组，里面保存16进制的数



/**
 * 时间戳变为  yyyy-MM-dd HH:mm:ss格式的时间
 * @param {Object} timestamp
 */
function timestamp2YYYYMMDDHHmmSS(timestamp){
  var n=new Date(timestamp)
  return n.toLocaleDateString().replace(/\//g, "-") + " " + n.toTimeString().substr(0, 8)
}


//获取时间戳
var timestampNum = Math.round(new Date() / 1000)  // 返回秒级别的时间戳，1673248864
var hexStr = int2HexStr(timestampNum); // 1673248864 转换为16进制  63bbc060
var timestamp16Array = str2intArray(hexStr); // 将 63bbc060 变为 0x63 0xbb 0xc0 0x60的数组

//产生随机数
Math.round(Math.random() * 100); //[0,100)

uni-app使用蓝牙

前言

连接蓝牙

开启蓝牙适配器

发现蓝牙

连接蓝牙

收发蓝牙数据

获取服务ID

获取特征值

读取蓝牙数据

写蓝牙数据

遇到的坑

获取serviceId的坑

特征值不支持读写

notify成功后立刻写蓝牙数据

工具方法

猜你喜欢