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