uni-app低功耗蓝牙在Android上的使用

原创 已于 2024-06-12 11:23:54 修改 · 1.5k 阅读 · 31 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#uni-app #前端 #android #javascript

于 2024-06-03 17:24:34 首次发布

uni-app低功耗蓝牙在Android上的使用

主要使用uniapp提供的低功耗蓝牙API进行hooks封装。
在使用时，注意Android版本必须5.1以上。

一.主要API初步封装（bluetooth.js）

1.1 初始化蓝牙模块（uni.openBluetoothAdapter(OBJECT)）

该接口是使用低功耗蓝牙相关API必须调用的一个接口，若未先调用此接口，将会返回代码为10000的报错；

// 初始化蓝牙模块
export function initBluetooth() {
	return new Promise((resolve, reject) => {
		uni.openBluetoothAdapter({
			success(res) {
				console.log('初始化蓝牙成功', res);
				resolve(res)
			},
			fail(err) {
				console.log('初始化蓝牙失败', err);
				reject(err)
			}
		});
	});
}

注意：
在用户蓝牙开关未开启或者手机不支持蓝牙功能的情况下，调用此接口会返回代码10001的错误，表示手机蓝牙功能不可用。

1.2 获取蓝牙适配器状态（uni.getBluetoothAdapterState(OBJECT)）

// 获取蓝牙模块状态
export function getBluetoothAdapterState() {
	return new Promise((resolve, reject) => {
		uni.getBluetoothAdapterState({
			success: (res) => {
				console.log('获取本机蓝牙适配器状态', res);
				resolve(res)
			},
			fail(err) {
				console.log('获取本机蓝牙适配器状态', err);
				reject(err)
			}
		})
	});
}

返回数据

属性类型说明
discoveringboolean是否正在搜索设备
availableboolean蓝牙适配器是否可用

1.3 关闭蓝牙模块（uni.closeBluetoothAdapter(OBJECT)）

调用该方法将断开所有已建立的连接并释放系统资源。建议在使用蓝牙流程后，与 uni.openBluetoothAdapter 成对调用。

// 关闭蓝牙模块
export function closeBluetooth() {
	return new Promise((resolve, reject) => {
		uni.closeBluetoothAdapter({
			success(res) {
				console.log('关闭蓝牙成功', res);
				resolve(res)
			},
			fail(err) {
				console.log('关闭蓝牙失败', err);
				reject(err)
			}
		})
	})
}

1.4 开启搜索蓝牙设备（uni.startBluetoothDevicesDiscovery(OBJECT)）

开始搜寻附近的蓝牙外围设备。此操作比较耗费系统资源，请在搜索并连接到设备后调用 uni.stopBluetoothDevicesDiscovery 方法停止搜索。

/**
 * 启动蓝牙设备搜索
 * @param {Object} params 参数
 */
export function startBluetoothSearch(params) {
	return new Promise((resolve, reject) => {
		uni.startBluetoothDevicesDiscovery({
			...params,
			success: (res) => {
				console.log('开启蓝牙搜索成功', res);
				resolve(res);
			},
			fail: (err) => {
				console.log('开启蓝牙搜索失败', err);
				reject(err);
			}
		})
	});
}

传入参数params说明（全都非必填）

属性类型默认值说明
servicesArray<String>要搜索的蓝牙设备主 service 的 uuid 列表。某些蓝牙设备会广播自己的主 service 的 uuid。如果设置此参数，则只搜索广播包有对应 uuid 的主服务的蓝牙设备。建议主要通过该参数过滤掉周边不需要处理的其他蓝牙设备。
allowDuplicatesKeybooleanfalse是否允许重复上报同一设备。如果允许重复上报，则 uni.onBlueToothDeviceFound 方法会多次上报同一设备，但是 RSSI 值会有不同。
intervalnumber0上报设备的间隔。0 表示找到新设备立即上报，其他数值根据传入的间隔上报。
powerLevelstringmedium扫描模式，越高扫描越快，也越耗电，仅安卓支持。low：低，medium：中，high：高。仅京东小程序支持

注意
App 端目前仅支持发现ble蓝牙设备

1.5 关闭搜索蓝牙设备（uni.stopBluetoothDevicesDiscovery(OBJECT)）

停止搜寻附近的蓝牙外围设备。已经找到需要的蓝牙设备并不需要继续搜索时，调用该接口停止蓝牙搜索。

