コンテンツにスキップ
Documentation

RTCの記録

ワークスペースのRTCに録音が含まれていることをご確認ください プラン。 参加者に通知し、ご利用のケースに必要な同意を取得してください。アプリケーション側で 、録音中であることを示す目立つインジケーターと、同意取得のプロセスを用意する必要があります。

録画開始時には、参加者がキャプチャしたいトラックをすでに公開している必要があります。 現在のリリースでは、選択されたトラックのみがキャプチャされます。 後から公開を開始した新しい参加者やトラックは、自動的に追加されません。 音のないセッションや空のセッションは、録画テストとして有用ではありません。

  1. 公開ルームに参加し、対象の音声・動画を配信してください。
  2. 選択 録音を始める 呼び出し制御において。
  3. 開く 録画 を使用してジョブを確認してください。 更新 ステータスを再読み込みするには。
  4. 選択 停止 完了したら、アクティブな録画を停止するか、ルームを終了してください。
  5. ジョブが完了するまでお待ちください。 ready、その後、そのトラックのダウンロードボタンをご利用ください。

ご自身の通話から退出することは、録画を明示的に停止したり、 ルームを終了させたりすることとは異なります。連携機能をご利用の際は、 録音 API。 録音の音声をテキストに変換するには、以下をご覧ください。 文字起こし.

ステータス意味
queued開始リクエストが受理されました
recordingキャプチャが実行中、または開始中です
processingキャプチャが終了し、出力の最終処理が行われています
readyトラックファイルは、認証済みのユーザーのみがダウンロード可能です
failedキャプチャまたは処理が正常に完了しませんでした

1つのルームに対して、キューに登録されているジョブ、録音中のジョブ、または処理中のジョブは、一度に1つしか存在できません。 以下を 202 完了条件として、startレスポンスまたは成功したstopリクエストを指定してください。 録画リストまたは署名付き recording.ready イベント。

出力結果は 個々のMKVトラック、単一の編集済み会議動画ではありません。 各トラックには、メディアの種類、ソース、参加者、サイズ、およびトラックIDが識別情報として含まれています。 再生の対応状況は異なります。別の形式や組み合わせたレイアウトが必要な場合は、互換性のあるプレーヤーを使用するか、独自のメディア処理 ワークフローをご利用ください。

現在のリリースでは、録音は1時間まで、1トラックあたり約 1 GiBまでと制限されています。遅れて参加したトラックは自動的に記録されません。

録音の削除、保存、または配信

Section titled “録音の削除、保存、または配信”

録音を削除するには DELETE /v1/recordings/{recordingId}:以下に送信されます ゴミ箱へ移動し、30日後に自動削除されます。それまでは、以下の方法で復元可能です: POST /v1/recordings/{recordingId}/restore。ゴミ箱内の録音も、 録音ストレージの容量にカウントされます。早めに完全に削除するには、 ゴミ箱から POST /v1/recordings/{recordingId}/purge:RTCが回答します 202 (status: "deleting")、削除はまもなく完了し、 recording.purged が提供されます。

CHAMPREP は、ご利用のプランの保存期間中、録音データを保持します。保存期間が終了すると、 録音データは同様にゴミ箱へ移動します。この機能が含まれるプランでは、RTCは 完了した各録音データをお客様のバケットにもコピーし、それらのコピーは RTCによって削除されることはありません。詳しくは 録音の削除 および ストレージはご自身でご用意ください.

バックエンドでは、以下のキーを使用します。 recordings:read を選択したトラックの ダウンロードURLをリクエストします。APIは、録音およびキーのプロジェクトへのアクセス権限を確認APIします。その後、 5分後に有効期限が切れるRTCドメインのURLを返します。

この一時的なURLをお持ちの方は、有効期限内であれば誰でもご利用いただけます。 別途ブラウザへのログインは不要です。このURLは、 アプリケーションによって承認されたユーザーのみに提供するか、すべてのダウンロードをアプリケーションのセッションに紐付ける必要がある場合は、独自の認証済み バックエンドを通じてファイルをストリーミングしてください。

  • ダウンロードURLを、公開ページ、分析データ、ログ、または共有メッセージに記載しないでください。
  • オブジェクトパスを構築するのではなく、返されたURLをそのまま取得してください。
  • 有効期限が切れた場合は、再度アクセス権限を確認した上で、新しいURLをリクエストしてください。
  • 発行キーAPIを取り消すと、そのキーに対する未処理のダウンロード許可が無効になります。
  • 認証済みのコピーをダウンロードしても、その保存済みコピーは取り消し可能にはなりません。

使用方法 Webhook これにより、ダウンロード許可を繰り返し要求することなく、 処理が完了したことをアプリケーションに通知できます。