V1 から V2 への移行ガイド

主な変更点

• TTL が有効なオプションではなくなり、すべてのリクエストに履歴を使用する必要があります。
• API で、ストレージ用に GCP バケットがサポートされるようになりました。
• API がよりレストフルになるように再設計されました。
  • 状態完了ファイルがコールバックサーバーに置き換えられました。
• SSR で、Unity Cloud 組織のサービスアカウントの使用が必要になりました。
• 重複排除機能が削除されました。複製リクエストに対する

  409

  エラーコードが表示されなくなりました。
• 自動終了機能が削除されました。リクエストは常に、履歴リクエストの全継続時間にわたって実行されます。
• オーディオをデコードするためにリクエストを行う必要がなくなりました。Vivox によって状態が自動的に管理され、最終的にチャンネル内の話し手ごとに 1 つの .WAV ファイルが作成されます。

認証の変更

1. SSR で、すべてのリクエストに Unity Authentication の使用が必要になりました。
   • 組織またはプロジェクトをまだ作成していない場合は、作成してください。詳細については プロジェクトの作成方法 を参照してください。
2. プロジェクトと組織を作成したら、その詳細をアカウントマネージャーと共有する必要があります。アカウントマネージャーが、組織に対して SSR を有効にします。
3. SSR が有効になったら、API で認証を行うためのサービスアカウントを作成する必要があります。サービスアカウントの作成方法 を参照してください。
4. サービスアカウントのページで、サービスアカウントにアクセス許可を割り当てます。Manage organization permissions を選択し、

   Server Side Recording Processor Role

   を割り当てます。これにより、このサービスアカウントが SSR API にアクセスできるようになります。

   

5. このサービスアカウントを使用するには、サービスアカウントで認証を行う方法 を参照してください。

API の変更

リクエストの変更

1. destination_credentials

   は、

   storageOptions

   内に含まれるようになりました。V1 API と同様に AWS を使用するには、特定のコードセグメントを置き換える必要があります。

   置き換え元のコード	置き換え先のコード
   { "destination_credentials": { "bucket": "my-bucket", "access_key_id": "secret", "secret_access_key": "secret" } }	{ "storageOptions": { "provider": "aws", "credentials": { "bucket": "my-bucket", "accessKeyId": "secret", "secretAccessKey": "secret" } } }

2. target_type

   フィールドは削除してください。V2 API は、チャンネルサブスクリプションのみをサポートします。

3. ttl

   フィールドは削除されました。

   history

   フィールドを使用して、レコーディングの継続期間を指定してください。

callbackUri

SSR デコーダー

コールバックサーバー

status_complete

status_decoded