事件通知簡介

點播服務支持多個存儲區域 ，每個區域可以單獨配置事件通知的回調方式和回調地址。用戶可以上傳視頻到不同區域的存儲，視頻處理完成后，點播服務會根據存儲區域配置的回調方式和回調地址及時通知用戶。

回調方式

點播服務目前支持HTTP回調（兼容HTTPS）、輕量消息隊列（原MNS）回調兩種方式獲取事件通知：

• HTTP回調（兼容HTTPS）：

  HTTP回調是您被動接收視頻點播服務事件通知的模式。您需要部署一個HTTP服務來接收回調消息，并在視頻點播服務中配置回調URL；當事件產生時，點播服務端會向該URL發起HTTP POST請求，事件通知內容將通過HTTP Body送達。

• 輕量消息隊列（原 MNS）回調：

  輕量消息隊列（原 MNS）回調是您主動向視頻點播服務拉取接收事件通知的模式。您需要授權點播服務訪問輕量消息隊列（原MNS）并在消息服務中創建隊列或使用已有隊列，然后在視頻點播服務中完成事件通知的配置；當事件產生時，點播服務會將回調內容寫入該隊列，您需要到消息服務中接收查看消息。在消息服務控制臺中創建隊列及接收消息的詳細操作，請參見隊列操作。

HTTP回調與輕量消息隊列（原MNS）回調對比

回調協議

• HTTP回調

  • 請求：HTTP POST請求，包體內容為JSON，每一種回調的具體包體內容參見事件類型中的參考文檔。

  • 應答：點播服務會忽略應答包內容。

• 輕量消息隊列（原 MNS）回調

  接收消息內容為JSON，每一種回調的具體包體內容參見事件類型中的參考文檔。

回調內容公共參數

回調判斷與重試

• HTTP回調

  • 點播服務發起HTTP回調時，若回調接收服務響應的HTTP狀態碼為200即視為回調成功；響應狀態碼不為200，或是響應時間超過5秒出現超時，都視為回調失敗。點播服務會忽略響應的包體內容，僅以HTTP狀態碼為準。

  • 若由于配置異常（比如您的回調地址錯誤、消息接收服務異常等），導致消息回調失敗，點播服務會繼續重試回調2次，即總共最多回調3次；超過后會丟棄。

• 輕量消息隊列（原 MNS）回調

  • 點播服務發起輕量消息隊列（原 MNS）回調時，只要消息寫入輕量消息隊列（原 MNS）成功即視為回調成功，否則為失敗。

  • 若由于配置異常（比如未授權點播服務訪問、隊列地址不是公網或隊列名稱不對等），導致消息寫入輕量消息隊列（原 MNS）失敗，點播服務會繼續重試2次，即總共最多回調3次；超過后會丟棄。

回調配置

HTTP和MNS回調的配置流程有所差異，均支持通過視頻點播控制臺和API/SDK的方式配置。詳細的配置流程及使用限制請參見如何使用和如何使用。

事件類型

點播目前支持的事件通知類型如下：

常見問題

使用過程中遇到問題時（例如：如何從回調中獲取到HTTPS地址？如何實現多回調地址？），請參見事件通知常見問題。