// 关闭蓝牙设备搜素
export function closeBluetoothSearch() {
	return new Promise((resolve, reject) => {
		uni.stopBluetoothDevicesDiscovery({
			success: (res) => {
				console.log('关闭蓝牙搜索成功', res);
				resolve(res);
			},
			fail: (err) => {
				console.log('关闭蓝牙搜索失败', err);
				reject(err);
			}
		});
	});
}

1.6 连接低功耗蓝牙设备（uni.createBLEConnection(OBJECT)）

/**
 * 连接 BLE 设备
 * @param {String} deviceId 设备ID
 */
export function connectBleById(deviceId, timeout = 10000) {
	return new Promise((resolve, reject) => {
		uni.createBLEConnection({
			deviceId,
			timeout,
			success(res) {
				console.log('连接成功', res);
				resolve(res);
			},
			fail(err) {
				console.log('连接失败', err);
				resolve(err)
			}
		})
	})
}

传入参数params说明（除deviceId必填外，为非必填，且默认值为空）

属性类型说明
timeoutnumber超时时间，单位ms，不填表示不会超时，京东小程序不支持

注意

  • 若APP在之前已有搜索过某个蓝牙设备，并成功建立连接，可直接传入之前搜索获取的 deviceId 直接尝试连接该设备，无需进行搜索操作。
  • 请保证尽量成对的调用 createBLEConnection 和 closeBLEConnection 接口。安卓如果多次调用 createBLEConnection 创建连接，有可能导致系统持有同一设备多个连接的实例，导致调用 closeBLEConnection 的时候并不能真正的断开与设备的连接。
  • 蓝牙连接随时可能断开，建议监听 uni.onBLEConnectionStateChange 回调事件，当蓝牙设备断开时按需执行重连操作。
  • 若对未连接的设备或已断开连接的设备调用数据读写操作的接口，会返回 10006 错误，建议进行重连操作。

1.7 断开低功耗设备蓝牙（uni.closeBLEConnection(OBJECT)）

/**
 * 断开连接 BLE 设备
 * @param {String} deviceId 设备ID
 */
export function closeConnectBleById(deviceId) {
	return new Promise((resolve, reject) => {
		uni.closeBLEConnection({
			deviceId,
			success(res) {
				console.log('断开连接成功', res);
				resolve(res)
			},
			fail(err) {
				console.error('断开连接失败', err)
				reject(err)
			}
		})
	})
}

1.8 设置蓝牙最大传输单元（uni.setBLEMTU(OBJECT)）

/**
 * 设置蓝牙最大传输单元
 * 
 * @param {String} deviceId 设备ID
 * @param {Number} mtu 最大传输单元(22,512) 区间内，单位 bytes
 */
export function setBLEMTU(deviceId, mtu) {
	return new Promise((resolve, reject) => {
		uni.setBLEMTU({
			deviceId,
			mtu,
			success(res) {
				console.log('设置MTU成功', res);
				resolve(res);
			},
			fail(err) {
				console.log('设置MTU失败', err);
				reject(err)
			}
		})
	})
}

传入参数说明

属性类型说明
deviceIdstring用于区分设备的 id
mtunumber最大传输单元(22,512) 区间内，单位 bytes

注意

  • 该接口必须在 uni.createBLEConnection()调用成功后调用。
  • mtu 设置范围是 (22,512)，具体参数应由设备端进行确认。

1.9 获取蓝牙设备服务（uni.getBLEDeviceServices(OBJECT)）

/**
 * 获取服务
 * @param {String} deviceId 设备地址
 */
export function getServices(deviceId) {
	return new Promise((resolve, reject) => {
		uni.getBLEDeviceServices({
			deviceId,
			success(res) {
				console.log('获取服务成功', res)
				resolve(res)
			},
			fail(err) {
				console.error('获取服务失败', err)
				reject(err)
			}
		})
	})
}

返回结果res.services说明

属性类型说明
uuidstring蓝牙设备服务的 uuid
isPrimaryboolean该服务是否为主服务

注意
要想使用读、写、监听等操作，必须先按序获取相应的特征值与服务值，否则无法正常进行相关操作。

1.10 获取特征值（uni.getBLEDeviceCharacteristics(OBJECT)）

特征值属于服务值的一种子集，因此获取特征值前必须要先获得服务值。

/**
 * 获取特征值
 * @param {String} deviceId 设备地址
 * @param {String} serviceId 服务ID
 */
export function getBLEDeviceCharacteristics(deviceId, serviceId) {
	return new Promise((resolve, reject) => {
		uni.getBLEDeviceCharacteristics({
			deviceId,
			serviceId,
			success(res) {
				console.log('获取特征值成功', res)
				resolve(res)
			},
			fail(err) {
				console.error('获取特征值失败', err)
				reject(err)
			}
		})
	})
}

