全部产品
云市场

使用说明

更新时间:2019-08-01 10:01:49

概述

点播服务支持多个存储区域(中国大陆、新加坡、法兰克福等),每个区域可以单独配置事件通知的回调方式和回调地址。用户可以上传视频到不同区域的存储,视频处理(如上传、转码)完成后,点播服务会根据存储区域配置的回调方式和回调地址及时通知用户。

事件类型

目前支持的事件通知类型参考如下:

事件类型 EventType
FileUploadComplete 视频上传完成
ImageUploadComplete 图片上传完成
StreamTranscodeComplete 视频单个清晰度转码完成
TranscodeComplete 视频全部清晰度转码完成
SnapshotComplete 视频截图完成
AddLiveRecordVideoComplete 直转点视频录制完成
LiveRecordVideoComposeStart 直转点录制视频合成开始
UploadByURLComplete URL上传视频完成
CreateAuditComplete 人工审核完成
AIMediaAuditComplete 智能审核完成
VideoAnalysisComplete 音视频分析完成
AIMediaDNAComplete 视频DNA完成
AIVideoTagComplete 多模态内容理解完成
AttachedMediaUploadComplete 辅助媒资上传完成
ProduceMediaComplete 媒体合成完成
DeleteMediaComplete 媒体删除完成
MediaBaseChangeComplete 媒资基础信息变更

回调方式

点播服务目前支持HTTP回调(兼容HTTPS)MNS回调两种方式获取事件通知,使用方法:

  • HTTP(HTTPS)回调:您需要部署一个HTTP服务来接收回调消息,并在点播控制台上配置回调URL;当事件产生时,点播服务端会向该URL发起HTTP POST请求,具体内容将通过HTTP Body送达。

  • MNS回调:您需要授权 点播服务访问MNS ,然后登录 消息服务控制台 ,创建队列或使用已有队列,调用接口完成事件通知配置;当事件产生时,点播服务会将回调内容写入该队列,具体读取消息参见消息服务。

两种方式对比

  • 可靠性:相比HTTP方式,MNS事件通知更为可靠,只要配置正常,消息回调几乎都能成功;但若您的HTTP消息接收服务存在异常(崩溃或重启),则消息可能会丢失。

  • 安全性:由于仅授权方能读写消息队列,MNS安全性更高;HTTP方式都可回调该地址,但可配合 回调鉴权 过滤非法请求,以增强安全性。

  • 便捷性:HTTP方式接入更为方便,只需简单部署消息接收服务;MNS方式需要额外开通和配置MNS,并需要开发和部署消费消息的程序。详见 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 处理状态,取值:success(成功),fail(失败)

回调判断与重试

HTTP回调

  • 点播服务发起HTTP回调时,若回调接收服务响应的HTTP状态码为200即视为回调成功;响应状态码不为200,或是响应时间超过5秒出现超时,都视为回调失败。点播服务会忽略响应的包体内容,仅以HTTP状态码为准。
  • 若由于配置异常(比如您的回调地址错误、消息接收服务异常等),导致消息回调失败,点播服务会继续重试回调2次,即总共最多回调3次;超过后会丢弃。

MNS回调

  • 点播服务发起MNS回调时,只要消息写入MNS队列成功即视为回调成功,否则为失败。
  • 若由于配置异常(比如未授权点播服务访问、队列地址不是公网或队列名称不对等),导致消息写入MNS失败,点播服务会继续重试2次,即总共最多回调3次;超过后会丢弃。

注:点播服务在回调失败后会间隔1秒再次发起重试,若总共3次回调仍失败则会丢弃该消息;如要确保可靠通知,建议使用MNS回调,其可靠性更高,只要配置正常,几乎能确保消息回调成功。

常见问题

使用过程中遇到问题请先参阅 事件通知常见问题