概述
视频点播支持HTTP回调和MNS回调两种方式,本文为您介绍事件通知的事件类型、回调方式、回调配置、回调协议、回调内容公共参数等基本信息,以及回调判断与重试和常见问题。
事件通知简介
点播服务支持多个存储区域 ,每个区域可以单独配置事件通知的回调方式和回调地址。用户可以上传视频到不同区域的存储,视频处理完成后,点播服务会根据存储区域配置的回调方式和回调地址及时通知用户。
事件类型
目前支持的事件通知类型参考如下:
事件类型 | 参考文档 |
---|---|
FileUploadComplete | |
ImageUploadComplete | |
StreamTranscodeComplete | |
TranscodeComplete | |
SnapshotComplete | |
DynamicImageComplete | |
AddLiveRecordVideoComplete | |
LiveRecordVideoComposeStart | |
UploadByURLComplete | |
CreateAuditComplete | |
AIMediaAuditComplete | |
VideoAnalysisComplete | |
AIMediaDNAComplete | |
AIVideoTagComplete | |
AttachedMediaUploadComplete | |
ProduceMediaComplete | |
DeleteMediaComplete | |
MediaBaseChangeComplete |
回调方式
点播服务目前支持HTTP回调(兼容HTTPS)、MNS回调两种方式获取事件通知:
两种方式对比
对比项 | HTTP回调 | MNS回调 |
---|---|---|
可靠性 | 若您的HTTP消息接收服务存在异常(崩溃或重启),则消息可能会丢失。 | 更为可靠,只要配置正常,消息回调几乎都能成功。 |
安全性 | HTTP方式都可回调该地址,但可配合回调鉴权过滤非法请求,以增强安全性。 如何配置,请参见HTTP回调鉴权。 | 由于仅授权方能读写消息队列,安全性更高。 |
便捷性 | 接入更为方便,只需简单部署消息接收服务。 | 需要额外开通和配置MNS,并且需要开发和部署消费消息的程序。 |
选择哪种回调方式,取决于您的使用场景,综合考虑。
回调配置
登录视频点播控制台,在配置管理>媒体处理配置>回调设置页面,配置回调URL、队列及选择需要回调的事件。具体操作,请参见回调设置。
勾选视频AI处理完成后,所有的AI事件如AIMediaAuditComplete、AIMediaDNAComplete、AIVideoTagComplete等都会触发通知。

回调协议
HTTP回调
请求:HTTP POST请求,包体内容为JSON,每一种回调的具体包体内容参见各自文档。
应答:点播服务会忽略应答包内容。
MNS回调
接收消息内容为JSON,每一种回调的具体包体内容参见各自文档。
回调内容公共参数
参数名称 | 类型 | 描述 |
---|---|---|
EventTime | String | 事件产生时间, 为UTC时间:yyyy-MM-ddTHH:mm:ssZ。 |
EventType | String | 事件类型。 |
VideoId | String | 视频ID。 |
Status | String | 处理状态,取值:
|
Extend | String | 在上传或提交作业接口中,指定UserData;并且若里面包含Extend字段,会在事件完成回调时透传返回用户自定义数据,最大长度512字节。 |
回调判断与重试
HTTP回调
点播服务发起HTTP回调时,若回调接收服务响应的HTTP状态码为200即视为回调成功;响应状态码不为200,或是响应时间超过5秒出现超时,都视为回调失败。点播服务会忽略响应的包体内容,仅以HTTP状态码为准。
若由于配置异常(比如您的回调地址错误、消息接收服务异常等),导致消息回调失败,点播服务会继续重试回调2次,即总共最多回调3次;超过后会丢弃。
MNS回调
点播服务发起MNS回调时,只要消息写入MNS队列成功即视为回调成功,否则为失败。
若由于配置异常(比如未授权点播服务访问、队列地址不是公网或队列名称不对等),导致消息写入MNS失败,点播服务会继续重试2次,即总共最多回调3次;超过后会丢弃。
点播服务在回调失败后会间隔1秒再次发起重试,若总共3次回调仍失败则会丢弃该消息;如要确保可靠通知,建议使用MNS回调,其可靠性更高,只要配置正常,几乎能确保消息回调成功。
常见问题
使用过程中遇到问题,请参见事件通知。