本文提供事件通知的功能介绍、回调设置和机制以及对应的事件列表。

功能介绍

视频点播中的各种操作，例如视频上传完成、工作流执行完成等，都可以称为一个事件。由于这些任务都需要一定的时间来完成，为了确保在任务完成后能及时通知您，视频点播提供回调事件通知功能。当一个事件完成后，视频点播会向您发送一条回调消息，以便您能够及时进行下一步的业务处理。视频点播目前支持 HTTP 回调，是指您被动接收视频点播服务事件通知的模式。您可以以空间的粒度来配置回调事件通知功能。

HTTP 回调机制

您需要部署一个 HTTP/HTTPS 服务来接收回调消息，并在视频点播控制台中配置回调地址。视频点播的回调机制具体如下：

• 当事件发生时，视频点播服务会向您配置的回调地址发起 POST 请求。
• 您的 HTTP/HTTPS 服务器需返回 200 状态码表示成功，其他状态码表示失败。
• 如果回调失败，视频点播服务会默认进行重试，最多重试 3 次，重试的时间间隔依次为 5 秒、10 秒和 30 秒。如果仍然未成功，则会丢弃本次回调事件通知。

配置方式

• 控制台方式：详见通过控制台配置回调。
• OpenAPI 方式：
  1. 调用 SetCallbackEvent 设置回调事件。
  2. 调用 AddCallbackSubscription 添加回调订阅地址。
• 服务端 SDK 方式：
  • Java SDK - 事件通知
  • Python SDK - 事件通知
  • PHP SDK - 事件通知
  • Go SDK - 事件通知

事件列表

视频点播支持的事件类型如下表所示：