Live Recording

本ガイドでは、Media Acceleration Live BroadcastのRecording APIを用いてライブストリーム記録の管理、自動化、コントロール方法について解説します。

記録システムは3層構造で構築されています：

1. Templates — 記録方法の定義：出力フォーマット、保存先、ファイル分割、コールバック設定。
2. Rules — 記録タイミングの定義：特定のストリームにテンプレートを紐付け、自動的に記録を開始します。
3. Real-Time Controls — オンデマンド記録：任意のアクティブなストリームに対して、手動で録画セッションを開始または停止することができます。

テンプレートは基盤となります。RulesおよびReal-Time Controlsの両方がtemplateIdによってテンプレートを参照するため、他のAPIを利用する前に少なくとも1つのテンプレートを作成する必要があります。

警告: すべての録画APIは、ユーザーごと5分間に300リクエストのレート制限が共有されています。リクエストが制限されないよう、統合計画を適切にご検討ください。

録画テンプレートの作成（テンプレートAPI）

録画パラメータテンプレートは、録画時の動作（出力の保存場所、ファイル名の命名規則、セグメント化のタイミング、コールバック通知の送信先など）をシステムに指示します。

自動・手動どちらの録画にもtemplateIdが必要となりますので、テンプレートは必ず最初に作成してください。

警告: 現在1つ以上の録画ルールに関連付けられているテンプレートは削除できません。削除する前に、すべての録画ルールとの紐付けを解除してください。

自動録画ルールの設定（Rule API）

テンプレート作成後、「Recording Rules」を設定することで、自動的に録画を行うことができます。Recording RuleはtemplateIdを1つ以上のライブストリームに紐づけて、対象ストリームがライブ配信を開始すると自動で録画が始まります。

ストリームの対象指定は3つの粒度レベルで行うことができます:

• Delivery Domain — Domain配下の全ストリームを記録します。
• アプリケーション名 — 特定アプリケーションパス配下の全ストリームを記録します。
• ストリーム名 — 特定のストリームのみを記録します。

システムは最長一致の原則に基づいてルールを適用します。特定のストリーム名向けのルールは、より広範なDomainレベルのルールよりも優先されます。これにより、広い範囲のデフォルト値を指定しつつ、必要に応じて個々のストリーム単位で挙動を上書きできます。

警告: 現在アクティブまたは録画実行中のルールは削除できません。録画が完了するか停止してから、ルールを削除してください。

オンデマンド録画のトリガー（リアルタイム制御API）

自動ルールとは別に、ライブストリームを即座に録画する必要がある場合、リアルタイム制御APIを使用して手動で録画セッションの開始と停止を行ってください。

ワークフローの接続方法：

1. templateIdと最大5件のストリーム配信URLを使ってStartRealTimeRecordを呼び出します。
2. このAPIは、その録画タスクを一意に識別するpersistentIdを返します。
3. 録画はストリームが自然に終了するまで、または同じpersistentIdでStopRealTimeRecordを呼び出すまで継続されます。

プロのヒント： Start APIから返されたpersistentIdを必ず保存してください。これは配信終了前に特定の録画セッションを停止する唯一の方法です。