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 |
// copy时请去掉美化排版用的不可见换行符,否则可能出现 “appid is invalid” 等url拼装错误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