jkyy_wx_bluetooth

蓝牙底层模块

支持 uni 和微信小程序

bluetooth.js

蓝牙服务的封装

类属性	类型	描述
deviceInfo	Object	设备信息
connectStatus	String	连接状态：0 未连接或连接断开，允许连接；1 正在连接，不允许再连接；2 已连接，不允许再连接
isInitializedAdapter	Boolean	蓝牙适配器是否初始化完成
isAvailableAdapter	Boolean	蓝牙适配器是否可用
HTTP	Class	请求服务

方法

类方法	入参	返回	描述
openAndListenBluetoothAdapter	-	Promise 对象	打开和监听蓝牙适配器
scanCallback	scanCallbackParams	Promise 对象	扫描外设
stopScanCallback	-	Promise 对象	停止扫描
connectCallback	connectCallbackParams	Promise 对象	连接外设,连接指定的外设，需要传入外设对象。注意实现返回对象的 then 和 catch 方法，监听接口是否调用成功。
disconnectCallback	-	Promise 对象	断开连接
readCallback	readCallbackParams	Promise 对象	读某个服务下的某个特征值。
writeCallback	writeCallbackParams	Promise 对象	向蓝牙模块写入数据
notifyCallback	notifyCallbackParams	Promise 对象	监听特征值改变
registerDidUpdateConnectStatusCallback	cb 回调函数	-	连接状态发生改变时，回调此方法。
registerDidDiscoverDeviceCallback	cb 回调函数	-	当扫描到设备时回调此方法
registerDidUpdateValueForCharacteristicCallback	cb 回调函数	-	当监听的特征值改变时回调此方法
callBackDiscoverDevice	scanCallbackParams 的入参	-	回调发现外设

scanCallbackParams

| 参数 | 类型 | 描述 | | :----------------: | :-----------------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | ------------------------------------ | | services | Array | 要搜索的蓝牙设备主 service 的 uuid 列表。某些蓝牙设备会广播自己的主 service 的 uuid。如果设置此参数，则只搜索广播包有对应 uuid 的主服务的蓝牙设备。建议主要通过该参数过滤掉周边不需要处理的其他蓝牙设备。 | | allowDuplicatesKey | Boolean | 是否允许重复上报同一设备。如果允许重复上报，则 wx.onBlueToothDeviceFound 方法会多次上报同一设备，但是 RSSI 值会有不同。 | | interval | Number | 上报设备的间隔。0 表示找到新设备立即上报，其他数值根据传入的间隔上报。 | | powerLevel | String | 默认 medium 扫描模式，越高扫描越快，也越耗电, 仅安卓 7.0.12 及以上支持。 | | timeout | Number | 扫描超时时间，毫秒。在该时间内未扫描到符合要求的设备，上报超时。默认 1500ms，-1 表示无限超时 | | deviceName | String | 通过蓝牙名称过滤，需要匹配的设备名称 | | containName | String | String[] | 通过蓝牙名称过滤，需要包含的设备名称 |

optionsServices

参数	类型	描述
uuid	String	服务 uuid
serviceId	String	筛选哪个服务用到的 id
serviceIdArr	Array	筛选哪个服务用到的 id(用到多个服务的时候)

connectCallbackParams

参数	类型	描述
device	deviceObject	指定连接的外设对象，从 registerDidDiscoverDeviceCallback 注册的回调中得到
timeout	Number	连接超时时间，毫秒，默认 15000ms

device

参数	类型	描述
deviceExtra	String	设备扩展数据, json 字符串
deviceExtra.uuid	String	蓝牙连接唯一标识 ios 的 uuid，传这个值
deviceId	String	蓝牙连接唯一标识 android 的 mac 地址，传这个值，这样 就可以做到，ios android 跳过扫描直接连接

readCallbackParams

参数	类型	描述
suuid	String	特征对应的服务 uuid
cuuid	String	写入特征 uuid

writeCallbackParams

参数	类型	描述
suuid	String	特征对应的服务 uuid
cuuid	String	写入特征 uuid
value	Hex string	16 进制字符串

notifyCallbackParams

参数	类型	描述
suuid	String	特征对应的服务 uuid
cuuid	String	写入特征 uuid
state	Hex string	是否启用 notify，可以通过重复调用接口改变此属性打开/关闭监听

enum.js

所有错误的集合包括微信的错误和自己定义的错误

code	message
210	发现外设
211	扫描完成
220	蓝牙打开
221	正在连接
222	连接成功
223	断开成功
410	扫描超时
420	蓝牙关闭
421	连接失败
422	连接断开
2010	 扫描接口成功调用
2020	 停止扫描接口成功调用
2030	 连接接口成功调用
2040	 断开接口成功调用
2050	 读特征值接口成功调用
2060	 写入数据接口成功调用
2070	 监听特征值接口成功调用
4000	当前基础库版本低，请更新微信版本
4010	扫描失败，请稍后重试
4011	扫描错误：蓝牙被关闭
4012	没有找到指定的蓝牙服务
4013	请打开手机蓝牙，并进入手机应用设置开启微信的蓝牙授权，方可查找设备
4020	停止蓝牙扫描失败
4021	请打开手机蓝牙后再试
4030	蓝牙连接失败，请稍后重试
4031	请开启手机蓝牙后再试
4032	蓝牙正在连接
4033	蓝牙连接超时，请稍后重试
4034	蓝牙连接设备 id 不能为空
4040	蓝牙断开失败
4050	 读特征值失败
4051	蓝牙未连接
4052	当前特征不支持读操作
4053	没有找到指定服务
4054	没有找到指定特征值
4060	 写入数据失败
4061	蓝牙未连接
4062	当前特征不支持写操作
4063	没有找到指定服务
4064	没有找到指定特征值
4070	 监听特征值失败
4071	蓝牙未连接
4072	当前特征不支持监听操作
4073	没有找到指定服务
4074	没有找到指定特征值

extends.js

log 输出

tool.js

常用的蓝牙传输数据的方法，继承此类的各个硬件的 SDK，可以调用这里面的方法

promisify.js

小程序 api 的封装，支持 promise

http.js

请求服务的封装，继承此类的各个硬件的 SDK，可以使用此服务发送请求