传入参数说明
传入的两个参数均必填

属性类型说明
deviceIdstring蓝牙设备id（设备地址）
serviceIdstring蓝牙服务UUID

返回参数res.characteristics 结构

属性类型说明
uuidstring蓝牙设备特征值的 UUID
propertiesObject该特征值支持的操作类型

参数properties结构

属性类型说明
readboolean该特征值是否支持 read 操作
writeboolean该特征值是否支持 write操作
notifyboolean该特征值是否支持 notify操作（监听）
indicateboolean该特征值是否支持 indicate 操作

1.11 向低功耗蓝牙设备写入数据（uni.writeBLECharacteristicValue(OBJECT)）

在使用这个接口前，设备的特征值必须支持 write，且要获取成功， 才可以成功调用该接口。

/**
 * 向低功耗蓝牙设备特征值中写入二进制数据
 * @param {Object} deviceId 设备地址 serviceId 服务ID characteristicId 特征ID
 * @param {ArrayBuffer} value 蓝牙设备特征值对应的二进制值
 */
export function writeBLECharacteristicValue({
	deviceId,
	serviceId,
	characteristicId
}, value) {
	return new Promise((resolve) => {
		uni.writeBLECharacteristicValue({
			deviceId,
			serviceId,
			characteristicId,
			value,
			success(res) {
				console.log('写入二进制数据成功', res)
				resolve(res)
			},
			fail(err) {
				console.error('写入二进制数据失败', err)
				resolve(err)
			}
		})
	});
}

传入参数说明

属性类型说明
deviceIdstring蓝牙设备 id
serviceIdstring蓝牙特征值对应服务的 UUID
characteristicIdstring蓝牙特征值的 UUID
valueArrayBuffer蓝牙设备特征值对应的二进制值

1.12读取蓝牙设备的二进制数据值（uni.readBLECharacteristicValue(OBJECT)）

该接口不太常用，若需使用，则设备的特征值必须要支持read。

/**
 * 读取低功耗蓝牙设备的特征值的二进制数据值
 * 
 * @param {Object} deviceId 设备地址 serviceId 服务ID characteristicId 特征ID
 */
export function readBLECharacteristicValue({
	deviceId,
	serviceId,
	characteristicId
}) {
	return new Promise((resolve, reject) => {
		uni.readBLECharacteristicValue({
			deviceId,
			serviceId,
			characteristicId,
			success(res) {
				console.log('读取二进制数据成功', res)
				resolve(res)
			},
			fail(err) {
				console.error('读取二进制数据失败', err)
				reject(err)
			}
		})
	});
}

传入参数说明
同1.11读取数据的传入参数。

1.13 开启蓝牙设备发出的数据的监听功能（uni.notifyBLECharacteristicValueChange(OBJECT)）

uniapp官方 称为：启用低功耗蓝牙设备特征值变化时的 notify 功能。
注意

  • 须设备的特征值支持 notify 或者 indicate 才可以成功调用。
  • 须先启用 notifyBLECharacteristicValueChange 才能监听到设备 characteristicValueChange 事件。
  • 订阅操作成功后需要设备主动更新特征值的 value，才会触发 uni.onBLECharacteristicValueChange 回调。
  • 安卓平台上，在调用 notifyBLECharacteristicValueChange 成功后，立即调用writeBLECharacteristicValue 接口，在部分机型上会发生 10008 系统错误。
/**
 * 启用低功耗蓝牙设备特征值变化时的 notify 功能，订阅特征值。
 * 
 * @param {Object} deviceId 设备地址 serviceId 服务ID characteristicId 特征ID
 */
export function notifyBLECharacteristicValueChange({
	deviceId,
	serviceId,
	characteristicId
}) {
	return new Promise((resolve, reject) => {
		uni.notifyBLECharacteristicValueChange({
			deviceId,
			serviceId,
			characteristicId,
			state: true,
			success(res) {
				console.log('订阅特征值成功', res)
				resolve(res)
			},
			fail(err) {
				console.error('订阅特征值失败', err)
				reject(err)
			}
		})
	});
}

传入参数说明
同1.11读取数据的传入参数，其中state为是否启用notify，默认设置为true，设置为false没任何效果（初步判断是官方缺陷）。

1.14 监听数据返回（uni.onBLECharacteristicValueChange()）

使用该接口前，必须先调用1.13中的uni.notifyBLECharacteristicValueChange()接口，否则接收不到相关数据。

