ApsaraVideo Live:レコーディング

方法 1：コンソール

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

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

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

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

   基本的な録画設定

   パラメーター	説明
   [アプリケーション名]	アプリケーション名は、有効にするにはストリーム取り込み URL の AppName と同じである必要があります。ドメイン配下のすべてのアプリケーションに適用するには、* を入力します。
   [ストリーム名]	特定のストリームを録画するための完全一致に対応しています。現在の AppName 配下のすべてのライブストリームを録画するには、* を入力します。
   [ストレージアプリケーションの容量]	ApsaraVideo VOD サービスで作成された、録画ファイルの保存先となるワークスペースです。ワークスペースが有効になっていない場合、このフィールドは表示されません。
   [ストレージアドレス]	現在のリージョンの ApsaraVideo VOD サービスで作成された保存場所を選択できます。デフォルトでは、システムは ApsaraVideo VOD で設定されたデフォルトのアップロードアドレスを使用します。
   [録画コンテンツ]	ソースストリーム または トランスコードストリーム を録画できます。両方を同時に選択できます。 トランスコードストリーム を選択すると、最大 10 個のトランスコードテンプレートを指定するか、すべてのトランスコードテンプレートを選択できます。 トランスコードストリームの録画は、トランスコードテンプレートの AppName が * であるか、録画テンプレートの AppName と同じ場合にのみ有効になります。
   [トリガー方法]	録画は、次の方法でトリガーできます: 自動録画、コールバックの確認、アップストリーミングパラメータの設定、および手動録画です。 詳細については、「録画のトリガー方法」をご参照ください。
   [ストレージ形式]	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("<Your RegionID>")
        .domainName("<Your DomainName>")
        .appName("live")
        .streamName("stream1")
        .cycleDuration(3600)
        .spaceId("app-1000000")
        .storageLocation("<Your 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 (取り込みパラメーター設定)、3 (手動録画)、7 (コールバック確認)。詳細については、「録画のトリガー方法」をご参照ください。

• DelayTime

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

• RecordContent、TranscodeTemplates

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

• RecordFormat： ストレージフォーマットと VOD 設定を設定します。これには以下が含まれます：

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

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

詳細については、「AddLiveRecordVodConfig - ライブ録画を 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}/{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 - 録画設定の追加」をご参照ください。