ApsaraVideo Live:ライブストリーム録画

方法 1：コンソール

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

2. 左側のナビゲーションペインで、機能管理 > ライブストリームのレコーディング を選択します。録画設定 タブで、VOD を選択します。

3. 設定するストリーミングドメインを選択し、追加 をクリックします。

4. 録画テンプレートを設定します。

   基本録画設定

   パラメーター	説明
   [アプリケーション名]	この設定を有効にするには、アプリケーション名をストリームインジェスト URL の AppName と同じにする必要があります。ドメイン配下のすべてのアプリケーションに適用する場合は、* を入力します。
   [ストリーム名]	完全一致で特定のストリームを録画できます。現在の AppName 配下のすべてのライブストリームを録画する場合は、* を入力します。
   [ストレージアプリケーションの容量]	録画ファイルの保存先となるワークスペースです。ApsaraVideo VOD サービスで作成します。ワークスペースが有効になっていない場合、このフィールドは表示されません。
   [ストレージアドレス]	ApsaraVideo VOD サービスで作成した、現在のリージョンにある保存先を選択できます。デフォルトでは、システムは ApsaraVideo VOD で設定されたデフォルトのアップロードアドレスを使用します。
   [録画コンテンツ]	[ソースストリーム]または[トランスコードストリーム]を録画できます。両方を同時に選択できます。 [トランスコードストリーム]を選択した場合、最大 10 個のトランスコードテンプレートを指定するか、すべてのトランスコードテンプレートを選択できます。 トランスコードストリームの録画は、トランスコードテンプレートの AppName が * であるか、録画テンプレートの AppName と同じ場合にのみ有効になります。
   [トリガー方法]	録画は、自動録画、コールバックの確認 (コンソールのみ)、アップストリーミングパラメータの設定、手動録画、[オンデマンド録画] (API のみ) のいずれかの方法でトリガーできます。 詳細については、「録画のトリガー方法」をご参照ください。
   [ストレージ形式]	M3U8、FLV、MP4 形式をサポートしています。複数の形式を選択した場合、形式ごとに VOD 設定を個別に設定できます。
   [録画時間]	単一の録画ファイルの最大長です。ライブストリームの継続時間がこのしきい値を超えると、システムは新しいファイルを生成します。デフォルト：180分。範囲：15～360分。
   [ストリーム切断後のマージ時間]	ストリームの中断がこの時間より短い場合、録画は同じファイルで再開されます。中断がこの時間を超えると、新しいファイルが作成されます。デフォルト：180秒。範囲：15～21,600秒。
   [単一セグメント時間]	単一の TS セグメントの長さです。M3U8 形式を選択した場合にのみ表示されます。 デフォルト：30秒。範囲：5～30秒。

   VOD 設定

   録画を ApsaraVideo VOD に保存する場合は、これらの設定を使用して、ApsaraVideo VOD のメディア処理機能で録画ファイルを処理できます。複数の録画形式を選択した場合は、個別に設定できます。

   パラメーター	説明
   [自動マージ]	有効にすると、異なる録画サイクルの複数ファイルが、ライブストリームの終了後に 1 つの録画ファイルに自動的にマージされ、ApsaraVideo VOD に保存されます。元の録画ファイルは保持されます。
   [動画処理]	ApsaraVideo VOD サービスを使用して、録画した動画を処理します。 [ソース動画]各録画サイクルファイルを個別に処理します。 [マージ後の動画]マージ済みファイルを処理します (自動マージを有効にした後に表示されます)。
   [処理方法]	対応：[トランスコードテンプレートグループでの処理]、[ワークフローでの処理]。
   [処理テンプレート]	ApsaraVideo VOD サービスから、トランスコードテンプレートグループまたはワークフローテンプレートを選択します。 注意：選択できるのは、ドメインのライブセンターと同じリージョンで作成したテンプレートのみです。
   [動画カテゴリ]	ApsaraVideo VOD サービスで、録画ファイルのカテゴリを設定します。

5. OK をクリックして、録画テンプレートを作成します。

方法 2：API

AddLiveRecordVodConfig API を呼び出して、録画を ApsaraVideo VOD に保存するための設定を追加します。サンプルコード：

// API リクエストのパラメーター設定
AddLiveRecordVodConfigRequest.RecordFormat recordFormat0 = AddLiveRecordVodConfigRequest.RecordFormat.builder()
        .format("m3u8")
        .sliceDuration(30)
        .autoCompose("ON")
        // オリジナル動画と合成動画の両方を処理します
        .videoProcess("origin,compose")
        .processMethod("transcode")
        .processTemplateId("e2d796d3bb5fd8049d32bff62f94****")
        .tags("sports")
        .build();

