ApsaraVideo Live：直播錄製

方法一：控制台配置

1. 登入ApsaraVideo for Live控制台。

2. 在左側導覽列選擇功能管理 > 直播錄製。在錄製配置頁簽，選擇儲存至VOD。

3. 選擇待配置的播流網域名稱，並且單擊添加。

4. 配置錄製模板。

   基礎錄製設定

   參數	描述
   AppName	應用程式名稱，必須與推流地址的 AppName 保持一致方可生效。若需對網域名稱下所有應用生效，填寫 *。
   StreamName	流名稱。支援精確匹配，即錄製特定流。若需錄製當前 AppName 下的所有直播流，填寫 *。
   儲存應用空間	錄製檔案儲存體在點播服務建立的應用空間。若未開啟應用空間，則不顯示該欄位。
   儲存地址	可選擇點播服務當前地區下建立的儲存地址。預設使用點播系統配置的預設上傳地址。
   錄製內容	支援錄製源流或轉碼流，兩者可同時選擇。 選擇轉碼流時，可指定轉碼模板（上限10個）或選擇全部轉碼模板。 轉碼模板的 AppName 為*或與錄製模板一致時，轉碼流錄製才會生效。
   觸發方式	支援通過以下方式觸發錄製：自動錄製、回調確認、推流參數設定、手動錄製。 詳情請參見錄製觸發方式。
   儲存格式	支援 M3U8、FLV、MP4 格式。選擇多格式時，支援按格式分別配置點播視訊設定。
   錄製周期	單個錄製檔案的最大時間長度。當直播期間超過此閾值，系統將產生新檔案。預設值：180分鐘。範圍：15-360分鐘。
   斷流拼接時間長度	直播中斷時，當斷流時間不超過此時間長度，重新推流後的內容會自動合并至同一個檔案。當斷流時間超過此時間長度，則錄製為新檔案。預設值：180秒。範圍：15-21600秒。
   單個切片時間長度	單個 TS 切片的時間長度。僅選擇 M3U8 格式時顯示。 預設值：30秒。範圍：5-30秒。

   點播視訊設定

   儲存至 VOD 時，您可通過此設定，使用ApsaraVideo for VOD的ApsaraVideo for Media Processing能力來處理錄製的檔案。若您選擇了多個錄製格式，可按格式分別配置。

   參數	描述
   自動合并	開啟後，可在直播錄製結束後自動將多個錄製周期檔案合并成一個錄製檔案，並儲存到 VOD。原錄製檔案仍然保留。
   視頻處理	使用ApsaraVideo for VOD服務對錄製的視頻進行ApsaraVideo for Media Processing。 源視頻：對每個錄製周期檔案單獨處理。 合并後視頻：對合并後的檔案進行處理（開啟自動合并後顯示）。
   處理方式	支援用轉碼模板組處理和用工作流程處理兩種方式。
   處理模板	選擇從ApsaraVideo for VOD服務擷取的轉碼模板組或工作流程範本。 注意：僅支援選擇網域名稱直播中心所在地區建立的模板。
   視頻分類	設定錄製檔案在ApsaraVideo for VOD服務中的分類。

5. 單擊確定建立錄製模板。

方法二：API 配置

調用AddLiveRecordVodConfig介面，添加錄製儲存至 VOD 配置。範例程式碼：

// Parameter settings for API request
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"))
        // Request-level configuration rewrite, can set Http request parameters, etc.
        // .requestConfiguration(RequestConfiguration.create().setHttpHeaders(new HttpHeaders()))
        .build();

部分參數說明

• OnDemand

  錄製觸發方式。有效值：0（自動錄製），1（回調確認），2（推流參數設定），7（手動錄製）。詳情請參見錄製觸發方式。

• DelayTime

  斷流拼接時間長度（秒）。當斷流時間不超過此時間長度，重新推流後的內容會自動合并至同一個檔案。當斷流時間超過此時間長度，則錄製為新檔案。

• RecordContent、TranscodeTemplates

  指定錄製源流或轉碼流。錄製轉碼流時，需指定轉碼模板 ID。

