ApsaraVideo Live:ライブストリーム录音

ライブストリームのレコーディングの仕組み

ライブストリーム録画機能は、ライブストリームから録画を生成するために使用されます。 この機能を使用すると、ApsaraVideo Liveは、取り込んだストリームを取得し、オーディオデータとビデオデータをTS形式の複数の個別のメディアセグメントにカプセル化します。 TSセグメントは、指定したOSSバケットに保存されるか、ApsaraVideo VODに保存されます。 ApsaraVideo Liveは、録画プロセスで次の原則に準拠しています。

• ApsaraVideo Liveは、オーディオおよびビデオデータのコンテナ形式をRTMP (Real-Time Messaging Protocol) またはFLVからTSにのみ変換します。 ただし、ApsaraVideo Liveは、オーディオおよびビデオコンテンツ、つまりコーディングレイヤーのコンテンツを変更することはありません。 たとえば、取り込んだライブストリームがぼやけている場合、録音もぼやけています。

• ApsaraVideo Liveには、バケットに録音を書き込む権限があります。 ただし、バケット内のタスクファイル (保存された記録を含む) を変更または削除する権限はありません。 バケット内の録音を管理する唯一の特権があります。

録音の保存

ApsaraVideo Liveは、以下の録画保存方法を提供します。 ビジネス要件に基づいていずれかの方法を使用できます。

• 記録をOSSに保存する: 記録を保存するために使用されるOSSバケットは、ストリーミングドメインのライブセンターと同じリージョンに存在する必要があります。 クロスリージョン記録はサポートされていません。

• ApsaraVideo VODに録画を保存する: ライブストリームはApsaraVideo VODに録画および保存されます。 記録は、VOD記録設定に基づいて生成される。 ApsaraVideo VODのオンライン編集機能を使用して、ライブストリームのビデオコンテンツを編集および処理し、短いビデオを作成できます。

録音のコンテナ形式

録画機能を使用すると、TS、M3U8、MP4、およびFLV形式のファイルにライブストリームを録画できます。 コンテナ形式に関係なく、ApsaraVideo Liveはまずライブストリームを複数の個別のTSセグメントにスライスし、指定されたコンテナ形式で録画を生成するためにそれらを構成します。

M3U8形式の場合、ApsaraVideo LiveはTSセグメントとM3U8プレイリストの両方をバケットに保存します。 これは、M3U8プレイリストがHTTPライブストリーミング (HLS) プロトコルのインデックスファイルとしてのみ使用され、オーディオデータとビデオデータがTSセグメントに別々に格納されるためです。 MP4およびFLV形式では、作成されたMP4およびFLVセグメントのみがバケットに保存されます。

制限事項

• 記録をOSSに保存

  ストリーミングドメインのライブセンターと同じリージョンにあるOSSバケットを作成した場合にのみ、OSSに録音を保存できます。 クロスリージョン記録はサポートされていません。 詳細については、「OSSバケットの作成」をご参照ください。

  ApsaraVideo Liveを有効化すると、ApsaraVideo LiveがデフォルトでOSSバケットにデータを書き込む権限を付与しているとみなされます。 したがって、ApsaraVideo Liveには、指定したバケットに録画を保存する権限があります。 権限が誤って削除された場合は、次の方法を使用して再構成できます。

  • コンソールで権限を設定します。 指定したバケットにビデオデータを保存する前に、ApsaraVideo LiveがOSSにビデオデータを書き込むことを許可する必要があります。 詳細については、「OSSのApsaraVideo Liveへの書き込み権限の付与」をご参照ください。

  • RAM (Resource Access Management) を使用して権限を設定します。 詳細については、「RAMユーザーの作成とRAMユーザーへの権限付与」をご参照ください。

• ApsaraVideo VODで録音を保存

  ApsaraVideo VODに録画を保存する前に、ApsaraVideo VODを有効化する必要があります。 ApsaraVideo VODを有効化するリージョンは、ストリーミングドメインのライブセンターが存在するリージョンと同じである必要があります。 詳細については、「ApsaraVideo VODの有効化」をご参照ください。

• オーディオとビデオのエンコード形式

  ApsaraVideo Liveは、最初にライブストリームをTSセグメントにスライスする必要があります。 したがって、取り込むライブストリームのオーディオおよびビデオのエンコード形式は、TS形式の要件を満たす必要があります。 FLV規格およびISO/IEC 13818-1規格によると、記録機能は次のエンコード形式のみをサポートしています。

  • ビデオ: H.264、HEVC、およびMPEG-4

  • オーディオ: AACとMP3

  説明

  ライブストリームに、前述のいずれの形式でもエンコードされていないオーディオおよびビデオデータが含まれている場合、録音プロセスで次の予期しない例外が発生する可能性があります。