AddLiveRecordVodConfigRequest addLiveRecordVodConfigRequest = AddLiveRecordVodConfigRequest.builder()
        .regionId("<お使いの RegionID>")
        .domainName("<お使いの DomainName>")
        .appName("live")
        .streamName("stream1")
        .cycleDuration(3600)
        .spaceId("app-1000000")
        .storageLocation("<お使いの StorageLocation>")
        .onDemand(0)
        // ソースストリームとトランスコードストリームの両方を録画します
        .recordContent("raw,transcode")
        .delayTime(180)
        .recordFormat(java.util.Arrays.asList(recordFormat0))
        .transcodeTemplates(java.util.Arrays.asList("sd"))
        // リクエストレベルの設定を上書きします。HTTP リクエストパラメーターなどを設定できます。
        // .requestConfiguration(RequestConfiguration.create().setHttpHeaders(new HttpHeaders()))
        .build();

主要パラメーター

• OnDemand

  録画のトリガー方法です。有効値：0 (自動録画)、1 (オンデマンド録画)、2 (インジェストパラメーターによる設定)、7 (手動録画)。詳細については、「録画のトリガー方法」をご参照ください。

• DelayTime

  中断されたストリームの結合時間 (秒) です。ストリームの中断がこの時間より短い場合、録画は同じファイルで再開されます。中断がこの時間を超えると、新しいファイルが作成されます。

• RecordContent、TranscodeTemplates

  ソースストリームまたはトランスコードストリームを録画するかどうかを指定します。トランスコードストリームを録画する場合は、トランスコードテンプレート ID を指定する必要があります。

• RecordFormat：保存形式と VOD 設定を指定します。これには次が含まれます：

  • AutoCompose：有効にすると、異なる録画サイクルの複数ファイルが、ライブストリームの終了後に 1 つのファイルに自動的にマージされます。

  • VideoProcess、ProcessMethod、ProcessTemplateId：ApsaraVideo VOD のトランスコードテンプレートまたはワークフローテンプレートを使用して、元の録画ファイルまたはマージされた動画を処理します。

パラメーターの詳細については、AddLiveRecordVodConfig - Add a configuration to store live recordings in VOD をご参照ください。

方法1：コンソール

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

2. 左側のナビゲーションバーで機能管理 > ライブストリームのレコーディング を選択し、録画設定 タブで OSS を選択します。

3. 設定するストリーミングドメインを選択し、追加 をクリックします。

4. 録画テンプレートを設定します。ソースストリーム、トランスコードストリーム、またはその両方を録画するように選択できます。

   基本録画設定

   パラメーター	説明
   [アプリケーション名]	アプリケーション名。設定を有効にするには、プッシュ URL の AppName と一致させる必要があります。ドメイン配下のすべてのアプリケーションに設定を適用する場合は、* を入力します。
   [ストリーム名]	ストリーム名。特定のストリームを録画するために、正確なストリーム名を指定できます。現在の AppName 配下のすべてのライブストリームを録画するには、* を入力します。
   [格納場所]	現在のリージョン にある OSS で作成されたバケットを選択できます。 説明 ストレージバケットには2つのタイプがあります。 標準バケット：一般的なファイルストレージに使用されます。 メディアバケット：動画トランスコーディング専用です。このタイプのバケットに保存されたファイルは、ApsaraVideo Media Processing (MPS) のトランスコーディングジョブを自動的にトリガーできます。 現在、システムではバケットの種類は表示されません。動画トランスコーディングを実行する必要がある場合は、トランスコードされたファイルが正しく保存されるように、メディアバケット名を記録しておいてください。
   [切断のスプライス時間]	ライブストリームの中断がこの時間より短い場合、同じファイルへの録画が再開されます。中断時間がこれより長い場合は、新しいファイルが作成されます。デフォルト：180 秒。範囲：15～21,600 秒。
   [トリガー方法]	録画は、自動録画、コールバックの確認、アップストリーミングパラメータの設定、手動録画 の方法でトリガーできます。 詳細については、「録画のトリガー方法」をご参照ください。

   ソースストリームの録画

   パラメーター	説明
   [格納形式]	M3U8、FLV、MP4、CMAF 形式をサポートしています。複数の形式を選択できますが、M3U8 と CMAF を同時に選択することはできません。
   [命名規則]	録画ファイルの命名規則。デフォルトパス： M3U8、FLV、MP4： record/{AppName}/{StreamName}/{EscapedStartTime}_{EscapedEndTime} TS、fMP4： record/{AppName}/{StreamName}/{UnixTimestamp}_{Sequence}
   [単一セグメント時間]	単一の TS セグメントの長さ。これは M3U8 または CMAF 形式を選択した場合にのみ表示されます。 デフォルト：30 秒。範囲：5～30 秒。
   [録画時間]	単一の録画ファイルの最大時間。ライブストリームの時間がこのしきい値を超えると、システムは新しいファイルを生成します。デフォルト：180 分。範囲：15～360 分。

   トランスコードストリームの録画

   パラメーター	説明
   [トランスコードストリームの選択]	録画するトランスコードストリームを選択します。最大10個のトランスコーディングテンプレートを指定するか、すべてを選択できます。 トランスコードストリームの録画を機能させるには、トランスコーディングテンプレートの AppName が * であるか、録画テンプレートの AppName と一致する必要があります。
   [格納形式]	M3U8、FLV、MP4、CMAF 形式をサポートしています。複数の形式を選択できますが、M3U8 と CMAF を同時に選択することはできません。
   [命名規則]	録画ファイルの命名規則。デフォルトパス： M3U8、FLV、MP4： transcodeRecord/{AppName}/{StreamName}_{TranscodingTemplateID}/{EscapedStartTime}_{EscapedEndTime} TS、fMP4： transcodeRecord/{AppName}/{StreamName}_{TranscodeTemplateID}/{UnixTimestamp}_{Sequence}
   [単一セグメント時間]	単一の TS セグメントの長さ。これは M3U8 または CMAF 形式を選択した場合にのみ表示されます。 デフォルト：30 秒。範囲：5～30 秒。
   [録画時間]	単一の録画ファイルの最大時間。ライブストリームの時間がこのしきい値を超えると、システムは新しいファイルを生成します。デフォルト：180 分。範囲：15～360 分。

