全部產品
Search
文件中心

ApsaraVideo VOD:音視頻重新整理或預熱完成

更新時間:Aug 05, 2026

本文為您介紹音視頻重新整理或預熱完成事件、事件通知的內容和回調樣本。

事件類型

SubmitMediaRefreshComplete

事件說明

提交音視頻重新整理或預熱任務後,每個音/視頻會單獨提交播放URL重新整理或預熱請求,會得到多個taskId,當每個音/視頻所有播放URL提交完重新整理或預熱請求後,會產生SubmitMediaRefreshComplete事件。

說明

暫不支援通過ApsaraVideo for VOD控制台配置該回調事件,需要調用SetMessageCallback介面配置該回調事件。

事件內容

參數名稱

類型

必備項

描述

EventTime

String

事件產生時間,為UTC時間:yyyy-MM-ddTHH:mm:ssZ。

EventType

String

事件類型,系統規定參數。固定為:SubmitMediaRefreshComplete

Status

String

提交重新整理預熱是否成功。取值:

  • success:成功

  • fail:失敗

MediaRefreshJobId

String

重新整理任務ID。

MediaId

String

媒體ID,即音/視頻ID。

TaskType

String

任務類型。取值:

  • Refresh:重新整理

  • Preload:預熱

SuccessPlayUrls

String

成功提交重新整理或預熱的播放URL。多個URL之間用半形逗號(,)分隔。

TaskIds

String

播放URL的重新整理或預熱的任務ID,一個URL對應一個任務ID。該任務ID用於查詢重新整理和預熱狀態介面查詢每個播放URL的重新整理或預熱狀態。

FilterPolicy

String

播放流的篩選策略。JSON格式,內容為提交音視頻重新整理或預熱任務介面的請求參數。

Extend

String

使用者自訂透傳參數。

ErrorCode

String

錯誤碼。當提交重新整理或預熱任務失敗時會有該欄位。

ErrorMessage

String

錯誤資訊。當提交重新整理或預熱任務失敗時會有該欄位。

回調樣本

回調樣本說明:

  • 對於HTTP回調,以下內容為HTTP Post Body。

  • 對於MNS回調,以下內容為訊息體。

  • 任務成功

    {
    "SuccessPlayUrls":"https://shenzhen.****.aliyuncdn.com/2defb8b2cb85b87206646055c95****/62948766/sv/4841bb0f-1810a5fc460/4841bb0f-1810a5****.mp4",
    "Status":"success",
    "MediaId":"affab1a4c6ed4408aead501f32b5****",
    "FilterPolicy":"{\"SliceFlag\":false,\"ResultType\":\"Single\"}",
    "TaskIds":"1460435****",
    "EventType":"SubmitMediaRefreshComplete",
    "EventTime":"2022-05-30T08:59:21Z",
    "MediaRefreshJobId":"c5ae61bf9af1****",
    "TaskType":"refresh"
    }
  • 任務失敗

    {
    "Status":"fail",
    "MediaId":"e8a73a514fb74fd79ff77c26dbfb****",
    "FilterPolicy":"{\"SliceFlag\":false,\"ResultType\":\"Single\"}",
    "EventType":"SubmitMediaRefreshComplete",
    "EventTime":"2022-05-30T08:56:14Z",
    "MediaRefreshJobId":"aa23298375bd****",
    "TaskType":"refresh",
    "ErrorCode":"InvalidDomain.NotFound",
    "ErrorMessage":"Can't find domain."
    }