ApsaraVideo for Live錄製並儲存至OSS - ApsaraVideo Live

ApsaraVideo for Live錄製功能，是將直播中心接收到的推流資料進行錄製，並將錄製後的檔案按配置的錄製規則儲存至阿里雲OSS指定的儲存位置。支援將直播流錄製成M3U8、MP4、FLV、CMAF格式的視頻檔案。本文為您介紹錄製儲存至OSS的操作指引。

前提條件

您已建立OSS Bucket。具體操作，請參見配置OSS。

說明

OSS Bucket必須與網域名稱的直播中心同地區，不支援跨地區錄製。

背景資訊

如果您需要在直播結束後再次觀看或修改直播內容，可使用ApsaraVideo for Live提供的直播錄製功能。直播錄製儲存至OSS需配置錄製模板，錄製模板需要對錄製檔案的輸出格式（M3U8、MP4、FLV、CMAF）、儲存位置、錄製周期以及是否進行轉碼流錄製等相關參數進行配置。

重要

同一路直播流不能同時選擇錄製到OSS和錄製到VOD，只能選擇一種方式儲存。關於錄製儲存至VOD，請參見錄製儲存至VOD。

配置錄製模板

登入ApsaraVideo for Live控制台。
在左側導覽列選擇功能管理>直播錄製，進入直播錄製頁面，選擇儲存至OSS配置頁簽。
選擇待配置的播流網域名稱。
單擊添加。

配置錄製模板。

表 1. 錄製模板參數

參數	描述
AppName	視頻的應用程式名稱，輸入的AppName必須與直播推流地址的AppName保持一致，方可生效。如果您想要進行網域名稱層級錄製，輸入星號（*）可。
StreamName	儲存至OSS支援流層級的錄製。您只需輸入指定的流名稱即可。如果您想要進行全部流錄製，即該AppName下的流全部錄製，輸入星號（）可。說明 AppName與StreamName參數支援英文、數字、短劃線（-）、底線（_）符號，長度限制在255字元以內。 AppName與StreamName參數如果使用（）號需注意（）號不能匹配任一字元串，只能通配當前已有的應用程式名稱或流名稱。（）號無法在字串中進行通配。
儲存位置	選擇儲存位置。說明儲存Bucket列表中包含標準Bucket和媒體Bucket。標準Bucket是OSS Bucket，用於儲存。媒體Bucket是MPS定製的Bucket，存入媒體Bucket中的視頻，可執行MPS轉碼任務。目前Bucket列表中，未對Bucket做區分。如果您需要將視頻轉成媒體檔案，需要自行記住對應的媒體Bucket的名稱，方便您後期視頻轉成媒體檔案儲存位置的選擇。
斷流拼接時間長度	直播斷流時間長度超過設定的拼接時間長度後，將會產生新檔案，斷流拼接時間長度支援15~21600秒。
儲存格式	支援flv、m3u8、mp4、cmaf四種格式。說明至少配置一個儲存格式，其中CMAF格式不能與M3U8格式同時選擇。
儲存規則	預設的儲存路徑為 M3U8：record/{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 } 樣本 AppName為liveApp**，StreamName為liveStream，當錄製m3u8格式的儲存路徑為record/liveApp/liveStream**/{EscapedStartTime}_{EscapedEndTime }。
單個TS時間長度	單個切片時間長度，預設為30秒。支援單個TS時間長度範圍5~30秒。
錄製周期	錄製周期範圍為15分鐘~360分鐘，最大支援6小時錄製。超過6小時，系統將按照錄製命名規則產生新檔案。說明錄製周期為當前直播轉為點播檔案後的最大時間長度。

表 2. 錄製轉碼流參數

參數	描述
錄製轉碼流	開啟錄製轉碼流開關，配置參數。
儲存格式	支援flv、m3u8、mp4、cmaf四種格式。說明至少配置一個儲存格式，其中CMAF格式不能與M3U8格式同時選擇。
儲存規則	預設的儲存路徑為 M3U8：transcodeRecord/{AppName}/{StreamName}/{EscapedStartTime }_{EscapedEndTime } TS：transcodeRecord/{AppName}/{StreamName}/{UnixTimestamp}_{Sequence} FMP4：transcodeRecord/{AppName}/{StreamName}/{UnixTimestamp}_{Sequence} MP4：transcodeRecord/{AppName}/{StreamName}/{EscapedStartTime }_{EscapedEndTime } FLV：transcodeRecord/{AppName}/{StreamName}/{EscapedStartTime }_{EscapedEndTime } 樣本 AppName為liveApp**，StreamName為liveStream，轉碼模板ID為lld，當錄製m3u8格式的實際儲存路徑為transcodeRecord/liveApp/liveStream**_lld/{EscapedStartTime}_{EscapedEndTime }。
單個TS時間長度	單個切片時間長度，預設為30秒。支援單個TS時間長度5~30秒。
錄製周期	錄製周期範圍為15分鐘~360分鐘，最大支援6小時錄製。超過6小時，系統將按照錄製命名規則產生新檔案。說明錄製周期為當前直播轉為點播檔案後的最大時間長度。
轉碼模板ID	支援選擇指定轉碼模板（上限10個）或全部轉碼模板。轉碼模板所屬AppName需和錄製模板保持一致才可生效，若無轉碼模板，請先添加轉碼模板，請參見通用轉碼。

單擊確定。

配置錄製回調

說明

您還可以通過AddLiveRecordNotifyConfig介面添加網域名稱層級錄製回調配置，請參見添加直播錄製回調配置。

回調方式和回調內容，請參見回調管理。

登入ApsaraVideo for Live控制台。
在左側導覽列選擇功能管理>直播錄製，進入直播錄製頁面，選擇儲存至OSS配置頁簽。
選擇待配置的播流網域名稱。
單擊修改配置。
在彈出的回調設定視窗中，輸入需要配置的回調地址（回調地址為您自身擁有的地址）。
單擊確定完成回調設定。

關閉錄製服務

如果您不需要使用該服務，可以刪除已添加的錄製模板，即可關閉錄製服務。

刪除模板時若直播已開始，會繼續按照刪除前的模板錄製，刪除錄製模板會在下次推流時生效。

常見問題

直播錄製常見問題

後續步驟

您可以查看和管理儲存至指定OSS儲存位置的錄製檔案，請參見錄製檔案管理。

ApsaraVideo Live：錄製儲存至OSS