全部文档
当前文档

暂无内容

如果没有找到您期望的内容,请尝试其他搜索词

文档中心

开关播回调

最近更新时间:2024-03-25 19:39:24

注意:

  • 极端情况下,内部链路抖动会导致推流闪断,此时主播未下播但您会收到一次关播和开播回调,目前我们已规划新版回调规避此问题,如果您的业务对开关播回调有强依赖关系,请联系售后帮您配置新版回调

  • 极端情况下,主播推流高频闪断,开关播回调可能会有漏发、乱序问题,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流名已存在

文档导读
纯净模式常规模式

纯净模式

点击可全屏预览文档内容
文档反馈