更新记录

1.0（2026-11-04） 下载此版本

firt commit

平台兼容性

销秘录音卡 BLE 管理插件（aiera-pnode）

概述

iOS 原生 BLE 插件，用于扫描、连接和管理销秘 CB08 录音卡设备。基于 PNode 协议实现，支持文件传输、设备状态读取和 OTA 升级。

环境要求

权限列表

示例 Info.plist 配置：

<key>NSBluetoothAlwaysUsageDescription</key>
<string>连接销秘录音卡设备，同步录音文件</string>

JS 接口

获取插件实例

const pnode = uni.requireNativePlugin('aiera-pnode')

1. init(options, callback) — 初始化

初始化 BLE 连接，建立保活事件流。

callback 事件格式：

{ event: 'deviceFound', data: { name: 'CB08-xxxx', rssi: -65, ... } }
{ event: 'connected', data: { name: 'CB08-xxxx' } }
{ event: 'disconnected', data: { reason: '...' } }
{ event: 'fileList', data: { files: [...] } }
{ event: 'transferProgress', data: { percent: 50, ... } }
{ event: 'transferComplete', data: { fileId: '...' } }

示例：

pnode.init({}, event => {
  console.log('BLE 事件:', event.event, event.data)
})

2. call(options, callback) — 命令分发

执行一次性 BLE 命令。

支持的命令：

示例：

// 扫描设备
pnode.call({ method: 'scan', args: { duration: 10000 } }, result => {
  if (result.error) { console.error(result.error); return }
  console.log('扫描完成:', result.data)
})

// 连接设备
pnode.call({ method: 'connect', args: { deviceId: 'CB08-12345' } }, result => {
  if (result.error) { console.error(result.error); return }
  console.log('已连接')
})

3. dispose(options, callback) — 销毁

断开 BLE 连接并释放资源。

pnode.dispose({}, () => { console.log('已销毁') })

错误码

注意事项

1. 必须先调用 init() 再调用 call()
2. init 的 callback 是保活回调，会持续接收事件直到 dispose
3. BLE 操作需要在主线程发起
4. iOS 13+ 需要用户授权蓝牙权限
5. 建议在页面 onUnload 时调用 dispose() 释放资源

更新日志

v1.0.0

• 初始版本
• 支持扫描/连接/文件传输/OTA 升级
• 支持 CB08 录音卡 PNode 协议