回调
描述
凭借本回调,您可以监听与播放器任务和上传任务相关的事件。
回调说明
- 回调方法:POST
- 回调地址:请联系 ZEGO 技术支持进行配置
说明回调数据格式为 JSON,您需要对其进行 UrlDecode 解码。
- 传输协议:HTTP 协议
回调参数
说明
回调的相关参数,ZEGO 会在之后的迭代计划中,持续优化更新(例如:新增字段、或新增某些字段的参数取值)。开发者在接入时,请避免将代码写死,造成后期更新后,无法兼容新版本。
参数 | 类型 | 描述 |
---|---|---|
AppID | Number | ZEGO 给开发者 APP 的唯一标识。 |
RoomId | String | (适用于播放器任务相关事件)房间 ID。 |
PlayerId | String | (适用于播放器任务相关事件)云端播放器唯一标识 ID。 |
UploadTaskId | String | (适用于上传任务相关事件)上传任务 ID。 |
EventType | Number | 事件通知类型。
|
Nonce | String | 随机数,用于检验串计算。 |
Timestamp | String | 回调发送时的 Unix 时间戳(秒),用于检验串计算。 |
Signature | String | 检验串,验证回调发送方身份。 |
EventTime | Number | 事件在云端播放服务器上发生的 Unix 时间戳(毫秒),开发者可根据该字段判断回调顺序。 |
Detail | Object | 事件详细信息。详情请参考 Detail。 |
Detail
根据 EventType
取值不同,detail 的属性不同。
1
2
3
4
10001 或 10006
10002
10003
10004
10005
云端播放器检测到上述异常事件后,内部会自动进行重试。如果短时间内多次收到该类异常回调通知,开发者需要检查资源服务器访问是否正常、或做其它容错处理。
回调示例
创建云端播放器
创建上传任务
返回响应
返回 HTTP status code 为 2XX (例如 200)表示成功,其他响应都表示失败。
回调重试策略
如果 ZEGO 服务器没有收到响应,会立刻尝试重试,最多进行 2 次重试。若第 2 次重试后仍然失败,将不再重试,该回调丢失。