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 Token** の発行に使用します。User Token はユーザーレベルのトークンで、Embedded SDK と File Upload API が受け付けるトークンです

User Token の発行対象となる `user_id` は、**6～120 文字の安定した ID** にする必要があります

ユーザーが 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 のプラットフォームチャネルとネイティブプラグインを利用する Flutter アプリ（ドキュメント）— リポジトリ：embedded-flutter
3. Plaud の Capacitor プラグインを利用してネイティブ iOS アプリにラップした Web アプリ（ドキュメント）— リポジトリ：embedded-capacitor

各プラグインは基本機能（デバイス接続、ファイル同期、文字起こし）を実装しています。WiFi Fast Transfer などの高度な用途には、プラグインにメソッドを追加するか、ネイティブ iOS SDK を直接使用してください。

Authentication API リファレンス

• Get Partner Token API
• Refresh Partner Token API
• Get User Token API