该技能提供实现 Plaud Embedded iOS SDK 的上下文与说明,适用于希望将原生 iOS 应用与 Plaud 录音设备(Plaud NotePin S、Plaud Note Pro)连接的场景。
主要能力:绑定/解绑 Plaud 设备;通过 BLE 或 WiFi 快速传输(约快 10 倍)同步音频,支持批量下载全部录音;以多种格式导出音频(.pcm、.mp3、.wav、.opus,推荐 .mp3,可直接上传转录 API);对连接的设备进行固件 OTA 更新。高层门面为 PlaudDeviceAgent(BLE 生命周期、文件同步、固件)与 PlaudWiFiAgent(WiFi 快速传输),均通过其 .shared 单例访问,需先用 initSDK(userAccessToken:customDomain:) 初始化一次。SDK 为委托驱动,需实现 PlaudDeviceAgentProtocol、AudioExportCallback、PlaudWiFiAgentProtocol 等协议。
使用前提:已从 Plaud 开发者门户获取 CLIENT_ID、CLIENT_SECRET 与 API_KEY,并能通过认证 API 获取用户令牌;否则需先用 plaud-embedded-project-setup-skill。兼容性:iOS 部署目标 14.0+,Xcode 16.0+(基于 Swift 6.0.3),仅支持 arm64 真机,不支持模拟器。SDK 以预构建框架形式提供,需将 PlaudBleSDK.framework、PlaudWiFiSDK.framework、PlaudDeviceBasicSDK.framework 设为 Embed & Sign,PlaudDeviceBasicSDK.bundle 复制到 Bundle Resources;WiFi 快速传输需要 Hotspot Configuration 权限。
集成路径:无现有应用可部署 Plaud iOS Starter App;已有原生 iOS 应用可直接集成 SDK;React Native、Flutter、Web 应用可分别使用 Expo Native Module、plaud_sdk Flutter 插件、Capacitor 插件,这些插件实现基础功能,高级用法需扩展或直接使用原生 SDK。
注意:设备同一时间只能绑定一个应用,卸载应用前应先解绑,否则设备需恢复后才能再次绑定;绑定/解绑时应先调用 SDK 方法再调用 API,SDK 失败时不要调用 API。低层 BleAgent、WiFiAgent、PlaudPartnerApiManager 可混合使用,但应以高层门面为主。
限制:本文档未提供具体代码方法签名、完整安装命令与计费信息。