• RecordFormat：設定儲存格式及點播視訊配置。其中：

  • AutoCompose：開啟後，可在直播錄製結束後，自動將多個錄製周期檔案合并成一個錄製檔案。

  • VideoProcess、ProcessMethod、ProcessTemplateId：使用ApsaraVideo for VOD的轉碼或工作流程範本，來處理原錄製檔案或自動合并的視頻。

完整參數說明請參見AddLiveRecordVodConfig - 添加直播錄製轉點播配置。

方法一：控制台配置

1. 登入ApsaraVideo for Live控制台。

2. 在左側導覽列選擇功能管理 > 直播錄製。在錄製配置頁簽，選擇儲存至OSS。

3. 選擇待配置的播流網域名稱，並且單擊添加。

4. 配置錄製模板。支援錄製源流或轉碼流，兩者可同時選擇。

   基礎錄製設定

   參數	描述
   AppName	應用程式名稱，必須與推流地址的 AppName 保持一致方可生效。若需對網域名稱下所有應用生效，填寫 *。
   StreamName	流名稱。支援精確匹配，即錄製特定流。若需錄製當前 AppName 下的所有直播流，填寫 *。
   儲存位置	可選擇當前地區在 OSS 中建立的 Bucket。 說明 儲存 Bucket 分為兩類： 標準 Bucket：用於常規檔案儲存體 媒體 Bucket：專用於視頻轉碼處理，存入該類型的檔案可自動觸發 MPS 轉碼任務 當前系統未對 Bucket 類型進行標識區分，如需執行視頻轉碼，請自行記錄所使用的媒體 Bucket 名稱，以確保轉碼後的媒體檔案儲存位置準確。
   斷流拼接時間長度	直播中斷時，當斷流時間不超過此時間長度，重新推流後的內容會自動合并至同一個檔案。當斷流時間超過此時間長度，則錄製為新檔案。預設值：180秒。範圍：15-21600秒。
   觸發方式	支援通過以下方式觸發錄製：自動錄製、回調確認、推流參數設定、手動錄製。 詳情請參見錄製觸發方式。

   錄製源流

   參數	描述
   儲存格式	支援 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 為*或與錄製模板一致時，轉碼流錄製才會生效。
   儲存格式	支援 M3U8、FLV、MP4、CMAF 四種格式。可選擇多個格式，但不能同時選擇 M3U8 和 CMAF 格式。
   儲存規則	錄製檔案的命名方式。預設路徑： M3U8、FLV、MP4: transcodeRecord/{AppName}/{StreamName}_{轉碼模板ID}/{EscapedStartTime}_{EscapedEndTime} TS、fMP4: transcodeRecord/{AppName}/{StreamName}_{轉碼模板ID}/{UnixTimestamp}_{Sequence}
   單個切片時間長度	單個 TS 切片的時間長度。僅選擇 M3U8 和 CMAF 格式時顯示。 預設值：30秒。範圍：5-30秒。
   錄製周期	單個錄製檔案的最大時間長度。當直播期間超過此閾值，系統將產生新檔案。預設值：180分鐘。範圍：15-360分鐘。

5. 單擊確定建立錄製模板。

方法二：API 配置

調用AddLiveAppRecordConfig介面，添加錄製儲存至 OSS 配置。範例程式碼：

// Parameter settings for API request
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"))
        // Request-level configuration rewrite, can set Http request parameters, etc.
        // .requestConfiguration(RequestConfiguration.create().setHttpHeaders(new HttpHeaders()))
        .build();

部分參數說明

• OnDemand

  錄製觸發方式。有效值：0（自動錄製），1（回調確認），2（推流參數設定），7（手動錄製）。詳情請參見錄製觸發方式。

• DelayTime

  斷流拼接時間長度（秒）。當斷流時間不超過此時間長度，重新推流後的內容會自動合并至同一個檔案。當斷流時間超過此時間長度，則錄製為新檔案。

• RecordFormat

  源流儲存格式及錄製參數，包括 Format（儲存格式）、OssObjectPrefix（儲存規則）、SliceDuration（切片時間長度）、CycleDuration（錄製周期）等。

• TranscodeTemplates、TranscodeRecordFormat

  錄製轉碼流時，指定轉碼模板 ID 列表和轉碼流的儲存格式及錄製參數。

完整參數說明請參見AddLiveAppRecordConfig - 添加錄製配置。