云直播开启关闭推流-云直播 API 2017版（过时）-API 中心-腾讯云

1.接口描述
接口Live_Channel_SetStatus：
对一条直播流执行禁用、断流和允许推流操作。 禁用表示不能再继续使用该流 ID 推流；如果正在推流，则推流会被中断，中断后不可再次推流。断流表示中断正在推的流，断流后可以再次推流。允许推流表示启用该流 ID，允许用该流 ID 推流。
地址
API 调用地址为： http://fcgi.video.qcloud.com/common_access。
用途
主要用于鉴黄时的禁播场景，例如，您如果在后台发现某个主播有涉黄或者反动内容，可以随时断流或者禁用这条流。
说明
一条直播流一旦被设置为禁用状态，推流链路将被腾讯云主动断开，并且后续的推流请求也会被拒绝，一条流最长禁用7天，超过7天，禁用失效。
2.输入参数
参数名
参数含义
类型
备注
是否必需
appid
客户 ID
int
即直播 APPID，用于区分不同客户的身份
Y
interface
接口名称
string
Live_Channel_SetStatus
Y
t
有效时间
int
UNIX 时间戳
Y
sign
安全签名
string
MD5(key+t)
Y
Param.s.channel_id
直播码
string
-
Y
Param.n.status
开关状态
int
0表示禁用，1表示允许推流，2表示断流
Y
Param.s.path
路径
string
多路径用户使用
N
Param.s.domain
域名
string
多域名用户使用
N
注意: 
有些早期提供的 API 中直播码参数被定义为 channel_id，新的 API 则称直播码为 stream_id，仅历史原因而已。
3.输出结果
参数名
参数含义
类型
备注
ret
返回码
int
0：成功；其他值：失败
message
错误信息
string
错误信息
4.调用示例
目标：考虑到直播码为 8888_test123 的直播流内容涉及违规内容，对其进行禁播操作。
组成部分
示例内容
接口URL
http://fcgi.video.qcloud.com/common_access?
appid
1234
interface
Live_Channel_SetStatus
Param.s.channel_id
8888_test123
Param.n.status
0
t
1471850187
sign
b17971b51ba0fe5916ddcd96692e9fb3
// copy时请去掉美化排版用的不可见换行符，否则可能出现 “appid is invalid” 等url拼装错误
 URL = http://fcgi.video.qcloud.com/common_access?
            appid=1234&interface=Live_Channel_SetStatus
            &Param.s.channel_id=8888_test123
            &Param.n.status=0
            &t=1471850187&sign=b17971b51ba0fe5916ddcd96692e9fb3

参数名	参数含义	类型	备注	是否必需
appid	客户 ID	int	即直播 APPID，用于区分不同客户的身份	Y
interface	接口名称	string	Live_Channel_SetStatus	Y
t	有效时间	int	UNIX 时间戳	Y
sign	安全签名	string	MD5(key+t)	Y
Param.s.channel_id	直播码	string	-	Y
Param.n.status	开关状态	int	0表示禁用，1表示允许推流，2表示断流	Y
Param.s.path	路径	string	多路径用户使用	N
Param.s.domain	域名	string	多域名用户使用	N

组成部分	示例内容
接口URL	`http://fcgi.video.qcloud.com/common_access?`
appid	1234
interface	Live_Channel_SetStatus
Param.s.channel_id	8888_test123
Param.n.status	0
t	1471850187
sign	b17971b51ba0fe5916ddcd96692e9fb3

开启关闭推流

本页目录：

1.接口描述

2.输入参数

3.输出结果

4.调用示例