更新记录

1.2.3（2025-11-14） 下载此版本

添加主板参数接口

1.2.2（2025-11-10） 下载此版本

添加triggerBeep接口

1.2.1（2025-11-07） 下载此版本

修复部分设备在IOS上初始化失败的问题

平台兼容性

uni-app(3.6.16)

rfid-ble-sdk

本插件仅适用于已完成适配的特定设备环境，非全市场通用 RFID 插件。未经验证的设备可能无法工作，使用前请认真评估

使用说明

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" />
   <uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />

   App权限配置 IOS：
   蓝牙(NSBluetoothAlwaysUsageDescription)、蓝牙(NSBluetoothAlwaysUsageDescription)

   若是运行于App，manifest.josn -> App模块配置 勾选 低功耗蓝牙

   若是运行于H5，manifest.josn -> Web配置 勾选 启用https协议 (Web Bluetooth API要求)

2. 插件所有接口都集成于RFIDManager，RFIDManager使用了单例模式，直接 RFIDManager.getInstance().xxx 调用各接口即可，请勿 new RFIDManager()。 RFIDManager的接口文档请查看插件目录下的 RFIDManager Doc.html 文件，具体使用方法可以查看示例Demo。

   若有其他问题，可以向相关技术支持人员咨询和反馈

注意事项

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

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

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