ApsaraVideo Live：事件回調

控制台配置步驟

1. 登入ApsaraVideo for Live控制台。

2. 在左側導覽列單擊功能管理> 事件回調，進入事件回調頁面。

3. 選擇您要配置的推流網域名稱。推流回調只能在推流網域名稱下進行配置。

4. 在回調設定頁簽下，開啟推流回調開關，配置以下參數：

   • 回調類型：選擇推/斷流回調或推流例外狀況事件回調。

   • 回調地址：輸入您自身擁有的回調地址。推/斷流回調使用HTTP GET請求，例外狀況事件回調使用HTTP POST請求。

   • 回調鑒權：選擇是否開啟鑒權。如需鑒權，開啟鑒權開關並輸入鑒權Key，鑒權流程請參見回調鑒權。

5. 單擊確定。

API 配置方式

推斷流回調

推斷流回調會將參數封裝在MultiDict內。

推斷流回調中開播（publish）狀態回調邏輯

RTMP推流在阿里雲直播服務收到On Publish訊息後2秒內，如果推流端不主動斷開，阿里雲直播服務就會發推流成功回調。

假設您有推流網域名稱A和播流網域名稱B，如果您的網域名稱B使用拉流直播（固定拉流和觸發回源拉流）需要回調，請在網域名稱A配置推流回調。配置後網域名稱B的拉流回調邏輯與上一條一致，建聯後預設2秒無主動斷開即認為拉流成功。

當10秒內（包含10秒）沒有流資料推送到直播中心時，直播服務就會自動斷開推流。

推斷流回調參數

推流狀態回調參數樣本：

http://1.1.X.X?action=publish&ip=192.168.0.1&id=world&app=example.aliyundoc.com&appname=liveApp****&time=1609220385&usrargs={使用者參數}&node=cdnvideocenter01020711****.cm3&height=720&width=1280

斷流狀態回調參數樣本：

http://1.1.X.X?action=publish_done&ip=192.168.0.0&id=world&app=example.aliyundoc.com&appname=liveApp****&time=1609220385&usrargs={使用者參數}&node=cdnvideocenter01020711****.cm3&height=720&width=1280

推流例外狀況事件回調

推流例外狀況事件回調參數

異常類型

推流例外狀況事件回調參數樣本：

{
  "action": "publish_exception_notify",
  "domain": "demo.aliyundoc.com",
  "appname": "liveApp****",
  "stream": "liveStream****",
  "ip": "141.01.****",
  "time": "1739760710",
  "type": "5002",
  "event_time": "1739760710"
}

控制台配置步驟

1. 登入ApsaraVideo for Live控制台。

2. 在左側導覽列單擊功能管理> 事件回調，進入事件回調頁面。

3. 選擇您要配置的播流網域名稱。錄製回調只能在播流網域名稱下進行配置。

4. 在回調設定頁簽下，開啟錄製回調開關，配置以下參數：

   • 回調地址：輸入您自身擁有的回調地址。錄製回調使用HTTP POST請求。

   • 觸發事件：選擇檔案產生回調或錄製狀態回調。

   • 按需回調地址：配置按需錄製方式後，當開始推直播流時，直播錄製服務會發送一條HTTP回調給事先設定的按需回調地址，通過該回調的返回內容決定是否錄製這條直播流。按需回調地址預設*，表示關閉按需錄製功能。

   • 回調鑒權：選擇是否開啟鑒權。如需鑒權，開啟鑒權開關並輸入鑒權Key，鑒權流程請參見回調鑒權。

5. 單擊確定。

API 配置方式

錄製狀態回調

在檔案開始錄製與結束錄製時發出，主要表示檔案已經開始和結束錄製。

錄製狀態回調參數

錄製狀態回調參數樣本

{
  "domain": "demo.aliyundoc.com",
  "app": "liveApp****",
  "stream": "liveStream****",
  "event": "record_started"
}

檔案產生回調

在檔案產生時發出，主要包括檔案名稱，開始結束時間與時間長度資訊。

檔案產生回調參數

檔案產生回調參數樣本

