すべてのプロダクト
Search
ドキュメントセンター

ApsaraVideo Live:OSSに記録を保存する

最終更新日:Nov 13, 2024

ApsaraVideo Liveは、ライブセンターで受信した取り込みストリームを記録し、設定された記録ルールに基づいてObject storage Service (OSS) の指定された保存場所に記録を保存できるライブストリーム記録機能を提供します。 ストリームをM3U8、MP4、Flash video (FLV) 、Dynamic Adaptive Streaming over HTTP (DASH) 形式のビデオファイルに記録できます。 このトピックでは、録音をOSSに保存する方法について説明します。

前提条件

OSSバケットが作成されます。 詳細については、「OSS の設定」をご参照ください。

説明

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

背景情報

ライブストリームの終了後にコンテンツを再生または変更する場合は、ApsaraVideo liveが提供するライブストリーム録画機能を使用できます。 録音をOSSに保存する前に、録音テンプレートを作成する必要があります。 録音テンプレートでパラメータを設定する必要があります。 パラメータは、格納場所、記録サイクル、M3U8MP4FLVCMAFなどの格納フォーマット、およびトランスコードされたストリーム記録を可能にするかどうかを含みます。

重要

ライブストリームの録画は、OSSまたはApsaraVideo VODに保存できます。 ApsaraVideo VODに録画を保存する方法の詳細については、「ApsaraVideo VODに録画を保存する」をご参照ください。

録音テンプレートの作成

  1. ApsaraVideo Live コンソール にログインします。

  2. 左側のナビゲーションウィンドウで、[機能管理]> [記録] を選択します。 [録画] ページで、[OSS] タブをクリックします。

  3. 記録をOSSに保存するストリーミングドメインを選択します。

  4. 追加をクリックします。

  5. 録音テンプレートを設定します。

    image

    表 1 記録テンプレートパラメーター

    パラメーター

    説明

    アプリ名

    アプリケーションの名前。 アプリケーション名パラメーターの値は、取り込みURLで指定されたアプリケーション名と同じである必要があります。 それ以外の場合、設定は有効になりません。 ドメイン名の下にあるすべてのアプリケーションでライブストリームを録画する場合は、アスタリスク (*) を入力します。

    ストリーム名

    ストリーム名を指定すると、特定のライブストリームの録画をOSSに保存できます。 [アプリケーション名] パラメーターで指定されたアプリケーション内のすべてのライブストリームを記録する場合は、アスタリスク (*) を入力します。

    説明
    • [アプリケーション名] または [ストリーム名] パラメーターの値は、最大255文字で、英数字、ハイフン (-) 、およびアンダースコア (_) を使用できます。

    • [アプリケーション名] または [ストリーム名] パラメーターの値としてアスタリスク (*) を入力する場合は、次の点に注意してください。

      • アスタリスク (*) は文字列と一致することはできませんが、既存のアプリケーションまたはストリームの名前のみが一致します。

      • アスタリスク (*) はワイルドカード文字として使用できません。

    保管場所

    ストレージの場所。

    説明

    バケットには、標準バケットとメディアバケットが含まれます。 標準バケットは、ストレージに使用されるOSSバケットです。 メディアバケットは、ApsaraVideo Media Processing用にカスタマイズされたバケットです。 ApsaraVideo Media Processingを使用して、メディアバケットに保存されているビデオをトランスコードできます。 標準バケットとメディアバケットは、バケットリストで区別されません。 ApsaraVideo Media Processingで入力ビデオを処理する場合は、出力ビデオを保存するメディアバケットを選択できるように、使用するメディアバケットの名前を覚えておく必要があります。

    マージの中断期間

    ストリーム中断期間が指定された期間を超えると、新しい記録が生成されます。 このパラメータの値は15〜21600秒です。

    ストレージ形式

    有効な値: flvm3u8mp4cmaf

    説明

    少なくとも1つのストレージ形式を選択します。 CMAF形式とM3U8形式を同時に選択することはできません。

    命名規則

    さまざまな形式の録音のストレージパスの命名規則。 デフォルト値:

    • M3U8: レコード /{AppName}/{StreamName}/{EscapedStartTime }_{ EscapedEndTime }

    • TS: record/{AppName}/{StreamName}/{UnixTimestamp }_{ Sequence}

    • FMP4: record/{AppName}/{StreamName}/{UnixTimestamp }_{ Sequence}

    • MP4: record/{AppName}/{StreamName}/{EscapedStartTime }_{ EscapedEndTime }

    • FLV: record/{AppName}/{StreamName}/{EscapedStartTime }_{ EscapedEndTime }

    例:

    [アプリケーション名]liveApp **** に、[ストリーム名]liveStream **** に設定した場合、m3u8形式の録音のストレージパスはrecord/liveApp ****/liveStream ****/{EscapedStartTime }_{ EscapedEndTime } になります。

    TSファイル期間

    TSセグメントの期間。 デフォルト値:30。 有効な値: 5 ~ 30。 単位は秒です。

    録音サイクル

    記録サイクルは、15〜360分の範囲とすることができる。 指定された記録サイクルを超えた場合、システムは記録命名規則に基づいて新しい記録を生成します。

    説明

    記録サイクルは、指定されたライブストリームから変換されるVODファイルの最大長を指定します。

    image

    表 2. トランスコードされたストリーム記録のパラメータ

    パラメーター

    説明

    トランスコードストリーム記録

    [トランスコードストリーム録画] をオンにし、次のパラメーターを設定します。

    ストレージ形式

    有効な値: flvm3u8mp4cmaf

    説明

    少なくとも1つのストレージ形式を選択します。 CMAF形式とM3U8形式を同時に選択することはできません。

    命名規則

    さまざまな形式の録音のストレージパスの命名規則。 デフォルト値:

    • M3U8: transcodeRecord/{AppName}/{StreamName}/{EscapedStartTime }_{ EscapedEndTime }

    • TS: transcodeRecord/{AppName}/{StreamName}/{UnixTimestamp }_{ Sequence}

    • FMP4: transcodeRecord/{AppName}/{StreamName}/{UnixTimestamp }_{ シーケンス}

    • MP4: transcodeRecord/{AppName}/{StreamName}/{EscapedStartTime }_{ EscapedEndTime }

    • FLV: transcodeRecord/{AppName}/{StreamName}/{EscapedStartTime }_{ EscapedEndTime }

    例:

    アプリケーション名liveApp **** に、ストリーム名liveStream **** に、トランスコードテンプレートIDをlldに設定した場合、m3u8形式のトランスコードされたストリーム録音のストレージパスはtranscodeRecord/liveApp ****/liveStream ****_lld/{EscapedStartTime}

    TSファイル期間

    TSセグメントの期間。 デフォルト値:30。 有効な値: 5 ~ 30。 単位は秒です。

    録音サイクル

    記録サイクルは、15〜360分の範囲とすることができる。 指定された記録サイクルを超えた場合、システムは記録命名規則に基づいて新しい記録を生成します。

    説明

    記録サイクルは、指定されたライブストリームから変換されるVODファイルの最大長を指定する。

    トランスコードテンプレートID

    すべてのテンプレートまたは最大10個の個別のトランスコードテンプレートを選択できます。

    トランスコードテンプレートにされているアプリケーション名が、録画テンプレートのアプリケーション名と同じであることを確認します。 利用可能なコード変換テンプレートがない場合は、まずコード変換テンプレートを追加します。 詳細については、「デフォルトのトランスコードの設定」をご参照ください。

  6. OKをクリックします。

