wx simple bluetooth
1.0.0
이름: wx-simple-bluetooth
적용 가능한 플랫폼: WeChat 애플릿
블루투스: 블루투스 저에너지
프로젝트 버전: 2.0.1
이 프로젝트는 Bluetooth 연결, Bluetooth 프로토콜 통신, 상태 구독 및 알림의 세 가지 수준으로 설계되어 자신만의 미니 프로그램의 Bluetooth 개발을 쉽게 사용자 정의할 수 있습니다. 주요 기능은 다음과 같습니다.
!!!먼저 WeChat 개발 도구의 향상된 컴파일을 활성화해야 합니다!!!
这个项目从蓝牙连接、蓝牙协议通信、状态订阅及通知三个层面进行设计，可以很方便的定制您自己的小程序的蓝牙开发。主要功能如下.
휴대폰에서 블루투스 기능, GPS, WeChat 위치 확인 권한이 켜져 있는 경우는 다음과 같습니다.
getAppBLEManager.connect() 실행하면 350ms 마다 주변 Bluetooth 장치를 자동으로 검색하고 해당 시간 내에 신호가 가장 강한 장치에 연결됩니다.service 의 uuid 목록과 통신에 사용되는 해당 서비스 ID를 설정할 수 있으며, 추가 Bluetooth 장치 이름을 추가하여 장치를 추가로 필터링할 수도 있습니다.注意：目前在发送数据时大于20包的数据会被裁剪为20包. （有些蓝牙连接问题是微信兼容或是手机问题，目前是无法解决的。如错误码10003以及部分华为手机蓝牙连接或重连困难。如果您有很好的解决方案，还请联系我，十分感谢）lb-example-bluetooth-manager.js 예시를 참조하세요.따라서 이러한 고려 사항에 따라 이 프레임워크에는 다음과 같은 제약이 있습니다.
- 프레임워크를 정상적으로 사용하기 위해서는 합의된 합의 형식에 따라 합의서를 작성해야 합니다.
- 프로토콜 패킷의 최대 데이터 수는 20바이트입니다. 프레임워크는 20바이트보다 큰 프로토콜 형식을 지원하지 않습니다. 데이터가 한도를 초과하는 경우 여러 번에 나누어 전송하는 것이 좋습니다.
- 직렬 모드에서 쓰기 작업을 수행하는 것이 좋습니다.
- 프레임워크 사용에 대한 이해를 돕기 위해 먼저 미니 프로그램의 공식 Bluetooth 문서를 이해하는 것이 좋습니다.
协议约定格式：[...命令字之前的数据(非必需), 命令字(必需), ...有效数据(非必需 如控制灯光发送255,255,255), 有效数据之后的数据(非必需 如协议结束标志校、验位等)
协议格式示例：[170(帧头), 10(命令字), 1(灯光开启),255,255,255(三个255,白色灯光),233(协议结束标志，有的协议中没有这一位),18(校验位，我胡乱写的)]
有效数据是什么：
在刚刚的这个示例中，帧头、协议结束标志是固定的值，校验位是按固定算法生成的，这些不是有效数据。而1,255,255,255这四个字节是用于控制蓝牙设备的，属于有效数据。
이 프로젝트가 도움이 된다면 GitHub에서 별점을 주고 싶습니다!
modules 폴더를 프로젝트로 가져옵니다. import Toast from "../../view/toast";
import UI from './ui';
import {ConnectState} from "../../modules/bluetooth/lb-bluetooth-state-example";
import {getAppBLEProtocol} from "../../modules/bluetooth/lb-example-bluetooth-protocol";
import {getAppBLEManager} from "../../modules/bluetooth/lb-example-bluetooth-manager";
const app = getApp();
Page({
/**
* 页面的初始数据
*/
data: {
connectState: ConnectState.UNAVAILABLE
},
/**
* 生命周期函数--监听页面加载
*/
onLoad(options) {
this.ui = new UI(this);
console.log(app);
//监听蓝牙连接状态、订阅蓝牙协议接收事件
//多次订阅只会在最新订阅的函数中生效。
//建议在app.js中订阅，以实现全局的事件通知
getAppBLEManager.setBLEListener({
onConnectStateChanged: async (res) => {
const {connectState} = res;
console.log('蓝牙连接状态更新', res);
this.ui.setState({state: connectState});
switch (connectState) {
case ConnectState.CONNECTED:
//在连接成功后，紧接着设置灯光颜色和亮度
//发送协议，官方提醒并行调用多次会存在写失败的可能性，所以建议使用串行方式来发送
await getAppBLEProtocol.setColorLightAndBrightness({
brightness: 100,
red: 255,
green: 0,
blue: 0
});
break;
default:
break;
}
},
/**
* 接收到的蓝牙设备传给手机的有效数据，只包含你最关心的那一部分
* protocolState和value具体的内容是在lb-example-bluetooth-protocol.js中定义的
*
* @param protocolState 蓝牙协议状态值，string类型，值是固定的几种，详情示例见：
* @param value 传递的数据，对应lb-example-bluetooth-protocol.js中的{effectiveData}字段
*/
onReceiveData: ({protocolState, value}) => {
console.log('蓝牙协议接收到新的 protocolState:', protocolState, 'value:', value);
}
});
//这里执行连接后，程序会按照你指定的规则（位于getAppBLEManager中的setFilter中指定的），自动连接到距离手机最近的蓝牙设备
getAppBLEManager.connect();
},
/**
* 断开连接
* @param e
* @returns {Promise<void>}
*/
async disconnectDevice(e) {
// closeAll() 会断开蓝牙连接、关闭适配器
await getAppBLEManager.closeAll();
this.setData({
device: {}
});
setTimeout(Toast.success, 0, '已断开连接');
},
/**
* 连接到最近的设备
*/
connectHiBreathDevice() {
getAppBLEManager.connect();
},
async onUnload() {
await getAppBLEManager.closeAll();
},
});
setFilter 함수 매개변수 설정 및 필터링 규칙 검색(선택 사항) 파일은 ./modules/bluetooth/lb-example-bluetooth-manager.js 에 있습니다.
import {LBlueToothManager} from "./lb-ble-common-connection/index";
import {getAppBLEProtocol} from "./lb-example-bluetooth-protocol";
/**
* 蓝牙连接方式管理类
* 初始化蓝牙连接时需筛选的设备，重写蓝牙连接规则
*/
export const getAppBLEManager = new class extends LBlueToothManager {
constructor() {
super();
//setFilter详情见父类
super.setFilter({
services: ['0000xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx'],//必填
targetServiceArray: [{
serviceId: 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx',//必填
writeCharacteristicId: 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxE',//必填
notifyCharacteristicId: 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxF',//必填
readCharacteristicId: '',//非必填
}],
targetDeviceName: '目标蓝牙设备的广播数据段中的 LocalName 数据段，如：smart-voice',//非必填，在判断时是用String.prototype.includes()函数来处理的，所以targetDeviceName不必是全称
scanInterval: 350//扫描周围设备，重复上报的时间间隔，毫秒制，非必填，默认是350ms
});
super.initBLEProtocol({bleProtocol: getAppBLEProtocol});
//setMyFindTargetDeviceNeedConnectedFun函数调用可选，不实现过滤规则框架会按默认规则执行
super.setMyFindTargetDeviceNeedConnectedFun({
/**
* 重复上报时的过滤规则，并返回过滤结果
* 在执行完该过滤函数，并且该次连接蓝牙有了最终结果后，才会在下一次上报结果回调时，再次执行该函数。
* 所以如果在一次过滤过程中或是连接蓝牙，耗时时间很长，导致本次连接结果还没得到，就接收到了下一次的上报结果，则会忽略下一次{scanFilterRuler}的执行。
* 如果不指定这个函数，则会使用默认的连接规则
* 默认的连接规则详见 lb-ble-common-connection/utils/device-connection-manager.js的{defaultFindTargetDeviceNeedConnectedFun}
* @param devices {*}是wx.onBluetoothDeviceFound(cb)中返回的{devices}
* @param targetDeviceName {string}是{setFilter}中的配置项
* @returns targetDevice 最终返回对象{targetDevice}，是数组{devices}其中的一个元素；{targetDevice}可返回null，意思是本次扫描结果未找到指定设备
*/
scanFilterRuler: ({devices, targetDeviceName}) => {
console.log('执行自定义的扫描过滤规则');
const tempFilterArray = [];
for (let device of devices) {
if (device.localName?.includes(targetDeviceName)) {
tempFilterArray.push(device);
}
}
if (tempFilterArray.length) {
const device = tempFilterArray.reduce((pre, cur) => {
return pre.RSSI > cur.RSSI ? pre : cur;
});
return {targetDevice: device};
}
return {targetDevice: null};
}
})
}
/**
* 获取本机蓝牙适配器状态
* @returns {Promise<*>} 返回值见小程序官网 wx.getBluetoothAdapterState
*/
async getBLEAdapterState() {
return await super.getBLEAdapterState();
}
/**
* 获取最新的蓝牙连接状态
* @returns {*}
*/
getBLELatestConnectState() {
return super.getBLELatestConnectState();
}
}();
파일은 ./modules/bluetooth/lb-ble-example-protocol-body 에 있습니다.
//send-body.js
import {IBLEProtocolSendBody} from "../lb-ble-common-protocol-body/index";
import {HexTools} from "../lb-ble-common-tool/index";
/**
* 组装蓝牙协议发送数据示例
* 该框架的蓝牙协议必须按照约定格式来制定，最多20个字节
*/
export default class SendBody extends IBLEProtocolSendBody {
getDataBeforeCommandData({command, effectiveData} = {}) {
//有效数据前的数据 该示例只返回了帧头110
return [110];
}
getDataAfterEffectiveData({command, effectiveData} = {}) {
//协议结束标志
const endFlag = 233;
//该示例中checkSum的生成规则是计算协议从第0个元素累加到结束标志
let checkSum = endFlag + HexTools.hexToNum(command);
for (let item of this.getDataBeforeCommandData()) {
checkSum += item;
}
for (let item of effectiveData) {
checkSum += item;
}
//生成有效数据之后的数据
return [endFlag, checkSum];
}
}
//receive-body.js
import {IBLEProtocolReceiveBody} from "../lb-ble-common-protocol-body/index";
/**
* 组装蓝牙协议接收数据示例
* 该框架的蓝牙协议必须按照约定格式来制定，最多20个字节
*/
export default class ReceiveBody extends IBLEProtocolReceiveBody {
constructor() {
//commandIndex 命令字位置索引
//effectiveDataStartIndex 有效数据开始索引，比如：填写0，{getEffectiveReceiveDataLength}中返回20，则会在{LBlueToothProtocolOperator}的子类{getReceiveAction}实现中，在参数中返回所有数据
super({commandIndex: 1, effectiveDataStartIndex: 0});
}
/**
* 获取有效数据的字节长度
* 该长度可根据接收到的数据动态获取或是计算，或是写固定值均可
* 有效数据字节长度是指，在协议中由你的业务规定的具有特定含义的值的总字节长度
* 有效数据更多的说明，以及该长度的计算规则示例，见 IBLEProtocolReceiveBody 类的 {getEffectiveReceiveData}函数
*
* @param receiveArray 接收到的一整包数据
* @returns {number} 有效数据的字节长度
*/
getEffectiveReceiveDataLength({receiveArray}) {
return 20;
}
}
modules/bluetooth/lb-example-bluetooth-protocol.js 에 위치
import {LBlueToothProtocolOperator} from "./lb-ble-common-protocol-operator/index";
import SendBody from "./lb-ble-example-protocol-body/send-body";
import ReceiveBody from "./lb-ble-example-protocol-body/receive-body";
import {ProtocolState} from "./lb-bluetooth-state-example";
/**
* 蓝牙协议管理类
* 在这个类中，以配置的方式来编写读操作和写操作
* 配置方式见下方示例
*/
export const getAppBLEProtocol = new class extends LBlueToothProtocolOperator {
constructor() {
super({protocolSendBody: new SendBody(), protocolReceiveBody: new ReceiveBody()});
}
/**
* 写操作（仅示例）
*/
getSendAction() {
return {
/**
* 0x01：设置灯色（写操作）
* @param red 0x00 - 0xff
* @param green 0x00 - 0xff
* @param blue 0x00 - 0xff
* @returns {Promise<void>}
*/
'0x01': async ({red, green, blue}) => {
return await this.sendProtocolData({command: '0x01', effectiveData: [red, green, blue]});
},
/**
* 0x02：设置灯亮度（写操作）
* @param brightness 灯亮度值 0~100 对应最暗和最亮
* @returns {Promise<void>}
*/
'0x02': async ({brightness}) => {
//data中的数据，填写多少个数据都可以，可以像上面的3位，也可以像这条6位。你只要能保证data的数据再加上你其他的数据，数组总长度别超过20个就行。
return await this.sendProtocolData({command: '0x02', effectiveData: [brightness, 255, 255, 255, 255, 255]});
},
}
}
/**
* 读操作（仅示例）
* {dataArray}是一个数组，包含了您要接收的有效数据。
* {dataArray}的内容是在lb-ble-example-protocol-body.js中的配置的。
* 是由您配置的 dataStartIndex 和 getEffectiveReceiveDataLength 共同决定的
*/
getReceiveAction() {
return {
/**
* 获取设备当前的灯色（读）
* 可return蓝牙协议状态protocolState和接收到的数据effectiveData，
* 该方法的返回值，只要拥有非空的protocolState，该框架便会同步地通知前端同protocolState类型的消息
* 当然是在你订阅了setBLEListener({onReceiveData})时才会在订阅的地方接收到消息。
*/
'0x10': ({dataArray}) => {
const [red, green, blue] = dataArray;
return {protocolState: ProtocolState.RECEIVE_COLOR, effectiveData: {red, green, blue}};
},
/**
* 获取设备当前的灯亮度（读）
*/
'0x11': ({dataArray}) => {
const [brightness] = dataArray;
return {protocolState: ProtocolState.RECEIVE_BRIGHTNESS, effectiveData: {brightness}};
},
/**
* 接收到设备主动发送的灯光关闭消息
* 模拟的场景是，用户关闭了设备灯光，设备需要主动推送灯光关闭事件给手机
*/
'0x12': () => {
//你可以不传递effectiveData
return {protocolState: ProtocolState.RECEIVE_LIGHT_CLOSE};
},
/**
* 接收到蓝牙设备的其他一些数据
*/
'0x13': ({dataArray}) => {
//do something
//你可以不返回任何值
}
};
}
/**
* 设置灯亮度和颜色
* @param brightness
* @param red
* @param green
* @param blue
* @returns {Promise<[unknown, unknown]>}
*/
async setColorLightAndBrightness({brightness, red, green, blue}) {
//发送协议，小程序官方提醒并行调用多次会存在写失败的可能性，所以建议使用串行方式来发送，哪种方式由你权衡
//但我这里是并行发送了两条0x01和0x02两条协议，仅演示用
return Promise.all([this.sendAction['0x01']({red, green, blue}), this.sendAction['0x02']({brightness})]);
}
}();
파일은 modules/bluetooth/lb-bluetooth-state-example.js 에 있습니다.
import {CommonConnectState, CommonProtocolState} from "./lb-ble-common-state/index";
//特定的蓝牙设备的协议状态，用于拓展公共的蓝牙协议状态
//使用场景：
//在手机接收到蓝牙数据成功或失败后，该框架会生成一条消息，包含了对应的蓝牙协议状态值{protocolState}以及对应的{effectiveData}(effectiveData示例见 lb-example-bluetooth-protocol.js)，
//在{setBLEListener}的{onReceiveData}回调函数中，对应参数{protocolState}和{value}(value就是effectiveData)
const ProtocolState = {
...CommonProtocolState,
RECEIVE_COLOR: 'receive_color',//获取到设备的颜色值
RECEIVE_BRIGHTNESS: 'receive_brightness',//获取到设备的亮度
RECEIVE_LIGHT_CLOSE: 'receive_close',//获取到设备灯光关闭事件
};
export {
ProtocolState, CommonConnectState as ConnectState
};
| 사업 | 해당 폴더 | 샘플 파일 |
|---|---|---|
| 블루투스 연결 | lb-ble-common-connection (연결, 연결 해제 및 재연결 이벤트 처리) | abstract-bluetooth.js (가장 간단한 플랫폼 API를 호출하여 Bluetooth 연결, 연결 끊기 등)base-bluetooth.js (연결된 장치의 deviceId, 특성 값, 연결 상태 및 기타 정보를 기록하고 Bluetooth 데이터 전송 및 Bluetooth 재연결을 처리합니다)base-bluetooth-imp.js (Bluetooth 연결 결과를 캡처하고 주변 장치, 연결 및 어댑터 상태 이벤트의 Bluetooth 검색을 모니터링하고 그에 따라 처리합니다) |
| 블루투스 프로토콜 조립 | lb-ble-common-protocol-body (프로토콜 트랜시버 형식의 어셈블리 구현) | i-protocol-receive-body.jsi-protocol-send-body.js |
| Bluetooth 프로토콜 전송 및 수신 | lb-ble-common-protocol-operator (데이터 전송 및 수신을 처리하는 에이전트) | lb-bluetooth-protocol-operator.js |
| 블루투스 프로토콜 재전송 | lb-ble-common-connection | lb-bluetooth-manager.js (자세한 내용은 LBlueToothCommonManager 참조) |
| Bluetooth 상태 및 프로토콜 상태 | lb-ble-common-state | lb-bluetooth-state-example.js - 새로운 상태를 추가로 확장할 수 있습니다. |
| Bluetooth 연결 및 프로토콜 상태 이벤트 구독 | lb-ble-common-connection/base | base-bluetooth-imp.js |
블루투스 연결 및 프로토콜 상태 분포에 대해 이야기해보겠습니다.
파일은 lb-ble-common-connection/base/base-bluetooth.js 에 있습니다.
latestConnectState 개체에 할당됩니다.set latestConnectState setter 기능을 트리거합니다.setter 내에서 _onConnectStateChanged 함수 콜백을 실행합니다.getAppBLEManager.setBLEListener 의 onConnectStateChanged({connectState}) 함수에서 수신됩니다. onBLECharacteristicValueChange 는 lb-ble-common-connection/abstract-bluetooth.js 에 있습니다. receiveOperation 은 lb-ble-common-protocol-operator/lb-bluetooth-protocol-operator.js 에 있습니다.
onBLECharacteristicValueChange 함수에서는 데이터를 수신한 후 receive-body.js 에 따라 유효한 데이터를 가로채고, lb-example-bluetooth-protocol.js 의 getReceiveAction 구성 메소드에 따라 유효한 데이터를 처리하여 해당 value, protocolState 생성합니다. value, protocolState . 알 수 없는 프로토콜이 수신되면 filter 생성됩니다.
onBLECharacteristicValueChange((res) => {
console.log('接收到消息', res);
if (!!valueChangeListener) {
const {value, protocolState, filter} = this.dealReceiveData({receiveBuffer: res.value});
!filter && valueChangeListener({protocolState, value});
}
});
이 코드는 간단해 보이지만 그 뒤에는 많은 프로세스가 있습니다. 가장 중요한 것은 이 라인 const {value, protocolState, filter} = this.dealReceiveData({receiveBuffer: res.value}); ;입니다. 이 작업 계열이 수행한 작업을 자세히 설명하겠습니다.
dealReceiveData 함수를 실행하여 프로토콜 데이터를 처리합니다. 여기서 dealReceiveData 궁극적으로 데이터를 처리하기 위해 lb-bluetooth-manager.js 의 dealReceiveData 함수로 전달됩니다.dealReceiveData 에서 this.bluetoothProtocol.receive({receiveBuffer}) 실행하여 유효한 데이터 및 프로토콜 상태를 생성합니다. 이 receive 최종적으로 receiveOperation 함수에 의해 실행됩니다.receiveOperation 실행되면 LBlueToothProtocolOperator 하위 클래스의 구성 항목 getReceiveAction 참조합니다(하위 클래스는 lb-example-bluetooth-protocol.js 입니다).getReceiveAction 최종적으로 개발자 자체 구현에 따라 합의된 객체인 {protocolState,effectiveData} 를 receiveOperation 으로 반환한 후 확인을 수행하고( getReceiveAction 에 구성되지 않은 protocolState CommonProtocolState.UNKNOWN 으로 처리됨) 반환합니다. dealReceiveData 함수의 지역 변수 effectiveData, protocolState .protocolState!==CommonProtocolState.UNKNOWN 의 해당 객체는 filter:true 로 표시됩니다. 그렇지 않으면 합의된 객체는 onBLECharacteristicValueChange 함수의 지역 변수 value, protocolState 로 반환됩니다.이것이 이 코드 줄의 전부입니다.
합의된 객체는 valueChangeListener({protocolState, value}) 에 매개변수로 전달되고 콜백이 실행됩니다. 그 후 프런트 엔드는 구독된 이벤트를 수신할 수 있습니다. 즉, 프로토콜 유형 및 value 객체는 getAppBLEManager.setBLEListener 의 onReceiveData({protocolState, value}) 함수에서 수신됩니다.
문서
변경 로그
품질보증
특허
기술 교류를 원하시면 QQ 그룹에 가입하세요: 821711186