// 特征值变化监听
	const listenCharacteristicValueChange = () => {
		console.log('开始监听');
		openlListen.value = true
		uni.onBLECharacteristicValueChange(res => {
			const value = Ab2Hex(res.value);
			console.log("监听结果：", res, value);
			uni.$emit('updateMCU', value);

		}).catch(err => {
			openlListen.value = false
		});

注意

  • uniapp官方在处理该接口时存在问题，无对应的关闭监听操作，如果启动多个监听操作会导致数据污染以及无法判断所需要的数据。因此，全局范围内容只能够启动一个监听操作，无蓝牙相关操作时建议直接关闭蓝牙适配器。
  • 建议使用uni.$emit()方法抛出相关返回数据，在所需页面中再使用，uni.$once()或uni.$on()对相关数据进行接收，且接收后及时使用uni.$off()关闭。

返回数据说明

属性类型说明
deviceIdstring蓝牙设备 id
serviceIdstring蓝牙特征值对应服务的 UUID
characteristicIdstring蓝牙特征值的 UUID
valueArrayBuffer特征值最新的值

1.15 报错代码清单

错误码错误信息说明
0ok正常
10000not init未初始化蓝牙适配器
10001not available当前蓝牙适配器不可用
10002no device没有找到指定设备
10003connection fail连接失败
10004no service没有找到指定服务
10005no characteristic没有找到指定特征值
10006no connection当前连接已断开
10007property not support当前特征值不支持此操作
10008system error其余所有系统上报的异常
10009system not supportAndroid 系统特有，系统版本低于 4.3 不支持 BLE
10010already connect已连接
10011need pin配对设备需要配对码
10012operate time out连接超时
10013invalid_data连接 deviceId 为空或者是格式不正确

二、封装hooks主要方法（index.js）

对低功耗蓝牙API进行封装后，再封装一个hooks对相关逻辑进行处理，在hooks中需要设计部分业务需要的方法，大致如下：

方法名参数说明
openBluetooth——开启蓝牙
searchBluetooth——开始搜索蓝牙设备，需结合 listenBluetoothFound 方法监听搜索蓝牙
getBluetoothStatus——获取蓝牙状态，返回 { available: Boolean, discovering: Boolean }, available 表示蓝牙是否可用，discovering 表示是否启用蓝牙搜索
listenBluetoothFound——监听搜索蓝牙
stopBluetooth——停止搜索
listenConnectStatus——监听蓝牙连接状态
listenCharacteristicValueChange——监听蓝牙特征值变化
notifyCharacteristicValueChangeasync ( { deviceId, serviceId, characteristicId }), 第一个参数包含设备ID, 服务ID, 特征值ID订阅蓝牙特征值变化
connectBluetoothasync (id, mtu), id 为蓝牙设备ID, mtu 为蓝牙写入的字节大小连接蓝牙，连接成功后延时 1s 后调用 getServicesInfo 方法
closeBluetoothConnectionasync (id), id 为蓝牙设备ID关闭连接蓝牙
getServicesInfoasync (id), id 为蓝牙设备ID获取服务值和对应的特征值数据
writeBluetoothasync ( { deviceId, serviceId, characteristicId }, value, type = "Json"), 第一个参数包含设备ID, 服务ID, 特征值ID, 第二个参数为写入的值，第三个参数为数据类型，可选值为 ['Hex', 'Json']写入蓝牙数据
readBluetoothasync ( { deviceId, serviceId, characteristicId }), 第一个参数包含设备ID, 服务ID, 特征值ID读取蓝牙数据
closeBluetooth——关闭蓝牙功能

主模块设计为：

export function useBluetooth() {
...
return {
	...
	}
}

下面罗列部分重点方法。

代码块约定：

  • 主模块之外的参数另起一个代码块置前。
  • 默认引入一章节中的所有API。

2.1 搜索低功耗蓝牙设备

// 定时搜索
const searchInterval = ref();
// 设备连接状态
export const isConnected = ref(false);
// 设备蓝牙数据
export const devicesData = ref([]);
// 当前蓝牙项
export const conectedDevice = ref({});
// 定时搜索时长
const searchDurationTime = 5000;

蓝牙搜索前，需要开启搜索设备监听

// 蓝牙监听
	const listenBluetoothFound = () => {
		uni.onBluetoothDeviceFound(
			res => {
				res.devices.forEach(v => {
					const _device = devicesData.value.find(item => item.deviceId === v.deviceId);
					// 设备名称不为空
					if (!_device && v.name !== '') {
						devicesData.value.push({
							...v,
							connected: false
						});
						devicesData.value = _.orderBy(devicesData.value, ['RSSI'], ['desc']);
						console.log("devicesData.value", devicesData.value);
					}
				});
			}
		);
	}

蓝牙搜索时，逻辑上需要先检查相关的适配器是否已开启，另需附加一个定时器处理进行重试操作。

	// 蓝牙搜索
	const searchBluetooth = async () => {
		try {
			// 清除计时器
			if (searchInterval.value) clearInterval(searchInterval.value);
			// 获取蓝牙状态
			const _status = await getBluetoothStatus();
			// 蓝牙适配器是否可用
			if (_status.available) {
				// 是否正在搜索中
				if (_status.discovering) return;

				// 开启蓝牙监听时加入已连接设备
				if (isConnected.value && devicesData.value.length === 0) {
					devicesData.value.push(conectedDevice.value);
				}
				// 开始搜索蓝牙设备
				await startBluetoothSearch();
			} else {
				// 初始化蓝牙
				await initBluetooth();
				// 搜索蓝牙
				searchBluetooth();
			}
		} catch (err) {
			// 清除计时器
			if (searchInterval.value) clearInterval(searchInterval.value);
			// 开启定时器
			searchInterval.value = setInterval(() => {
				searchBluetooth();
			}, searchDurationTime);
		}
	}

2.2 处理搜索到的低功耗蓝牙设备数据

设置全局的蓝牙设备列表、连接设备id（mac地址）、搜索设备值

import {
	computed
} from 'vue';
// 设备蓝牙数据
export const devicesData = ref([]);
// 设备搜索值
export const searchValue = ref('');
// 设备 ID
export const deviceId = ref('');

搜索设备方法，使用了computed属性监听连接设备的id（mac地址）变化，触发相应的列表处理。

	// 检索的设备数据
	const filterDevicesData = computed(() => {
		// 获取连接过的设备数据
		const connectedDevices = getConnectedDevices();
		// 监测连接状态
		!!deviceId.value;
		// 监听连接状态
		connectedDevices.map(item => {
			item.connected = item.deviceId === deviceId.value;
		});
		const connectedDeviceIds = connectedDevices.map(item => item.deviceId);
		// 移除显示的已连接设备数据
		const _filterConnectedDevices = devicesData.value.filter(item => !connectedDeviceIds.includes(item
			.deviceId));
		return _filterConnectedDevices.filter(item => item.name && item.name.includes(searchValue.value));
	});
	
	// 获取已连接的数据
	const getConnectedDevices = (len = 3) => {
		const _connectedStorage = uni.getStorageSync('connectedDevices') || '[]';
		const _connectedDevices = JSON.parse(_connectedStorage);
		return _connectedDevices.slice(0, len);
	}

2.3 连接蓝牙

连接蓝牙时，需要注意是否存在已连接设备，若存在则需要先断开已连接设备再连接新设备，否则会造成功能异常。

	// 连接蓝牙设备
	const connectBluetooth = async (id, mtu) => {
		try {
			// 监测是否存在上次连接设备
			if (deviceId.value ) {
				try {
					// 确认后打开蓝牙
					const isConfirm = await toggleDeviceModal();
					if (isConfirm) {
						// 断开蓝牙连接
						uni.showLoading({
							title: '处理中',
							mask: true
						});
						// 关闭断开成功连接提示，防止影响 uni.showLoading 失效
						isTipForDisconnected.value = false;
						const res = await closeConnectBleById(deviceId.value);
						uni.hideLoading();
					} else {
						console.log("取消断开")
						return;
					}
				} catch (err) {
					errorCodeTip(err.code);
					return;
				}
			}
			// 连接设备
			uni.showLoading({
				title: '连接设备中',
				mask: true
			});
			const res = await connectBleById(id);
			// 设备状态改变
			devicesData.value.forEach(item => {
				if (item.deviceId === id) {
					// 当前连接设备数据
					deviceId.value = id;
					conectedDevice.value = item;
				}
			});
			uni.hideLoading();
			// 设置蓝牙最大传输单元
			await setBLEMTU(id, mtu);
			// 订阅特征值变化并建立监听
			notifyBLEChangeTime.value = 0
			notifyBluetoothcharacteristicChange();
			return res
		} catch (err) {
			errorCodeTip(err.code);
		}
	}
	// 切换设备弹窗
	const toggleDeviceModal = () => {
		return new Promise((resolve, reject) => {
			uni.showModal({
				title: "提示",
				content:"已存在蓝牙连接，是否进行切换蓝牙设备?",
				confirmText:"确定",
				cancelText: "取消",
				success: (res) => {
					if (res.confirm) {
						resolve(true);
					}
					if (res.cancel) {
						resolve(false);
					}
				},
				fail: (err) => {
					reject(err);
				}
			});
		});
	}
	
	// 订阅特征值变化，并建立监听，失败重连
	const notifyBluetoothcharacteristicChange = async () => {
		// 订阅消息
		let notify = await notifyCharacteristicValueChange({
			deviceId: deviceId.value,
			serviceId: serviceUuid.value,
			characteristicId: readUuid.value
		});
		
		notifyBLEChangeTime.value++
		if (notify.errMsg == "notifyBLECharacteristicValueChange:ok") {
			notifyBLEStatus.value = true;
			// 监听消息
			if (!openlListen.value) {
					uni.hideLoading();
					uni.showToast({
						icon: 'none',
						title: '成功获取特征值',
						duration: 2000
					});
				listenCharacteristicValueChange();
			}
		} else {
			if (notifyBLEChangeTime.value > 50) {
				uni.hideLoading();
				uni.showToast({
					icon: 'none',
					title: t("bluetooth.notifyCharateristicFail"),
					duration: 2000
				});
				return false
			}
			setTimeout(() => {
				if (deviceId.value) {
					notifyBluetoothcharacteristicChange(update)
				} else {
					uni.hideLoading();
				}
			}, 200)
		}
	}

2.4 写入蓝牙数据

低功耗蓝牙的传输能力有限，因此需要注意每次传输的数据长度以及每包数据直接的传输间隔。

// 写入操作
	const writeBluetooth = async ({
		deviceId,
		serviceId,
		characteristicId
	}, value) => {
		//延迟函数
		const Delayed = function(ms, callback) {
			return new Promise(function(Resolve, Peject) {
				setTimeout(function() {
					Resolve(callback);
				}, ms);
			});
		};
		try {
			// 处理待传入蓝牙的数据
			let rawValue = '...';
			let writeValue = null;
			// 写入数据转化,仅使用十六进制字符串转arraybuffer格式
			writeValue = Hex2Ab(rawValue);
			// 分包写入
			// 设置每包最大写入字节，根据具体协议调整长度
			let maxByte = 230;
			let length = writeValue.byteLength;
			let count = Math.ceil(length / maxByte);
			for (let i = 0; i < count; i++) {
				//对writeValue进行分包，最大不超过maxByte
				let TempBuffer;
				if (((i + 1) * maxByte) < length) {
					TempBuffer = writeValue.slice(i * maxByte, (i + 1) * maxByte);
				} else {
					TempBuffer = writeValue.slice(i * maxByte, length);
				};
				Delayed(200).then(() => { //延迟200ms
					//写入设备
					const res = writeBLECharacteristicValue({
						deviceId,
						serviceId,
						characteristicId
					}, TempBuffer);
				});
			};
		} catch (err) {
			console.log('==== err :', err);
			errorCodeTip(err.code);
		}
	}

2.5 读取蓝牙数据

在实际开发场景中，由于蓝牙终端的设计原因，较少使用本方法进行读取。

	// 读取操作
	const readBluetooth = async ({
		deviceId,
		serviceId,
		characteristicId
	}) => {
		try {
			const res = await readBLECharacteristicValue({
				deviceId,
				serviceId,
				characteristicId
			});
			return res;
		} catch (err) {
			errorCodeTip(err.code);
		}
	}

常用的方法是对所获取的特征值变化进行监听，监听数据后抛出即可。该方法需要在写入前调用，以免错过设备端返回数据。

const listenCharacteristicValueChange = () => {
		console.log('开始监听');
		openlListen.value = true
		uni.onBLECharacteristicValueChange(res => {
			const value = Ab2Hex(res.value);
			console.log("监听结果：", res, value);
			uni.$emit('updateMCU', value);

		}).catch(err => {
			openlListen.value = false
		});
	}

三、部分注意事项

3.1 监听搜索设备方法

uniapp提供的搜索蓝牙设备APIuni.onBluetoothDeviceFound()无对应的停止或销毁方法，因此需要将其挂载到App.vue文件中供全局使用。

<script>
 	import { useBluetooth } from "@/hooks/useBluetooth/index.js";
 	export default {
 		onLaunch: function() {
 			const { listenBluetoothFound} = useBluetooth();
 			// 开启蓝牙监听
 			listenBluetoothFound();
 		},
 	}
 </script>

同理，其提供的特征值变化监听方法uni.onBLECharacteristicValueChange()也存在同样的问题，没有与之对应的停止或销毁方法，因此在使用该方法时，需要注意每连接一次低功耗蓝牙设备只能开启一次监听。

3.2 获取蓝牙服务值与特征值

由于相关连接机制问题，在成功连接到低功耗蓝牙设备后，需要延时一秒以上再获取服务值与特征值，否则无法正常获取到服务值。另外，服务值并非一次就能够获取成功，需要设置重试机制轮询获取服务值。
在实际调试场景中，如果在真机调试中刷新了页面，导致了服务值一直获取失败，需要检查蓝牙设备是否被手机系统蓝牙连接，如手机系统未提示，则可通过开关蓝牙并重启应用解决类似问题。

3.3 API支持范围

1.相关API只能支持低功耗蓝牙；
2.搜索时也只能搜索到低功耗蓝牙设备；
3.MTU的设置只能支持Android5.1以上。

参考文档

  1. uniapp蓝牙部分参数方法文档： https://uniapp.dcloud.net.cn/api/system/ble.html
uniapp 低功耗蓝牙项目相关 （蓝牙发光计步犬牌）
超级小恐龙~
03-18 2408
概况：手机APP发送16进制指令至蓝牙犬牌，犬牌响应返回结果，功能为计步，犬牌电量，版本号，系统时间，灯光颜色等。 步骤 打开蓝牙 连接设备 扩大传输MTU 获取蓝牙服务 获取蓝牙设备某个服务中所有特征值(characteristic) 当找到同时有读 写 订阅 权限的特征值时启用低功耗蓝牙设备特征值变化时的 notify功能 订阅特征值开启成功后写入指令 写入成功后读取二进制数据值（此时开启的notify功能就会监听并返回设备响应数据） 接收设备响应数据 注意事项 16进制指令严
Uni-App开发BLE低功耗蓝牙流程
热门推荐
qq_41248093的博客
04-28 1万+
Uni-App开发BLE低功耗蓝牙步骤 开发蓝牙很多小伙伴刚开始一头雾水，不知道从何下手，网上可以查的资料少之又少，所以写这篇文章来总结一下BLE低功耗蓝牙开发流程，话不多说，仔细看！！ 初始化蓝牙 uni.openBluetoothAdapter(OBJECT) 开始搜索蓝牙设备 uni.startBluetoothDevicesDiscovery(OBJECT) 发现外围设备 uni...
BlueToothDemo:如何利用uni-app开发的手机app连接ble蓝牙模块源代码
03-23
BlueToothDemo:如何利用uni-app开发的手机app连接ble蓝牙模块源代码
uniapp 小程序低功耗蓝牙配网 ble配网 物联网
future_1_的博客
05-08 1239
uniapp 小程序低功耗蓝牙配网 ble配网 物联网
uniapp 实现低功耗蓝牙连接并读写数据实战指南
最新发布
Jiaberrr的博客
04-30 3587
在物联网应用场景中，低功耗蓝牙（BLE）凭借其低能耗、连接便捷的特点，成为设备间数据交互的重要方式。Uniapp 作为一款跨平台开发框架，提供了丰富的 API 支持，使得在多个端实现低功耗蓝牙功能变得轻松高效。本文将结合示例代码，详细讲解如何在 Uniapp 中实现低功耗蓝牙的连接、数据读取与写入操作。
uniapp 对接蓝牙设备
不会粘贴复制的程序员不是一个好的程序员！
01-31 4058
再使用或者退出连接蓝牙功能时，建议要先进行断开蓝牙和关闭蓝牙模块，为了防止设备占用蓝牙资源，而造成不必要的情况！当然在关闭蓝牙的同时也可以同步对蓝牙设备进行复位设置。最后再根据自身的业务逻辑再进行处理就可以了。
uniapp连接低功耗蓝牙设备（微信小程序同样适用）
qq_44741577的博客
06-08 5309
但根据文档提示，我们连接后还需要关闭 “搜索附近设备” 的功能，这个很好理解，既然找到了，再继续找就是浪费资源。你的设备可能不止一条特征值，需要监听那条特征值这需要你和硬件佬协商的（通常也是硬件佬直接和你说要监听哪条）。但这是蓝牙设备那边控制的，你作为前端佬，人家“已读不回”你也拿人家没办法。字段里保存了该服务的所有特征值，我的设备这个服务只有1个特征值，并且读、写、消息推送都为 true。上面代码的逻辑是，如果开启 “寻找附近设备” 功能成功，接着就开启 “监听寻找到新设备的事件”。
Uniapp 低功耗蓝牙
weixin_53952234的博客
02-29 1247
低功耗蓝牙
Uni-App使用低功耗蓝牙连接血压仪测量
何以解忧唯有杜康
05-30 5584
1、Uni-APP蓝牙使用流程 在阅读这篇内容之前，建议您详细浏览一遍uni-app官方关于蓝牙和低功耗蓝牙（BLE）使用教程文档 uni-app官方低功耗蓝牙接口，如果您有微信小程序方面的开发经验，那您看这篇文章会很快上手，uni-app官方的蓝牙模块接口均是按照微信小程序的蓝牙模块接口编写。 思路流程 手机上打开蓝牙，设备打开蓝牙 APP初始化蓝牙模块 APP调用蓝牙搜寻设备 APP存储搜寻...
uniapp连接低功耗蓝牙
qq_14941655的博客
03-28 923
选择配对设备进行连接。
低功耗蓝牙App Demo
11-16
自己写的的Ble低功耗蓝牙的Android app的Demo，此例子适用于cc2541 和 jdy 08 蓝牙芯片，其他芯片如果不能正常通讯只需要根据芯片手册进行少许更改即可！
uni-app低功耗蓝牙血压仪测量控制模板
- **使用uni-app低功耗蓝牙连接血压仪** 描述中提及了使用uni-app开发环境来与血压仪这样的蓝牙设备进行连接。这涉及到使用uni-app的API来发现和连接蓝牙设备。uni-app是一个使用Vue.js开发所有前端应用的框架，...
uniapp: 低功耗蓝牙（BLE）的使用
weixin_44719499的博客
04-27 1295
【代码】uniapp: 低功耗蓝牙（BLE）的使用。
保姆级别uni-app使用低功耗蓝牙
weixin_44395210的博客
08-19 2822
帮您了解uniapp的低功耗蓝牙的使用过程。代码可直接使用
uniapp调安卓原生功能实现蓝牙通信
weixin_47588164的博客
09-11 2604
采用云端证书，直接打包即可，等待几分钟完成注意每次如果修改过原生插件代码，都需要重新制作基座，并且要修改上面两个地方的版本号基座完成后，就可以数据线插上电脑，手机开始真机调试选择自己手机，选基座运行或者发行发布apk文件即可原文链接：https://juejin.cn/post/7412893752090558474。
uniapp BLE低功耗蓝牙通信
qq_41971735的博客
12-26 498
3、有些蓝牙协议会用到CRC8校验，该方法有多种校验方式，我这里用的是x8+x2+x+1，多项式POLYNOMIAL的值为0x01；9、将以上方法放在一个Bluetooth.js文件里面，然后在main.js里面挂在它。2、在消息队列时，存的是16进制字符串，发送时才转为ArrayBuffer。1、写入指令（特征值）以及监听拿到的数据均为ArrayBuffer格式；11、Bluetooth.js（请忽略部分业务代码）2、获取蓝牙适配器状态。7、监听蓝牙设备的通知。5、获取蓝牙设备服务。
在uniAPP中使用使用低功耗蓝牙通讯
shidas的博客
09-10 6701
在uniAPP中使用使用低功耗蓝牙通讯 1、初始化蓝牙监听器 onLoad(){ //蓝牙是否在扫描设备 uni.onBluetoothAdapterStateChange((res)=>{ console.log("蓝牙"+(res.discovering ? "开启":"关闭")+"搜索") this.discovering = res.discovering; }) //监听扫描到的蓝牙设备 uni.onBluetoot
【uni-app学习】uni-app低功耗蓝牙采坑记录
lujiaquan688的博客
12-15 6692
一、低功耗蓝牙的基础知识 1、低功耗蓝牙简介 2、RSSI信号强度 3、低功耗蓝牙的整个结构简介 二、uni-app集成低功耗设备全流程（我这边是带低功耗蓝牙的智能水表） 1、低功耗蓝牙集成的步骤概括 2、低功耗蓝牙实现的全部代码 （1）界面端的代码 （2）工具类代码 三、采坑总结 1、蓝牙的分包机制 2、需要在连接蓝牙的时候打开notify() ...
uni-app、微信小程序低功耗蓝牙开发及使用
加班可以,无偿加班不行
08-20 3152
【代码】uni-app、微信小程序低功耗蓝牙开发及使用。 低功耗蓝牙的使用 ArrayBufer转字符串 16进制转ArrayBufer
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值