plaud-embedded-project-setup-skill

Plaud Embedded 项目设置技能

此技能提供：

1. Plaud Embedded 的相关背景
2. 在新项目或现有项目中设置 Plaud Embedded 的说明

何时使用此技能

如果用户尚未实现 Plaud Embedded SDK 或 API，请使用此技能。

注意：如果用户已经拥有 Plaud 客户端凭据、API 密钥和身份验证设置，请考虑使用 plaud-embedded-mobile-sdk-skill 或 plaud-embedded-transcription-api-skill

例如，用户可能会询问：

• 如何开始使用 Plaud Embedded
• 如何开始为其 iOS 或 Android 应用实现 Embedded SDK
• 如何将其应用连接到 Plaud 设备（即 Plaud NotePin S 或 Plaud Note Pro）
• 如何通过身份验证连接到 Plaud 并获取合作伙伴和用户令牌

Plaud 和 Plaud Embedded 背景

Plaud 是用于 AI 笔记和对话录音的录音设备领域的行业领导者。

Plaud 设备包括：

• Plaud Note Pro：纤薄的卡片式设备，可插入手机卡夹，用于录制电话和面对面对话
• Plaud NotePin S：用于录制面对面对话的可穿戴别针

**重要：**Plaud Embedded 目前仅支持 Plaud Note Pro 和 Plaud NotePin S。Plaud Note 和 Plaud NotePin 不受 Plaud Embedded 支持。设备规格请参阅设备文档。

Plaud 设备的常见用例包括：

1. 医生使用 Plaud 转录与患者的问诊内容
2. 外勤销售代表使用 Plaud AI 生成会议笔记

Plaud 的优势不仅在于硬件，还在于其用于音频转录的 ASR 模型。

---

Plaud Embedded 是 Plaud 开发者平台的一部分，供用户构建自己的产品，以集成：

1. Plaud 设备（Plaud NotePin S 和 Plaud Note Pro）
2. Plaud 的 SOTA 转录模型

Plaud Embedded 的核心组件包括：

1. Plaud Developer Portal——用户应在门户中创建应用，以获取客户端凭据
2. 面向 iOS 和 Android 的 Embedded SDK——让用户的移动应用能够连接 Plaud 设备并同步录音文件
3. Transcription API——用于上传音频文件并接收转录内容的 API（可在移动端或后端使用）

**注意：**Android Embedded SDK 已正式发布，功能与 iOS 完全一致（扫描、连接、录音、文件列表／同步／删除、设置、Wi-Fi 配置、Wi-Fi 快速传输和 OTA）。有关当前发布状态，请参阅 Embedded 更新日志。

请阅读这些文档，了解 Plaud Embedded 各组件如何协同工作的概览。

如何为 Plaud Embedded 设置用户的项目

1. 如果用户尚未创建 Plaud Embedded 应用：使用本指南帮助用户创建 Plaud Embedded 应用，并获取其 CLIENT_ID、CLIENT_SECRET 和 API_KEY
   • 用户可以在 Plaud Developer Portal 中完成此操作
2. 用户获得 Plaud Embedded 凭据后，使用 Plaud 身份验证指南构建服务端端点，或编写脚本（用于本地测试）来生成用户令牌
   • 请参考这个 user-token-script.ts，了解如何获取合作伙伴令牌和用户令牌
   • 或者，使用 Plaud Embedded API Playground 生成令牌，并使用自己的客户端凭据体验完整流程（身份验证 → 录音 → 上传 → 转录）

**Partner Token** 是应用级别的（使用 `client_id:secret_key` 进行 Basic 身份验证），用于生成 **User Tokens**。User Token 是用户级别的令牌，Embedded SDK 和 File Upload API 均可使用

为其生成 User Token 的 `user_id` 应为**稳定 ID，长度为 6–120 个字符**

用户获得 Plaud Embedded 凭据并完成身份验证设置后，即可开始使用 Plaud Embedded SDK 和 Transcription API 构建应用！

Embedded SDK 同时支持原生 iOS 和 Android。如果用户想要设置原生应用：

1. 对于原生 iOS 应用，请使用 plaud-embedded-ios-sdk-skill
2. 对于原生 Android 应用，请使用 plaud-embedded-android-sdk-skill

如果用户不构建原生应用，也可以将 Embedded SDK 用作原生插件：

1. 通过 Plaud 的 Expo Native Module 构建 React Native 应用（文档）——代码仓库：embedded-react-native
2. 通过 Flutter 的 platform channels 和原生插件构建 Flutter 应用（文档）——代码仓库：embedded-flutter
3. 通过 Plaud 的 Capacitor 插件将网页应用封装为原生 iOS 应用（文档）——代码仓库：embedded-capacitor

这些插件均实现了基本功能（设备连接、文件同步、转录）。对于 WiFi Fast Transfer 等高级用法，请向插件添加方法，或直接使用原生 iOS SDK。

身份验证 API 参考

• 获取合作伙伴令牌 API
• 刷新合作伙伴令牌 API
• 获取用户令牌 API