推流URL為：rtmp://demo.aliyundoc.com/liveApp****/liveStream****?callback_args1=value1&callback_myid=1231389741

則回調內容為：

{
  "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",
  "file_url": "http://****.oss-****.aliyuncs.com/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"
  }
}

錄製錯誤回調

錄製過程中若因源流異常或OSS寫入失敗導致錄製或轉封裝（MP4/FLV）出錯，將觸發錯誤回調。

錄製錯誤回調參數

錄製錯誤回調參數樣本

錄製錯誤

{
  "domain": "example.com",
  "app": "live",
  "stream": "stream123",
  "event": "record_error",
  "error_info": {
    "code": "TsSegmenterFail",
    "message": "ts segmenter error"
  }
}

錯誤碼列表：

轉封裝錯誤

{
  "domain": "example.com",
  "app": "live",
  "stream": "stream123",
  "event": "transformat_error",
  "error_info": {
    "code": "PermissionDenied.ResourceAccess",
    "message": "MTS not authorized to operate on the OutputBucket"
  },
  "file_info": {
    "uri": "record/live/stream123/2025-11-19-03-17-03_2025-11-19-03-28-39.flv",
    "start_time": 1763493420,
    "stop_time": 1763494119
  }
}

錯誤碼列表：

請求參數

請求樣本

GET /?app=seq_all&domain=demo.aliyundoc.com&stream=ondemand8&vbitrate=2000&codec=h264 HTTP/1.1
Host: pull.aliyundoc.com
User-Agent: Go-http-client/1.1
Accept-Encoding: gzip

返回參數

返回樣本

{
  "ApiVersion": "1.0",
  "NeedRecord": true,
  "Interval": {
    "Mp4": 300,
    "Flv": 120,
    "M3U8": 180
  },
  "Format": ["mp4","flv"]
}

返回參數處理

• 錄製服務會根據返回的參數配置，對既有配置進行覆蓋：

  • Interval：覆蓋錄製模板中配置的原有錄製周期。

  • Format：與錄製模板中原配置的格式取交集。如果沒有交集，則不會錄製這路直播流。

• 若返回的 HTTP 狀態代碼非 200，系統將判定此次回調調用失敗。

• 響應 Body 的大小上限為 2,048 位元組。出於安全考慮，超出此限制的內容將被截斷。

控制台配置步驟

1. 登入ApsaraVideo for Live控制台。

2. 在左側導覽列單擊功能管理> 事件回調,進入事件回調頁面。

3. 選擇您要配置的播流網域名稱。截圖回調只能在播流網域名稱下進行配置。

4. 在回調設定頁簽下，開啟截圖回調開關，配置以下參數：

   • 回調地址：輸入您自身擁有的回調地址。截圖回調使用HTTP POST請求。

   • 回調鑒權：選擇是否開啟鑒權。如需鑒權，開啟鑒權開關並輸入鑒權Key，鑒權流程請參見回調鑒權。

5. 單擊確定。

API 配置方式

截圖檔案回調參數

截圖檔案回調參數樣本

{
  "Event": "Snapshot",
  "DomainName": "demo.aliyundoc.com",
  "AppName": "liveApp****",
  "StreamName": "liveStream****",
  "OssBucket": "liveBucket****",
  "OssEndpoint": "oss-cn-shan****.aliyuncs.com",
  "OssObject": "1****.jpg",
  "CreateTime": "2015-12-01T17:36:00Z",
  "SnapshotUrl": "http://liveBucket****.oss-cn-shan****.aliyuncs.com/1****.jpg",
  "Size": "36291",
  "Width": "1280",
  "Height": "720"
}

視頻審核回調控制台配置步驟

1. 登入ApsaraVideo for Live控制台。

2. 在左側導覽列單擊功能管理> 事件回調，進入事件回調頁面。

3. 選擇您要配置的播流網域名稱。視頻審核回調只能在播流網域名稱下進行配置。

4. 在回調設定頁簽下，開啟視頻審核回調開關，配置回調地址。回調地址為您自身擁有的地址，當視頻審核回調事件發生時，直播服務端會向該地址發起HTTP POST請求，具體內容將通過JSON Body送達。

