全部产品
Search
文档中心

视频点播:音视频刷新或预热完成

更新时间:Jan 27, 2026

本文为您介绍音视频刷新或预热完成事件、事件通知的内容和回调示例。

事件类型

SubmitMediaRefreshComplete

事件说明

提交音视频刷新或预热任务后,每个音/视频会单独提交播放URL刷新或预热请求,会得到多个taskId,当每个音/视频所有播放URL提交完刷新或预热请求后,会产生SubmitMediaRefreshComplete事件。

说明

暂不支持通过视频点播控制台配置该回调事件,需要调用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."
    }