开关播回调

最近更新时间:2023-05-05 15:29:19

查看PDF

注意:

  • 极端情况下,内部链路抖动会导致推流闪断,此时主播未下播但您会收到一次关播和开播回调,目前我们已规划新版回调规避此问题,如果您的业务对开关播回调有强依赖关系,请联系售后帮您配置新版回调
  • 极端情况下,主播推流高频闪断,开关播回调可能会有漏发、乱序问题,KLS支持在回调body体中增加sequence用来唯一标识一对开关播回调,您可以借此来准确判断主播的状态,如需配置,请联系售后帮您配置新版回调
  • 注意在您切换回调类型期间,已经处于在播状态的流,您收到的开关播回调将不是同一个类型,且切换期间不是无损的,如果您对切换期间的回调要求高可靠,请先联系售后为您提供专业解决方案

开关播回调(json)

json格式,对应云直播控制台->推流设置->回调body编码格式json

开播回调

当主播开播以后,云直播会将以下主播信息推送到您用来接收开播回调的接口

参数 类型 描述 示例
Version String 版本号 1.0
App String 发布点 live
Pubdomain String 推流域名 xxx.xxx.com
Stream String 流名 123
PubStartUnixTime String 推流开始时间,13位unixtime毫秒时间戳。注:历史原因,开关播回调时间戳类型不一致,如需改成int类型请联系售后帮您配置新版回调 1456800010000
NotifyType String 回调类型,PubStart:推流开始,PubEnd:推流结束 PubStart
PubParam String 推流携带的参数 {“k”:“1”,“t”:“2”}
ClientIp String 主播推流IP 125.163.178.81
ClientPort String 主播推流端口 5475
Node String CDN收流节点IP 108.42.234.6

开播回调示例

{
    "Version":"1.0",
    "App":"live",
    "Pubdomain":"xxx.xxx.com",
    "Stream":"test",
    "PubStartUnixTime":"1456800010000",
    "NotifyType":"PubStart",
    "ClientIp":"125.163.178.81",
    "ClientPort":"1111",
    "Node":"108.42.234.6",
    "PubParam":"{\"k\":\"1\",\"t\":\"2\"}"
}

关播回调

当主播下播以后,云直播会将以下主播信息推送到您用来接收关播回调的接口

参数 类型 描述 示例
Version String 版本号 1.0
App String 频道 live
Pubdomain String 推流域名 xxx.xxx.com
Stream String 流名 123
PubEndUnixTime Int 推流结束时间,13位unixtime毫秒时间戳 1456800010000
NotifyType String 回调类型,PubStart:推流开始,PubEnd:推流结束 PubEnd
PubParam String 推流携带的参数 {“k”:“1”,“t”:“2”}
ClientIp String 主播推流IP 125.163.178.81
ClientPort String 主播推流端口 5475
Node String CDN收流节点IP 108.42.234.6

关播回调示例

{
    "Version":"1.0",
    "App":"live",
    "Pubdomain":"xxx.xxx.com",
    "Stream":"test",
    "PubEndUnixTime":1456800010000,
    "NotifyType":"PubEnd",
    "ClientIp":"125.163.178.81",
    "ClientPort":1111,
    "Node":"108.42.234.6",
    "PubParam":"{\"k\":\"1\",\"t\":\"2\"}"
}

开关播回调(string)

string格式,对应云直播控制台->推流设置->回调body编码格式string,不推荐使用,后续会逐步下线

开播回调

当主播开播以后,云直播会将以下主播信息推送到您用来接收开播回调的接口

示例

HTTP Body
app=live&name=asdf&swfurl=nil&flashver=nil&tcurl=rtmp://test.uplive.ks-cdn.com/live&call=user_publish&vdoid=123456

参数说明

参数 示例 描述
app live 发布点
name test 流名
flashver MAC 10,2,153,2 用于播放SWF文件的Flash播放器版本
swfurl swl文件播放url,无默认值
tcurl rtmp://test.uplive.ks-cdn.com/live/stream 推流url
call user_publish 请求类型(推流开始:user_publish;推流结束:user_publish_done)
vdoid 123 用于标识文件是否拼接

关播回调

当主播下播以后,云直播会将以下主播信息推送到您用来接收关播回调的接口

示例

HTTP头
POST /callback HTTP/1.0
Host: 用户提供的通知Host
Connection: close
Content-Length: 128

HTTP Body
app=live&name=asdf&swfurl=nil&flashver=nil&tcurl=rtmp://test.uplive.ks-cdn.com/live&call=user_publish_done&close_mode=nil&vdoid=123456

参数说明

参数 示例 描述
app live 发布点
name asd 流名
flashver MAC 10,2,153,2 用于播放SWF文件的Flash播放器版本
swfurl swl文件播放url,无默认值
tcurl rtmp://test.uplive.ks-cdn.com/live/stream 推流url
call user_publish 请求类型(推流开始:user_publish;推流结束:user_publish_done)
close_mode 1 推流断开类型(1:正常断开,2:异常断开)
vdoid 123 用于标识相同流名的不同次推流

返回错误描述

Error Description
AuthencationFailed 鉴权失败
NonExistApplication app不存在
ExistStreamName publish流名已存在

文档内容是否对您有帮助?

根本没帮助
文档较差
文档一般
文档不错
文档很好

在文档使用中是否遇到以下问题

内容不全,不深入
内容更新不及时
描述不清晰,比较混乱
系统或功能太复杂,缺乏足够的引导
内容冗长

更多建议

0/200

评价建议不能为空

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

问题反馈