更新记录
1.0.1(2024-12-12) 下载此版本
完善文档
1.0.0(2024-12-12) 下载此版本
初版SDK,实现设置、盘点、读、写、锁、销毁、扫码等基本功能
平台兼容性
Vue2 | Vue3 |
---|---|
√ | √ |
App | 快应用 | 微信小程序 | 支付宝小程序 | 百度小程序 | 字节小程序 | QQ小程序 |
---|---|---|---|---|---|---|
HBuilderX 3.8.3 app-vue | × | √ | × | × | × | × |
钉钉小程序 | 快手小程序 | 飞书小程序 | 京东小程序 | 鸿蒙元服务 |
---|---|---|---|---|
× | × | × | × | × |
H5-Safari | Android Browser | 微信浏览器(Android) | QQ浏览器(Android) | Chrome | IE | Edge | Firefox | PC-Safari |
---|---|---|---|---|---|---|---|---|
× | × | × | × | √ | × | √ | × | × |
rfid-ble-sdk
使用说明
-
插件需要使用蓝牙权限,注意在
manifest.josn
中添加响应的蓝牙权限。建议添加以下设置:App权限配置 安卓:
<uses-permission android:name="android.permission.BLUETOOTH" /> <uses-permission android:name="android.permission.BLUETOOTH_ADMIN" /> <uses-permission android:name="android.permission.BLUETOOTH_SCAN" /> <uses-permission android:name="android.permission.BLUETOOTH_ADVERTISE" />
App权限配置 IOS:
蓝牙(NSBluetoothAlwaysUsageDescription)、蓝牙(NSBluetoothAlwaysUsageDescription)若是运行于App,
manifest.josn -> App模块配置
勾选低功耗蓝牙
若是运行于H5,
manifest.josn -> Web配置
勾选启用https协议
(Web Bluetooth API要求) -
RFIDManager各接口文档请查看插件目录下的
RFIDManager接口文档.html
文件,具体使用方法可以查看示例Demo。
如有其他问题,可以向相关负责人员或在官网咨询和反馈
注意事项
-
插件不实现搜索和连接蓝牙的功能,请参考官方文档自行实现,Web端参考Web Bluetooth API
-
插件需要使用
uni.onBLEConnectionStateChange
监听蓝牙连接状态来保证接口正确性,因此请不要调用uni.onBLEConnectionStateChange
, 否则可能会覆盖插件的回调,插件无法监听蓝牙连接状态会导致各接口异常。
可以使用RFIDManager.getInstance().onBLEConnectionStateChange(callback)
作为代替, 该接口基于uni.onBLEConnectionStateChange
实现,用法完全一致,且可多次调用和移除回调 -
App和小程序 基于uni接口,具体是否适配请参考官网,demo只测试了Android、IOS和微信小程序;
Web端基于 Web Bluetooth API 进行适配, 该API要求运行环境为https,且只能运行于Chromium内核浏览器,具体限制请查看官方描述,限制较大请权衡利弊后再使用。 -
插件所有接口都集成于
RFIDManager
,RFIDManager
使用了单例模式,直接RFIDManager.getInstance().xxx
调用各接口即可, 请勿new RFIDManager()