1.接口描述
- 接口
channel_manager:暂停推流并延迟恢复接口。
- 地址
API 调用地址为:http://fcgi.video.qcloud.com/common_access
。
- 用途
当某些原因不允许主播推流时,可调用此接口。
- 说明
调用该接口可以暂停推某路流(即禁止推流),如果要恢复主播推流,可再次调用该接口或者设置一个恢复时间,到达指定时间后允许推流,最长禁止推流3个月,即禁止推流截止时间最长为当前时间往后3个月,如果超过3个月,则以3个月为准。
2.输入参数
参数名 |
参数含义 |
类型 |
备注 |
是否必需 |
appid |
客户 ID |
int |
即直播 appid,用于区分不同客户的身份 |
Y |
interface |
接口名称 |
string |
channel_manager |
Y |
t |
有效时间 |
int |
UNIX 时间戳 |
Y |
sign |
安全签名 |
string |
MD5(key+t) |
Y |
Param.s.channel_id |
直播码 |
string |
- |
Y |
Param.n.abstime_end |
禁播截止的时间戳 |
int |
禁播截止的绝对时间,请填写 UNIX 时间戳(十进制),系统最多禁播三个月 |
Y |
Param.s.action |
动作 |
string |
断流:forbid;恢复推流:resume |
Y |
Param.s.path |
路径 |
string |
多路径用户使用 |
N |
Param.s.domain |
域名 |
string |
多域名用户使用 |
N |
3.输出结果
参数名 |
参数含义 |
类型 |
备注 |
ret |
返回码 |
int |
0:成功;其他值:失败 |
message |
错误信息 |
string |
错误信息 |
4.调用示例
目标:考虑到直播码为 8888_test123 的直播流内容涉及违规内容,对其进行禁播操作。
组成部分 |
示例内容 |
接口 URL |
http://fcgi.video.qcloud.com/common_access? |
appid |
1250000000 |
interface |
channel_manager |
Param.s.channel_id |
8888_test123 |
Param.n.abstime_end |
1499756910 |
t |
1471850187 |
sign |
b17971b51ba0fe5916ddcd96692e9fb3 |
Param.s.action |
resume |
URL = http:
appid=1250000000
&interface=channel_manager
&Param.s.channel_id=8888_test123
&Param.n.abstime_end=1499756910
&t=1471850187
&sign=b17971b51ba0fe5916ddcd96692e9fb3
&Param.s.action=resume