概述

事件通知简介

点播服务支持多个存储区域 ，每个区域可以单独配置事件通知的回调方式和回调地址。用户可以上传视频到不同区域的存储，视频处理完成后，点播服务会根据存储区域配置的回调方式和回调地址及时通知用户。

回调方式

点播服务目前支持HTTP回调（兼容HTTPS）、MNS回调两种方式获取事件通知：

• HTTP回调（兼容HTTPS）：

  HTTP回调是您被动接收视频点播服务事件通知的模式。您需要部署一个HTTP服务来接收回调消息，并在视频点播服务中配置回调URL；当事件产生时，点播服务端会向该URL发起HTTP POST请求，事件通知内容将通过HTTP Body送达。

• MNS回调：

  MNS回调是您主动向视频点播服务拉取接收事件通知的模式。您需要授权点播服务访问消息服务MNS并在消息服务中创建队列或使用已有队列，然后在视频点播服务中完成事件通知的配置；当事件产生时，点播服务会将回调内容写入该队列，您需要到消息服务中接收查看消息。在消息服务控制台中创建队列及接收消息的详细操作，请参见队列控制台操作帮助。

HTTP回调与MNS回调对比

回调协议

• HTTP回调

  • 请求：HTTP POST请求，包体内容为JSON，每一种回调的具体包体内容参见事件类型中的参考文档。

  • 应答：点播服务会忽略应答包内容。

• MNS回调

  接收消息内容为JSON，每一种回调的具体包体内容参见事件类型中的参考文档。

回调内容公共参数

回调判断与重试

• HTTP回调

  • 点播服务发起HTTP回调时，若回调接收服务响应的HTTP状态码为200即视为回调成功；响应状态码不为200，或是响应时间超过5秒出现超时，都视为回调失败。点播服务会忽略响应的包体内容，仅以HTTP状态码为准。

  • 若由于配置异常（比如您的回调地址错误、消息接收服务异常等），导致消息回调失败，点播服务会继续重试回调2次，即总共最多回调3次；超过后会丢弃。

• MNS回调

  • 点播服务发起MNS回调时，只要消息写入MNS队列成功即视为回调成功，否则为失败。

  • 若由于配置异常（比如未授权点播服务访问、队列地址不是公网或队列名称不对等），导致消息写入MNS失败，点播服务会继续重试2次，即总共最多回调3次；超过后会丢弃。

回调配置

HTTP和MNS回调的配置流程有所差异，均支持通过视频点播控制台和API/SDK的方式配置。详细的配置流程及使用限制请参见HTTP回调使用方法和MNS回调使用方法。

事件类型

点播目前支持的事件通知类型如下：

常见问题

使用过程中遇到问题时（例如：如何从回调中获取到HTTPS地址？如何实现多回调地址？），请参见事件通知常见问题。