更新记录

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

使用说明

  1. 插件需要使用蓝牙权限,注意在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要求)

  2. RFIDManager各接口文档请查看插件目录下的 RFIDManager接口文档.html 文件,具体使用方法可以查看示例Demo。
    如有其他问题,可以向相关负责人员或在官网咨询和反馈

注意事项

  1. 插件不实现搜索和连接蓝牙的功能,请参考官方文档自行实现,Web端参考Web Bluetooth API

  2. 插件需要使用 uni.onBLEConnectionStateChange 监听蓝牙连接状态来保证接口正确性,因此请不要调用 uni.onBLEConnectionStateChange, 否则可能会覆盖插件的回调,插件无法监听蓝牙连接状态会导致各接口异常。
    可以使用 RFIDManager.getInstance().onBLEConnectionStateChange(callback) 作为代替, 该接口基于 uni.onBLEConnectionStateChange 实现,用法完全一致,且可多次调用和移除回调

  3. App和小程序 基于uni接口,具体是否适配请参考官网,demo只测试了Android、IOS和微信小程序;
    Web端基于 Web Bluetooth API 进行适配, 该API要求运行环境为https,且只能运行于Chromium内核浏览器,具体限制请查看官方描述,限制较大请权衡利弊后再使用。

  4. 插件所有接口都集成于RFIDManagerRFIDManager使用了单例模式,直接 RFIDManager.getInstance().xxx 调用各接口即可, 请勿 new RFIDManager()

隐私、权限声明

1. 本插件需要申请的系统权限列表:

<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" />

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

许可协议

MIT协议

暂无用户评论。

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问