暂停并延迟恢复

最近更新时间:2019-07-02 11:25:38

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