ApsaraVideo Live：直播錄製

直播錄製原理

直播錄製的過程，是通過拉取您推上來的直播流，將音視頻封裝成單獨的一個個媒體切片（封裝格式為TS），然後存入您指定的OSS bucket或者存入到點播系統產生點播檔案。直播錄製在工作時遵循以下原則：

• 直播錄製只修改音視頻的封裝格式（RTMP/FLV轉成TS），絕不修改音視頻內容（即編碼層內容）。舉個例子，如果您推上來的直播流是花屏的，那錄製下來的也是花屏的。

• 直播錄製有許可權往使用者bucket寫入錄製檔案，但不會且沒有許可權修改/刪除使用者bucket的任務檔案（包括已寫入的錄製檔案）。使用者bucket中的錄製檔案，完全由您自己管理。

錄製儲存方式

ApsaraVideo for Live提供以下兩種錄製檔案的儲存方式，您可以根據需要進行選擇：

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

• 錄製儲存至VOD：將直播內容進行錄製儲存，並轉入ApsaraVideo for VOD系統中，按點播錄製規則產生點播檔案。ApsaraVideo for VOD支援使用雲剪輯功能對直播流的內容進行剪輯加工，實現ApsaraVideo for Live與短視頻的內容聯動。

錄製檔案的封裝格式

直播錄製支援將直播流錄製成TS/M3U8、MP4、FLV封裝格式的視頻檔案。但是不管是哪種封裝格式，直播錄製都會先將直播流切片成一個個的TS切片，然後再合成對應封裝格式的錄製檔案。

對於M3U8，直播錄製會將TS和M3U8都寫入使用者的bucket（因為M3U8隻是HLS協議中的索引檔案，音視頻資料仍然在TS中）；而對於MP4和FLV，使用者bucket中只會有合成後的MP4和FLV切片。

限制條件

• 錄製儲存至OSS

  錄製儲存至OSS的前提條件是您已建立OSS Bucket，且OSS Bucket必須與播放網域名稱的直播中心同地區，不支援跨地區錄製。具體操作，請參見建立OSS Bucket。

  正常情況下，開通直播服務時，您已自動授權“允許直播服務寫入使用者OSS”，因此直播錄製寫入您指定的bucket時不存在許可權問題。如果該許可權意外被刪除，您可以參考以下方法重新設定：

  • 通過控制台配置：您需要授權ApsaraVideo for Live可將視頻內容寫入OSS產品的許可權，授權後才能將視頻儲存至指定的OSS bucket中。具體操作，請參見配置直播寫入OSS許可權。

  • 通過RAM進行許可權配置：詳情資訊，請參見建立RAM使用者並授權。

• 錄製儲存至VOD

  錄製儲存至VOD的前提條件：您需要先開通ApsaraVideo for VOD服務，且開通點播服務的地區必須與播放網域名稱的直播中心同地區才能將視頻儲存至VOD。ApsaraVideo for VOD服務詳細操作，請參見開通ApsaraVideo for VOD。

• 音視頻編碼格式

  由於直播錄製需要先將直播流切分成TS檔案，因此您推上來的直播流的音視頻編碼格式必須滿足TS封裝格式的要求。根據FLV標準和ISO/IEC 13818-1標準，直播錄製目前僅支援以下編碼格式：

  • 視頻：H264、HEVC、MPEG4

  • 音頻：AAC、MP3

  說明

  如果直播流包含了非以上格式編碼的音視頻，直播錄製可能會出現：無法產生錄製檔案、錄製黑屏、錄製沒有聲音，以及其他一些無法預見的異常情況。

• 異常的直播流

  對於正常的直播流（沒有不支援的編碼格式、幀率穩定、時間戳記單調線性增長），直播錄製均能正常產生錄製檔案。當然，對於偶爾幀率不穩定，時間戳記跳變的流，直播錄製也能做出一定的相容，保證錄製檔案的正常產生。

  但如果推上來的直播流存在嚴重異常（長時間沒有視訊框架，時間戳記增長沒有規律，音視頻頭缺失等），直播錄製可能無法保證正常產生錄製檔案。

不同錄製方式及使用情境

ApsaraVideo for Live提供以下錄製方式，您可根據具體的情境進行選擇和使用：

按網域名稱、AppName、StreamName多層級自動錄製

直播錄製支援按網域名稱、AppName、StreamName多層級的方式進行錄製。您可以指定網域名稱、應用程式名稱或流名稱，錄製某個網域名稱下或App下所有的直播流，也可以精確錄製某一路直播流。

✓ 代表通過控制台或API配置自動錄製規則時對應參數有值，且值不為*，* 代表對應參數值為*。

同一路直播流不能同時選擇錄製到OSS和錄製到VOD，只能選擇其中一種方式。具體實現方式如下：

錄製儲存至OSS

• 通過ApsaraVideo for Live控制台：

  具體操作，請參見錄製儲存至OSS。

• API調用流程：

  1. 配置錄製規則，調用介面請參見AddLiveAppRecordConfig。

  2. 進行推流，詳細內容請參見推流、拉流與播流。

  其他相關API參考：

  API名稱	說明
  DeleteLiveAppRecordConfig	刪除App層級錄製配置，如果不再需要某項規則，可以通過該介面刪除。
  DescribeLiveRecordConfig	查詢所有配置的規則列表.

錄製儲存至VOD

• 通過ApsaraVideo for Live控制台：

  具體操作，請參見錄製儲存至VOD。

