开关播回调

注意：

• 极端情况下，内部链路抖动会导致推流闪断，此时主播未下播但您会收到一次关播和开播回调，目前我们已规划新版回调规避此问题，如果您的业务对开关播回调有强依赖关系，请联系售后帮您配置新版回调
• 极端情况下，主播推流高频闪断，开关播回调可能会有漏发、乱序问题，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流名已存在