• 異常なライブストリーム

  ApsaraVideo Liveは、次の要件を満たす通常のライブストリームから録画を生成できます。ライブストリームは、サポートされている形式のいずれかでエンコードされ、安定したフレームレートを持ち、単調および線形に増加するタイムスタンプを持ちます。 時折フレームレートが不安定になったりタイムスタンプがジャンプしたりするライブストリームの場合、ApsaraVideo liveは幅広い互換性により録画を生成することもできます。

  ただし、取り込まれたライブストリームに次の重大な例外が発生した場合、ApsaraVideo Liveは録画を生成できない場合があります。ビデオフレームが長時間検出されない、タイムスタンプが単調かつ線形に増加しない、またはオーディオとビデオのヘッダーが欠落しています。

さまざまな記録方法とシナリオ

ApsaraVideo Liveは、次の録画方法を提供します。 シナリオに基づいて記録方法を選択できます。

ドメイン名、アプリケーション、またはストリームレベルでの記録

ApsaraVideo Liveを使用すると、ドメイン名、アプリケーション、またはストリームレベルでライブストリームを録画できます。 ドメイン名またはアプリケーション名を指定して、ドメイン名またはアプリケーションの下にあるすべてのライブストリームを記録できます。 ストリーム名を指定してライブストリームを記録することもできます。

チェックマーク (✓) は、コンソールで設定する記録テンプレート、またはAPI操作を呼び出して設定する記録ルールで、パラメーターの値がアスタリスク (*) 以外であることを示します。

ライブストリームの録画をOSSとApsaraVideo VODの両方に保存することはできません。 次のセクションでは、OSSまたはApsaraVideo VODに録画を保存する方法について説明します。

記録をOSSに保存

• ApsaraVideo Liveコンソール:

  ApsaraVideo Liveコンソールを使用して録画をOSSに保存する方法については、「録画をOSSに保存する」をご参照ください。

• API呼び出し:

  1. AddLiveAppRecordConfig操作を呼び出して、記録ルールを設定します。 詳細については、「AddLiveAppRecordConfig」をご参照ください。

  2. ストリーム取り込みを実行します。 詳細については、「ストリームの取り込み、ストリームのプル、およびストリーミング」をご参照ください。

  次の表に、関連するその他のAPI操作について説明します。

  API 操作	説明
  DeleteLiveAppRecordConfig	ルールが不要になった場合、アプリケーションの記録設定を指定するルールを削除します。
  DescribeLiveRecordConfig	すべての設定済みルールを照会します。

ApsaraVideo VODで録音を保存

• ApsaraVideo Liveコンソール:

  ApsaraVideo Liveコンソールを使用してApsaraVideo VODに録画を保存する方法については、「ApsaraVideo VODに録画を保存する」をご参照ください。

• API呼び出し:

  1. AddLiveRecordVodConfig操作を呼び出して、記録ルールを設定します。 詳細については、「AddLiveRecordVodConfig」をご参照ください。

  2. ストリーム取り込みを実行します。 詳細については、「ストリームの取り込み、ストリームのプル、およびストリーミング」をご参照ください。

  次の表に、関連するその他のAPI操作について説明します。

  API 操作	説明
  DeleteLiveRecordVodConfig	設定が不要になった場合は、live-to-VOD設定を削除します。
  DescribeLiveRecordVodConfigs	live-to-VOD設定を照会します。

スケジュールされたタスクに基づく自動記録

指定された期間内にライブストリームを記録する場合は、APIを呼び出して、スケジュールどおりにライブストリームを自動的に記録できます。

例

オンデマンド記録

オンデマンド録画の原則は、ライブストリームが取り込まれると、ApsaraVideo liveがHTTPコールバックをプリセットAppServerに送信することです。 コールバックの内容に基づいてライブストリームを録画するかどうかを決定し、録画形式と録画サイクルを動的に変更できます。

次の図に示すAppServerを開発して、HTTPコールバックを受信し、ビジネスロジックに基づいて記録を開始するかどうかを判断する必要があります。

API呼び出し:

1. AddLiveAppRecordConfig操作を呼び出して、記録ルールを設定します。 OnDemandパラメーターを1に設定して、ApsaraVideo Liveがライブストリームを録画するかどうかを尋ねるHTTPコールバックを送信できるようにします。

2. AddLiveRecordNotifyConfig操作を呼び出して、OnDemandUrlパラメーターを設定します。

3. ストリーム取り込みを実行します。

4. AppServerは、オンデマンド記録のコールバックを受信し、ビジネスロジックに基づいてライブストリームを記録するかどうかを決定し、応答を送信します。

5. ApsaraVideo Liveは、AppServerからの応答に基づいて録画を開始するかどうかを決定します。

