接收回调

注意

回调服务不能保证完全可靠，请慎重考虑使用回调方案构建核心业务流程的风险。

通过本回调，您可以监听数字人视频流任务相关的信息，包含视频流任务状态、视频流驱动任务状态。

回调说明

说明

回调的相关参数，ZEGO 会在之后的迭代计划中，持续优化更新（例如：新增字段、或新增某些字段的参数取值）。开发者在接入时，请避免将代码写死，造成后期更新后，无法兼容新版本。

参数	类型	描述
AppId	Number	ZEGO 给开发者 APP 的唯一标识。
EventType	Number	事件通知类型。 3：数字人视频流任务状态。 4：数字人视频流任务驱动状态。
Nonce	String	随机数，用于检验串计算。
Timestamp	String	回调发送时的 Unix 时间戳（秒），用于检验串计算。
Signature	String	检验串，验证回调发送方身份。
EventTime	Number	事件在 ZEGO 服务器上发生的 Unix 时间戳（毫秒）。
TaskId	String	数字人视频流任务 ID。
Detail	Object	事件详细信息。本参数结构，请参考 Detail。

根据 EventType 取值不同，Detail 包含的参数不同。

3：数字人视频流任务状态

4：数字人视频流驱动任务状态

以下展示各种事件的回调示例。

为提高数据安全性，建议开发者在收到 ZEGO 服务端发出的回调时，进行本地签名计算，并与 signature 进行对比，判断该请求是否合法。

校验的使用流程如下：

对参数进行排序

将 callbacksecret、timestamp、nonce 三个参数按照字典序进行排序

计算 SHA1

将排序后的 callbacksecret、timestamp、nonce 拼接成一个字符串并进行sha1计算

校验 signature

将计算后的哈希字符串与 signature 进行校验对比，如果相同则标识该请求来源于 ZEGO

参数说明如下：

参数	说明
callbacksecret	服务端校验密钥。在 ZEGO 控制台注册项目时生成，可在 “控制台 > 项目配置 > 项目信息 > 配置信息” 中查看。
timestamp	Unix 时间戳。
nonce	随机数。

使用示例

当您收到回调后，请返回 HTTP status code 为 2XX （例如 200），表示接收成功。返回其他，都表示接收失败。

如果 ZEGO 服务器没有收到响应，或收到的 HTTP status code 不为 2XX（例如 200），都会尝试重试，最多进行 5 次重试。每次重试请求与上一次请求的间隔时间分别为 2s、4s、8s、16s、32s。若第 5 次重试后仍然失败，将不再重试，该回调丢失。