跳到主要内容

状态回调

云播放器服务提供状态回调,可将相关数据与状态同步到您在控制台设置的 App 服务器地址。

回调方法

POST<your-receiving-server-url>

数据格式application/json

回调地址 <your-receiving-server-url> 是您在控制台为当前 App Key 和服务所配置的回调接收地址。请务必配置可正常访问的回调接收地址。如果您的网络有 IP 访问限制,请务必配置 IP 白名单,否则无法正常接收服务端回调。

在了验证数据有效性并确保调用者为融云 Server,每个请求前添加数据签名。回调签名规则详见服务端回调

回调正文参数

该回调服务的 HTTP 请求正文数据格式为 application/json,包含具有以下结构的 JSON 对象:

字段名称类型说明
timestampNumber时间戳 精确到毫秒
typeNumber回调类型。1:拉流成功。2:拉流结束。3:表示刚开始拉流异常。4:刚开始拉流正常,中途出现异常,rtmp 进行重连。5:发布 RTC 状态回调,如果使用云端录制服务进行手动录制,请状态 5 后再调用开始录制。
app_keyString开发者平台分配的 App Key
room_idString房间 ID
rtmp_urlString流媒体资源的公网地址
user_idString流的用户 ID
codeNumber状态码。详见下方 code 说明
video_resolutionString视频分辨率,如1920X1080。
  • code 说明

    状态码说明
    10000正常
    61000不支持的http请求
    61101无法从给定的rtmp地址拉流
    61102rtmp拉流过程中出现错误,开始重新连接
    61103rtmp重联3次失败,不再尝试
    61010http请求header部分不合法
    61011http请求body部分不合法
    61012http请求字段值校验失败
    61013内部错误,访问singal服务器超时
    61014内部错误,访问media服务器超时
    61015内部错误,房间异常退出
    61017发布 RTC 成功。