本文介紹錄製事件回調配置方式和回調內容樣本。
回調配置方式
直播錄製回調支援控制台和API進行配置。
- 控制台配置錄製回調請參見配置錄製回調。
- 調用介面配置錄製回調請參見添加直播錄製回調配置。
回調樣本
直播錄製回調包括錄製狀態回調和檔案產生回調。
- 錄製狀態回調：在檔案開始錄製與結束錄製時發出，主要表示檔案已經開始和結束錄製。
- 檔案產生回調：在檔案產生時發出，主要包括檔案名稱，開始結束時間與時間長度資訊。
回調內容為JSON格式，通過HTTP POST請求包含在請求體（Request Body）中發送到錄製回調配置中的NotifyUrl接收方解析請求體擷取回調內容。
錄製狀態回調參數和樣本
說明通過調用介面進行回調配置，錄製狀態回調內容當NeedStatusNotify=true時可以產生。
NeedStatusNotify是AddLiveRecordNotifyConfig介面的一個入參，用於表示是否需要錄製任務狀態回調。
表 1. 錄製狀態回調參數 參數 描述 domain 錄製的播流網域名稱。 app 應用程式名稱。 stream 流名。 event 事件名，取值： - record_started：錄製已經成功開始。
- record_paused：錄製已經成功暫停。
- record_resumed：錄製已經成功恢複繼續錄製。
錄製狀態回調參數樣本{ "domain": "gs_domain", "app": "gs_app", "stream": "gs_stream", "event": "record_started" }檔案產生回調參數和樣本
表 2. 檔案產生回調參數 參數 描述 domain 錄製的播流網域名稱。 app 應用程式名稱。 stream 流名。 uri 目標錄製檔案在使用者錄製OSS Bucket下的路徑。 duration 目標錄製檔案錄製內容時間長度，單位：秒。 start_time 錄製開始時間。Unix時間戳記，單位：秒。 stop_time 錄製結束時間。Unix時間戳記，單位：秒。 push_args 推流參數中以callback_為首碼的參數，如callback_arg1、callback_myid等。 說明- 回調樣本，適用於所有沒有定製回調模版的客戶。
- 同一個參數名只能有一個參數值，如果傳入多個值，回調僅包含第一個值。如推流參數包含
callback_args1=value1&callback_args1=value2，回調中仍為"callback_args1": "value1"。
檔案產生回調參數樣本{ "domain": "demo.aliyundoc.com", "app": "liveApp****", "stream": "liveStream****", "uri": "liveApp****/liveStream****/0_2017-03-08-23:09:46_2017-03-08-23:10:40.flv", "duration": 69.403, "start_time": 1488985786, "stop_time": 1488985840, "push_args": { "callback_args1": "value1", "callback_myid": "1231389741" } }
參考文檔
瞭解更多回調資訊請參見回調管理。