• API調用流程：

  1. 配置錄製規則，調用介面請參見AddLiveRecordVodConfig。

  2. 進行推流，詳細內容請參見推流、拉流與播流。

  其他相關API參考：

  API名稱	說明
  DeleteLiveRecordVodConfig	如果不再需要直播錄製轉點播配置，可以通過該介面刪除。
  DescribeLiveRecordVodConfigs	查詢直播轉點播所有配置列表。

按定時任務自動錄製

如果您希望在指定的開始時間和結束時間內對一路直播流進行定時錄製，可以通過調用API的方式來實現定時任務的自動錄製。

實踐樣本

按需錄製

按需錄製的原理是當直播流推流上來之後，直播錄製服務會發送一條HTTP回調給您事先設定的後台服務，通過該回調的返回內容決定是否錄製這條直播流，並且可以動態修改錄製格式和錄製周期。

系統互動如下圖所示，您需要開發圖中的App商務服務，接收HTTP回調，並根據您自身的商務邏輯決定是否錄製。

按需錄製可以通過調用API 的方式來實現：

1. 調用介面添加錄製配置配置錄製規則。其中OnDemand欄位填1，表示通過HTTP回調開啟按需錄製。

2. 調用介面AddLiveRecordNotifyConfig，設定OnDemandUrl欄位。

3. 推流。

4. App商務服務接收到該推流的按需錄製回調，根據自身業務決定是否錄製，返回內容。

5. 直播錄製服務根據按需錄製回調返回的結果，啟動錄製或不啟動錄製。

涉及的API包括：

實踐樣本：

1. 調用AddLiveAppRecordConfig介面，配置指定網域名稱為example.com，AppName為liveBucket****下的所有直播流自動錄製：

   /?AppName=liveApp****
   &DomainName=example.com
   &OssBucket=liveBucket****
   &OssEndpoint=oss-cn-shanghai.aliyuncs.com
   &RecordFormat.1.Format=m3u8
   &<公用請求參數>

2. 調用AddLiveRecordNotifyConfig介面，設定OnDemandUrl欄位為http://example.aliyundoc.com：

   /?DomainName=example.com
   &OnDemandUrl=http://example.aliyundoc.com
   &<公用請求參數>

3. 推流。

4. App商務服務接收到的按需錄製回調為：（詳見按需錄製回調）

   GET /?app=liveApp****&domain=example.com&stream=liveStream****&vbitrate=2000&codec=h264 HTTP/1.1
   Host: demo.aliyundoc.com
   User-Agent: Go-http-client/1.1

5. 根據回調返回的結果：（詳見按需錄製回調）

   • 如果收到以下結果，則進行錄製：

     {
         "ApiVersion" : "1.0",
         "NeedRecord" : true
     }

   • 如果收到以下結果，則不錄製：

     {
         "ApiVersion" : "1.0",
         "NeedRecord" : false
     }

手動錄製

針對直播錄製您還可以直接通過手動的方式實現某條直播流的錄製啟動。如果某條直播流正在錄製，您也可以通過手動的方式停止該直播流的錄製。

手動錄製通過調用API實現：

1. 調用AddLiveAppRecordConfig介面配置錄製規則。設定ondemand=7，表示推流後不自動錄製。

2. 推流。

3. 調用RealTimeRecordCommand介面啟動錄製。

4. （如果需要）調用RealTimeRecordCommand介面停止錄製。

實踐樣本：

• 手動啟動錄製。

  如果直播流example.com/liveApp****/liveStream****正在推流，可以按以下方式調用RealTimeRecordCommand介面啟動錄製：

  /?AppName=liveApp****
  &DomainName=example.com
  &StreamName=liveStream****
  &Command=start
  &<公用請求參數>

• 手動停止錄製

  如果直播流example.com/liveApp****/liveStream****正在錄製，可以按以下方式調用RealTimeRecordCommand介面停止錄製：

  /?AppName=liveApp****
  &DomainName=example.com
  &StreamName=liveStream****
  &Command=stop
  &<公用請求參數>

錄製檔案擷取

注意事項

• 如果想知道自動錄製（按網域名稱/AppName/StreamName多層級自動錄製、按定時任務自動錄製）是否生效，可以設定錄製回調，詳情請參見直播錄製回調。

• 如果希望針對每個錄製檔案做即時處理，可通過建立錄製內容索引檔案實現，詳情請參見錄製內容合并與提取。

• 錄製周期為當前直播轉為錄製檔案後的最大時間長度，直播時間長度超過設定的錄製周期後，將產生新檔案，錄製周期支援15-360分鐘。可在直播控制台上配置錄製模板時進行設定，也可以調用介面AddLiveRecordVodConfig（錄製到VOD）或介面AddLiveAppRecordConfig（錄製到OSS）進行設定。

• 如果在一個錄製周期內，直播流發生了斷流，但是在3分鐘內，該直播流又推上來了，那麼仍會在同一個錄製檔案中繼續錄製，不會產生新的錄製檔案。這就意味著，一條直播流必須斷流超過3分鐘，才會產生最後一個錄製檔案。

• ApsaraVideo for Live支援觸發拉流，當使用觸發拉流網域名稱對應的播放地址進行播放時，會自動觸發阿里雲ApsaraVideo for Live服務進行拉流直播，無人播放時則不會回來源站點進行拉流。自動錄製、按需錄製、手動錄製功能應用在觸發拉流情境時，如果觸發拉流無人播放，則不會回來源站點拉流，自動錄製、按需錄製、手動錄製同樣也不會進行錄製。

常見問題

直播錄製常見問題