接收 CDN 推流回调
融云在低延迟直播旁路推流到融云 CDN 或第三方 CDN 时,支持将推流的状态变化实时通知您的服务器。
回调方法
POST:<your-receiving-server-url>
数据格式:application/json
回调地址 <your-receiving-server-url>
是您在控制台为当前 App Key 和服务所配置的回调接收地址。请务必配置可正常访问的回调接收地址。如果您的网络有 IP 访问限制,请务必配置 IP 白名单,否则无法正常接收服务端回调。
为了验证数据有效性并确保调用者为融云 Server,每个请求前添加数据签名。回调签名规则详见服务端回调。
回调正文参数
该回调服务的 HTTP 请求正文数据格式为 application/json
,包含具有以下结构的 JSON 对象:
字段名称 | 类型 | 说明 |
---|---|---|
timestamp | Number | 时间戳,从 1970 年 1 月 1 日 0 点 0 分 0 秒开始到现在的毫秒数。 |
type | Number | 状态类型: 1: 开始旁路推流; 2: 旁路推流结束; 3: 旁路推流配置更新; 4: 旁路推流失败 |
appKey | String | 当前在使用的 AppKey |
sessionId | String | 当前直播的会话 ID |
roomId | String | 当前直播的房间 ID |
pushUrl | String | 旁路推流的 CDN 地址 |
userId | String | 设置旁路推流的主播用户 ID |
output.videoResoulation | String | 视频分辨率,宽 x 高 |
stateCode | Number | 状态码 |
回调请求示例
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":"240x320"
}
}