用途:指导开发者在原生 Android 应用中集成 Plaud Embedded SDK,把应用与 Plaud 录音设备(Plaud NotePin S、Plaud Note Pro)连接起来。
前置条件:需先从 Plaud Developer Portal 获取 Plaud Embedded 凭据(CLIENT_ID、CLIENT_SECRET、API_KEY),并能通过 Plaud 认证 API 获取 User Token;若两者缺失,需改用 plaud-embedded-project-setup-skill。安装步骤见 Installation Guide。
主要能力:绑定(连接)与解绑 Plaud 设备;通过 BLE 或 WiFi 快速传输(约快 10 倍)同步音频,支持批量下载全部录音;以 PCM、WAV、OPUS、MP3 导出音频(推荐 MP3,通用且可被转写上传 API 直接接受);对已连接设备进行固件 OTA 升级。
使用方式:提供 Plaud Starter App(已完整集成 SDK 的 Android 示例应用),位于 plaud-sdk-public 的 android/ 目录,可 clone 后按 Starter App Guide 操作。凭据写入 android/ 下被 gitignore 的 local.properties:PLAUD_USER_ACCESS_TOKEN(SDK 初始化必需)、PLAUD_CLIENT_ID 与 PLAUD_API_KEY(仅转写 API 需要)。两个高层门面为 PlaudDeviceAgent(Kotlin object,静态调用,无需构造实例)和 IWifiTransferAgent(通过 PlaudDeviceAgent.getWifiAgent() 获取,返回可空对象,需安全调用)。用 initSDK(context:userAccessToken:customDomain:) 初始化一次,customDomain 为不带 https:// 前缀的 Plaud 域名。SDK 为回调驱动,需实现 PlaudDeviceAgentListener、AudioExporter.ExportCallback、IWifiTransferAgent.WifiTransferCallback、FirmwareUpdateCallback。BLE 扫描需运行时权限,可用 SDK 的 sdk.permission.PermissionManager 请求完整权限集。
Android 注意事项:调用 connectBleDevice(...) 前需确保合作方 RSA 密钥对已就绪(initSDK 会获取,可轮询 NiceBuildSdk.isPartnerDataReady()),且序列号已通过 NiceBuildSdk.signAndStoreDeviceSn(deviceType, sn) 签名存储,否则安全握手失败。设备同一时间只能绑定一个应用,卸载应用前需先解绑,否则需恢复后才能重新绑定。绑定与解绑应先调用 SDK 方法再调 API,SDK 失败时不要调 API。
限制:资料未提供 SDK 版本、收费与价格等信息;更多底层能力可参考 Advanced Android SDK usage 文档(IBleAgent、NiceBuildSdk、PartnerApiManager),高层与低层门面可混用,但应以 PlaudDeviceAgent 为主驱动。