logo
当前页

回调


描述

凭借本回调,您可以监听与播放器任务和上传任务相关的事件。

回调说明

  • 回调方法:POST
  • 回调地址:请联系 ZEGO 技术支持进行配置
    说明
    回调数据格式为 JSON,您需要对其进行 UrlDecode 解码。
  • 传输协议:HTTP 协议

回调参数

说明

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

参数
类型
描述
AppIDNumberZEGO 给开发者 APP 的唯一标识。
RoomIdString(适用于播放器任务相关事件)房间 ID。
PlayerIdString(适用于播放器任务相关事件)云端播放器唯一标识 ID。
UploadTaskIdString(适用于上传任务相关事件)上传任务 ID。
EventTypeNumber事件通知类型。
  • 云端播放器任务相关:
    • 1:云端播放器创建成功。
    • 2:云端播放器销毁成功。
    • 3:云端播放器状态改变。
    • 4:云端播放器异常通知。
  • 上传任务相关:
    • 10001:文件上传成功。
    • 10002:文件上传失败。
    • 10003:上传任务状态改变。
    • 10004:取消操作失败。
    • 10005:上传发生异常。
    • 10006:上传文件过期。
NonceString随机数,用于检验串计算。
TimestampString回调发送时的 Unix 时间戳(秒),用于检验串计算。
SignatureString检验串,验证回调发送方身份。
EventTimeNumber事件在云端播放服务器上发生的 Unix 时间戳(毫秒),开发者可根据该字段判断回调顺序。
DetailObject事件详细信息。详情请参考 Detail

Detail

根据 EventType 取值不同,detail 的属性不同。

云端播放器检测到上述异常事件后,内部会自动进行重试。如果短时间内多次收到该类异常回调通知,开发者需要检查资源服务器访问是否正常、或做其它容错处理。

回调示例

返回响应

返回 HTTP status code 为 2XX (例如 200)表示成功,其他响应都表示失败。

回调重试策略

如果 ZEGO 服务器没有收到响应,会立刻尝试重试,最多进行 2 次重试。若第 2 次重试后仍然失败,将不再重试,该回调丢失。

Previous

验证说明

Next

全局返回码