5. 單擊確定。

視頻審核回調 API 配置方式

視頻審核回調參數

只會對於有問題的視頻內容進行回調通知，通知內容包含問題視頻截圖的審核資訊和儲存資訊。

Result

視頻審核回調參數樣本

{
  "DomainName": "demo.aliyundoc.com",
  "AppName": "liveApp****",
  "StreamName": "liveStream****",
  "OssEndpoint": "oss-cn-hang****.aliyuncs.com",
  "OssBucket": "liveBucket****",
  "OssObject": "example.jpg",
  "Result": [
    {
      "BizType": "demo.aliyundoc.com",
      "Result": [
        {"Label": "Porn", "Rate": 11, "Suggestion": "review", "Scene": "porn", "Extent": {}},
        {"Label": "Ad", "Rate": 11, "Suggestion": "review", "Scene": "ad", "Extent": {}}
      ]
    }
  ]
}

語音審核回調控制台配置步驟

1. 登入ApsaraVideo for Live控制台。

2. 在左側導覽列單擊功能管理> 事件回調，進入事件回調頁面。

3. 選擇您要配置的播流網域名稱。語音審核回調只能在播流網域名稱下進行配置。

4. 在回調設定頁簽下，開啟語音審核回調開關，配置回調地址。回調地址為您自身擁有的地址，當語音審核回調事件發生時，直播服務端會向該地址發起HTTP POST請求，具體內容將通過JSON Body送達。

5. 單擊確定。

語音審核回調 API 配置方式

語音審核回調參數

只會對於有問題的音頻內容進行回調通知，通知內容包含問題語音的文本資訊以及最近一分鐘內的上下文資訊。

Result

Detail

語音審核回調參數樣本

{
  "domain": "example.aliyundoc.com",
  "app": "liveApp****",
  "stream": "5d9747eba39b44769852d276f9ff****",
  "timestamp": 1572248095,
  "result": [
    {
      "scene": "antispam",
      "label": "ad",
      "suggestion": "block",
      "rate": 99.91,
      "details": [
        {
          "startTime": 1572248023,
          "endTime": 1572248040,
          "text": "麗江隴川等酒店免費居住權120天居住權可與親友共用來雲棲社國際燒酒店接待中心地址芒市團結大街96號鄧朝ktv旁諮詢熱線2285699",
          "label": "ad"
        },
        {
          "startTime": 1572248040,
          "endTime": 1572248070,
          "text": "典藏經典別墅尊享隆多溫泉、梁河金塔、溫泉旅遊小鎮二期濱江苑地區11月2號盛大開盤天然龍窩、溫泉水入戶戶型多樣,設計經典價位超值,值得您擁有開盤當天還有超值優惠,歡迎您前來品鑒,憑藉地址,然和縣遮島鎮先鋒路229號分享熱線0692695577769***",
          "label": "normal"
        },
        {
          "startTime": 1572248072,
          "endTime": 1572248077,
          "text": "快樂的時光,有你相伴愜意的日子,格外輕鬆。",
          "label": "normal"
        },
        {
          "startTime": 1572248078,
          "endTime": 1572248086,
          "text": "fme043忙裡偷閒音樂時光有歌曲溫暖,有你想念影院。",
          "label": "normal"
        }
      ]
    }
  ]
}

控制台配置步驟

1. 登入ApsaraVideo for Live控制台。

2. 在左側導覽列單擊功能管理> 事件回調，進入事件回調頁面。

3. 選擇您要配置的推流網域名稱。雙流災備回調只能在推流網域名稱下進行配置。

4. 在回調設定頁簽下，開啟雙流災備回調開關，配置回調地址。

5. 單擊確定。

切流回調參數

回調樣本：

{
  "action": "multistream_set_master_result",
  "domain": "demo.aliyundoc.com",
  "appname": "liveApp****",
  "streamname": "liveStream****",
  "upstreamsequence": "main",
  "upstreamip": "203.**.***.10",
  "upstreamtime": 17*****710,
  "changereason": "merge_cut_manually",
  "changetime": 17*****705,
  "time": 17*****706
}