状态回调
云播放器服务提供状态回调,可将相关数据与状态同步到您在控制台设置的 App 服务器地址。
回调方法
POST:<your-receiving-server-url>
数据格式:application/json
回调地址 <your-receiving-server-url> 是您在控制台为当前 App Key / Secret 和服务所配置的回调接收地址。请务必配置可正常访问的回调接收地址。如果您的网络有 IP 访问限制,请务必配置 IP 白名单,否则无法正常接收服务端回调。
为了验证数据有效性并确保调用者为融云服务端,每个请求前添加数据签名。回调签名规则详见服务端回调。
回调正文参数
该回调服务的 HTTP 请求正文数据格式为 application/json,包含具有以下结构的 JSON 对象:
| 字段名称 | 类型 | 说明 | 
|---|---|---|
| timestamp | Number | 时间戳,精确到毫秒 | 
| type | Number | 回调类型。 1:拉流成功。2:拉流结束。3:表示刚开始拉流异常。4:刚开始拉流正常,中途出现异常,RTMP 进行重连。5:发布 RTC 状态回调,如果使用云端录制服务进行手动录制,请状态5后再调用开始录制。 | 
| app_key | String | 开发者平台分配的 App Key / Secret | 
| room_id | String | 房间 ID | 
| rtmp_url | String | 流媒体资源的公网地址 | 
| user_id | String | 流的用户 ID | 
| code | Number | 状态码。详见下方 code说明。 | 
| video_resolution | String | 视频分辨率,如 1920×1080。 | 
- 
code说明:状态码 说明 10000 正常 61000 不支持的 HTTP 请求 61101 无法从给定的 RTMP 地址拉流 61102 RTMP 拉流过程中出现错误,开始重新连接 61103 RTMP 重连 3 次失败,不再尝试 61010 HTTP 请求 header 部分不合法 61011 HTTP 请求 body 部分不合法 61012 HTTP 请求字段值校验失败 61013 内部错误,访问 signal 服务器超时 61014 内部错误,访问 media 服务器超时 61015 内部错误,房间异常退出 61017 发布 RTC 成功。