跳到主要内容

接收 CDN 推流回调

融云在低延迟直播旁路推流到第三方 CDN 时，支持将推流的状态变化实时通知您的服务器。

回调方法​

POST：<your-receiving-server-url>

数据格式：application/json

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

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

回调正文参数​

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

字段名称类型说明
timestampNumber时间戳，从 1970 年 1 月 1 日 0 点 0 分 0 秒开始到现在的毫秒数。
typeNumber状态类型：
1: 开始旁路推流；
2: 旁路推流结束；
3: 旁路推流配置更新；
4: 旁路推流失败
appKeyString当前在使用的 App Key / Secret
sessionIdString当前直播的会话 ID
roomIdString当前直播的房间 ID
pushUrlString旁路推流的 CDN 地址
userIdString设置旁路推流的主播用户 ID
output.videoResoulationString视频分辨率，宽 × 高
stateCodeNumber状态码

回调请求示例​

HTTP
POST /any-url-path HTTP/1.1
Host: your.app.server
Content-Type: application/json

{
    "timestamp": 1593483553055,
    "type": 2,
    "stateCode": 10000,
    "appKey": "qf3d5gbjq962h",
    "roomId": "iOS-MUJERjYwNTk5MTkyMERCMTFDQkRGODUwODIwNEM0RUI-1593483530019",
    "sessionId": "AtqSLHUE_29wd2o6QKM4u7",
    "userId": "A2BDE07D-5273-487A-8997-99BF25D06DFE",
    "pushUrl": "rtmp://rongcloud.net/seal/AtqSLo6QKM4u7?auth_key=1593487130ace2de7f67c1111",
    "output": {
        "videoResoulation": "240×320"
    }
}

响应回调请求​

您的服务在收到 HTTP 回调之后，需要返回 200 OK 表示接收成功。

最后于 更新