回調通知
更新時間 2025-05-08 09:29:25
最近更新時間: 2025-05-08 09:29:25
分享文章
云點播回調功能介紹。
綜述
云點播中對視頻發起的上傳、刪除、視頻處理等操作,都可以被稱為一個事件。由于云點播的轉碼、截圖等操作屬于算力密集型服務,執行任務需要一定的時間。因此在發起一個事件后,用戶無法在第一時間獲得任務結果,需要在事件結束后,通過回調通知的方式告知執行結果,即為事件通知。
事件通知類型
在點播模式下,云點播支持以下幾種事件通知:
| 通知類型 | 說明 | 相關鏈接 |
|---|---|---|
| 音視頻轉碼完成 | 視頻轉碼任務完成時,觸發該事件。 | 音視頻轉碼完成-點播模式 |
| 審核完成 | 視頻審核任務完成時,觸發該事件。 | 審核完成-點播模式 |
| 視頻截圖完成 | 視頻截圖完成完成時,觸發該事件。 | 視頻截圖完成-點播模式 |
| 視頻拼接完成 | 視頻拼接完成完成時,觸發該事件。 | 視頻拼接完成-點播模式 |
| 媒資信息變更 | 當一個視頻條目的媒資信息發生變更時,觸發該事件。 | 媒資信息變更-點播模式 |
| 視頻上傳完成 | 當成功向【媒體庫】上傳一個媒體文件生成一個視頻條目時,觸發該事件。 | 視頻上傳完成-點播模式 |
| 媒資刪除完成 | 當從【媒體庫】刪除一個視頻條目時,觸發該事件。 | 媒資刪除完成-點播模式 |
事件通知配置方式
- 全局回調。當配置了全局回調后,云點播發生任意觸發事件時,均會根據全局回調的配置發送回調信息。具體配置方式可參考下面章節【全局回調】。
- SDK/API回調。當用戶在創建轉碼任務時,可通過SDK/API配置相應的回調入口,以便僅接收本次轉碼的回調信息。
當用戶同時配置多種事件回調時,具體任務觸發將依據SDK/API回調 > 全局回調的優先級選擇合適的配置發送回調。
全局回調
前提條件
- 已開通云點播產品。
- 至少創建了一個點播實例。
操作步驟
進入,選擇左側導航欄的【開發配置】–【全局回調】可打開回調設置頁面。點擊【修改設置】按鈕,可對回調方式進行設置。
列表中展示各字段說明
| 配置項 | 取值樣例 | 說明 |
|---|---|---|
| 全局回調 | 全局回調配置的總開關。 | |
| 回調URL | //callback.daliqc.cn/callback | 用于接收回調通知的服務地址。 |
| 鑒權校驗 | 是否開啟回調鑒權。 | |
| 回調事件 | 可以接收的回調事件類型。 |
注意回調鑒權需要的AK/SK請通過【開發配置】-【密鑰管理】-【回調密鑰】入口獲得。該AK/SK僅用于回調事件的鑒權,且采用了V4簽名方式。具體鑒權算法可參考云點播SDK API使用指南鑒權簽名及實例(V4版本)。
SDK/API回調
具體配置方法可參考提交轉碼任務。
重新發起回調
前提條件
- 已開通云點播產品。
- 至少創建了一個點播實例。
- 已發起一個轉碼(拼接)任務,且該任務在發起前通過任意配置入口設置了合法的回調接收地址。
操作步驟
登錄,點擊左側導航欄的【任務管理】-【轉碼任務】(或【拼接任務】),在【點播模式】的標簽頁找到需要重新發起回調的任務。在該任務的操作欄點擊【回調重試】即可重新發起回調。
如本次重試回調失敗,您可以在【回調狀態】欄點擊嘆號圖標,查看由回調接收服務返回的響應信息。請注意,本功能僅在當前頁面發起重試時有效。如您在發起重試以后關閉當前頁面,則無法再返回本次回調的調試信息。請在發起調測時保持該頁面開啟。