用途:帮助首次接入 Plaud Embedded 的用户完成项目初始化。适用于尚未实现 Plaud Embedded SDK 或 API 的场景,例如咨询如何开始使用 Plaud Embedded、如何在 iOS 或 Android 应用中实现 Embedded SDK、如何连接 Plaud 设备(如 Plaud NotePin S 或 Plaud Note Pro)、如何认证 Plaud 并获取 partner 与 user token。若用户已有客户端凭据、API、key 和认证设置,应改用 plaud-embedded-mobile-sdk-skill 或 plaud-embedded-transcription-api-skill。
背景:Plaud 提供 AI 笔记与对话录音硬件,设备包括 Plaud Note Pro(卡片式,可放入手机卡槽录制通话与面对面交谈)和 Plaud NotePin S(可穿戴别针,录制面对面交谈)。Plaud Embedded 目前仅支持 Plaud Note Pro 与 Plaud NotePin S,Plaud Note 和 Plaud NotePin 不受支持。典型场景包括医生转写就诊记录、外勤销售为会议生成 AI 笔记;其优势包括硬件与 ASR 转写模型。
主要组件:Plaud Developer Portal,用于创建应用并获取凭据;iOS 与 Android 的 Embedded SDK,用于移动应用连接设备并同步录音文件;Transcription API,可在移动端或后端上传音频并获取转写。Android Embedded SDK 已正式可用,功能与 iOS 对等(扫描、连接、录音、文件列表/同步/删除、设置、WiFi 配网、WiFi 快速传输与 OTA)。
使用方式:若尚未创建 Plaud Embedded 应用,先在 Plaud Developer Portal 创建应用,获取 CLIENT_ID、CLIENT_SECRET 与 API_KEY;随后参考认证文档,构建服务端端点或本地测试脚本以生成用户令牌,可参考 user-token-script.ts 获取 partner 与 user token;也可使用 Plaud Embedded API Playground 走通认证→录音→上传→转写全流程。生成 User Token 使用的 user_id 需为稳定的 6–120 字符 ID。完成凭据与认证后,即可使用 Embedded SDK 与 Transcription API。原生 iOS 用 plaud-embedded-ios-sdk-skill,原生 Android 用 plaud-embedded-android-sdk-skill。非原生应用可通过原生插件接入:React Native 使用 Expo Native Module(仓库 embedded-react-native),Flutter 使用平台通道与原生插件(仓库 embedded-flutter),Web 应用包装为原生 iOS 应用使用 Capacitor 插件(仓库 embedded-capacitor)。这些插件实现设备连接、文件同步与转写等基础能力;WiFi 快速传输等高级用法需扩展插件或直接使用原生 iOS SDK。
认证 API 包括 Get Partner Token、Refresh Partner Token、Get User Token。限制:具体价格、平台支持细节与使用步骤在资料中暂未提供,请以官方文档为准。