次の表に、オンデマンド録音に使用されるAPI操作を示します。

例

1. AddLiveAppRecordConfig操作を呼び出して、名前がliveBucket **** であるアプリケーションのドメイン名example.comの下にあるすべてのライブストリームを自動的に記録するようにApsaraVideo Liveを設定します。

   /?AppName=liveApp****
   &DomainName=example.com
   &OssBucket=liveBucket****
   &OssEndpoint=oss-cn-shanghai.aliyuncs.com
   &RecordFormat.1.Format=m3u8
   &<Common request parameters>

2. AddLiveRecordNotifyConfig操作を呼び出して、OnDemandUrlパラメーターを http://example.aliyundoc.com に設定します。

   /?DomainName=example.com
   &OnDemandUrl=http://example.aliyundoc.com
   &<Common request parameters>

3. ストリーム取り込みを実行します。

4. AppServerによって受信されたオンデマンド録音コールバックを確認します。 詳細については、「オンデマンド録音のコールバック」をご参照ください。

   GET /?app=liveApp****&domain=example.com&stream=liveStream****&vbitrate=2000&codec=h264 HTTP/1.1
   Host: demo.aliyundoc.com
   User-Agent: Go-http-client/1.1

5. コールバックの応答に基づいて記録を開始するかどうかを決定します。 詳細については、「オンデマンド録音のコールバック」をご参照ください。

   • 次の応答を受信した場合、記録を開始します。

     {
         "ApiVersion" : "1.0",
         "NeedRecord" : true
     }

   • 次の応答を受信した場合、記録を開始しないでください。

     {
         "ApiVersion" : "1.0",
         "NeedRecord" : false
     }

手動録画

ApsaraVideo Liveを使用すると、ライブストリームを手動で録画できます。 ライブストリームを録画している場合は、ライブストリームの録画を手動で停止することもできます。

API呼び出し:

1. AddLiveAppRecordConfig操作を呼び出して、記録ルールを設定します。 OnDemandパラメーターを7に設定します。これは、取り込まれたライブストリームを自動的に録画しないことを指定します。

2. ストリーム取り込みを実行します。

3. RealTimeRecordCommand操作を呼び出して、記録を開始します。

4. (オプション) RealTimeRecordCommand操作を呼び出して、録音を停止します。

例

• 手動で録音を開始

  ライブストリームexample.com/liveApp****/liveStream**** が取り込まれている場合は、RealTimeRecordCommand操作を呼び出して録画を開始します。

  /?AppName=liveApp****
  &DomainName=example.com
  &StreamName=liveStream****
  &Command=start
  &<Common request parameters>

• 手動で録音を停止する

  ライブストリームexample.com/liveApp****/liveStream**** が録画中の場合は、RealTimeRecordCommand操作を呼び出して録画を停止します。

  /?AppName=liveApp****
  &DomainName=example.com
  &StreamName=liveStream****
  &Command=stop
  &<Common request parameters>

録音を取得する

使用上の注意

• ドメイン名、アプリケーション、またはストリームレベルでの自動記録、またはスケジュールされたタスクに基づく自動記録が有効になるかどうかを知りたい場合は、記録コールバックを設定できます。 詳細については、「ライブストリーム録画のコールバック」をご参照ください。

• 各録音をリアルタイムで処理する場合は、インデックスファイルを作成できます。 詳細については、「ライブストリーム録画」をご参照ください。

• 記録サイクルは、記録の最大長である。 ライブストリームの持続時間が記録サイクルを超える場合、複数の記録が生成される。 記録サイクルは15〜360分の値に設定できます。 ApsaraVideo Liveコンソールで録画テンプレートを設定するときに、録画サイクルを設定できます。 AddLiveRecordVodConfigを呼び出して、ApsaraVideo VODに録画されるライブストリームの録画サイクルを設定したり、AddLiveAppRecordConfigを呼び出して、OSSに録画されるライブストリームの録画サイクルを設定したりすることもできます。

• ライブストリームが記録サイクル中に中断されるが、3分以内に再開される場合、ストリームは中断の前後で同じ記録に記録される。 ライブストリームが3分以上中断された場合にのみ、ライブストリームの新しい録音が生成されます。

• ApsaraVideo Liveは、トリガーされたストリームプルをサポートします。 対応するドメイン名のストリーミングURLがストリーミングに使用されている場合、ApsaraVideo Liveは自動的にトリガーされてライブストリームをプルします。 誰もライブストリームを視聴していない場合、ApsaraVideo liveはライブストリームをオリジンからプルしません。 この場合、自動記録、オンデマンド記録、手動記録も無効となります。

よくある質問

FAQについてライブストリーム录音