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