开启关闭推流-云直播-文档中心-腾讯云

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

开启关闭推流

本页目录：

1.接口描述

2.输入参数

3.输出结果

4.调用示例