記録コールバックの設定

説明

AddLiveRecordNotifyConfig操作を呼び出して、ドメイン名の記録コールバックを設定できます。 詳細については、「AddLiveRecordNotifyConfig」をご参照ください。

コールバックメソッドとパラメーターの詳細については、「コールバックの管理」をご参照ください。

  1. ApsaraVideo Live コンソール にログインします。

  2. 左側のナビゲーションウィンドウで、[機能管理]> [記録] を選択します。 [録画] ページで、[OSS] タブをクリックします。

  3. 録音コールバックを設定するストリーミングドメインを選択します。

  4. [設定の変更] をクリックします。

  5. [コールバックURLの設定] ダイアログボックスで、コールバックURLを入力します。 コールバックURLはアカウントに属している必要があります。

  6. OKをクリックします。

録音機能を無効にする

録音機能を使用する必要がない場合は、追加した録音テンプレートを削除して、機能を無効にすることができます。

テンプレートの削除時にライブストリーミングが進行中の場合、ApsaraVideo live はテンプレートに基づいて録画を続行します。 削除は、後続の取り込みストリームに対して適用されます。

よくある質問

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

次のステップ

OSSバケットに保存されている録音を表示および管理できます。 詳細については、「録音の管理」をご参照ください。

関連ドキュメント

ライブストリームのコンテンツを編集および処理する場合は、ApsaraVideo VODに録画を保存できます。 詳細については、「ApsaraVideo VODでの録画の保存」をご参照ください。

関連ドキュメント

ライブストリーム録画の詳細については、「ライブストリーム録画」をご参照ください。