5. OK をクリックして、録画テンプレートを作成します。

方法2：API

AddLiveAppRecordConfig API を呼び出して、OSS に録画を保存するための設定を追加します。サンプルコード：

// API リクエストのパラメーター設定
AddLiveAppRecordConfigRequest.TranscodeRecordFormat transcodeRecordFormat0 = AddLiveAppRecordConfigRequest.TranscodeRecordFormat.builder()
        .sliceDuration(30)
        .sliceOssObjectPrefix("transcodeRecord/{AppName}/{StreamName}_{TranscodeTemplateID}/{UnixTimestamp}_{Sequence}")
        .ossObjectPrefix("transcodeRecord/{AppName}/{StreamName}_{TranscodeTemplateID}/{EscapedStartTime}_{EscapedEndTime}")
        .cycleDuration(900)
        .format("m3u8")
        .build();

AddLiveAppRecordConfigRequest.RecordFormat recordFormat0 = AddLiveAppRecordConfigRequest.RecordFormat.builder()
        .sliceDuration(30)
        .format("m3u8")
        .cycleDuration(900)
        .sliceOssObjectPrefix("record/{AppName}/{StreamName}/{UnixTimestamp}_{Sequence}")
        .ossObjectPrefix("record/{AppName}/{StreamName}/{Sequence}_{EscapedStartTime}_{EscapedEndTime}")
        .build();

AddLiveAppRecordConfigRequest addLiveAppRecordConfigRequest = AddLiveAppRecordConfigRequest.builder()
        .domainName("<Your DomainName>")
        .appName("live")
        .ossEndpoint("<Your OssEndpoint>")
        .ossBucket("<Your OssBucket>")
        .streamName("stream1")
        .onDemand(0)
        .delayTime(180)
        .recordFormat(java.util.Arrays.asList(recordFormat0))
        .transcodeRecordFormat(java.util.Arrays.asList(transcodeRecordFormat0))
        .transcodeTemplates(java.util.Arrays.asList("sd"))
        // リクエストレベルの設定を上書きし、HTTP リクエストパラメーターなどを設定できます
        // .requestConfiguration(RequestConfiguration.create().setHttpHeaders(new HttpHeaders()))
        .build();

主要なパラメーター

• OnDemand

  録画のトリガー方法。有効な値：0 (自動録画) 、1 (オンデマンド録画) 、2 (インジェストパラメーター設定) 、7 (手動録画) 。詳細については、「録画のトリガー方法」をご参照ください。

• DelayTime

  中断されたストリームを結合する期間 (秒単位) 。ライブストリームの中断がこの時間より短い場合、同じファイルへの録画が再開されます。中断時間がこれより長い場合は、新しいファイルが作成されます。

• RecordFormat

  ソースストリームのストレージ形式と録画パラメーター。Format (ストレージ形式) 、OssObjectPrefix (命名規則) 、SliceDuration (セグメントの長さ) 、CycleDuration (録画周期) が含まれます。

• TranscodeTemplates、TranscodeRecordFormat

  トランスコードストリームを録画する場合、トランスコーディングテンプレート ID のリストと、トランスコードストリームのストレージ形式および録画パラメーターを指定します。

パラメーターの完全な説明については、「AddLiveAppRecordConfig - 録画設定の追加」をご参照ください。