批量禁止 RTC 推流
描述
调用本接口批量禁止 RTC 推流,可以批量禁止指定流 ID 推送到 RTC 服务。禁止推流操作会向正在推流的客户端和正在拉流的客户端发送推流被禁止的通知。通常用于开发者需要通过服务端临时中断某终端推流时使用。
推流客户端接收推流被服务端禁止的通知使用 ZEGO SDK 回调接口:
平台 | ZegoExpress SDK | LiveRoom SDK | ||
---|---|---|---|---|
接口 | 错误码 | 接口 | 错误码 | |
iOS/macOS | onPublisherStateUpdate | 1003025 | onPublishStateUpdate | 12301011 |
Android | onPublisherStateUpdate | 1003025 | onPublishStateUpdate | 12301011 |
Windows | onPublisherStateUpdate | 1003025 | OnPublishStateUpdate | 12301011 |
拉流客户端接收所拉流被服务端禁止的通知使用 ZEGO SDK 回调接口:
平台 | ZegoExpress SDK | LiveRoom SDK | ||
---|---|---|---|---|
接口 | 错误码 | 接口 | 错误码 | |
iOS/macOS | onPlayerStateUpdate | 1004025 | onPlayStateUpdate | 12301011 |
Android | onPlayerStateUpdate | 1004025 | onPlayStateUpdate | 12301011 |
Windows | onPlayerStateUpdate | 1004025 | OnPlayStateUpdate | 12301011 |
注意
调用本接口后,正在推送的音视频流会被禁止推送,同时流 ID 被记录到后台数据库;不存在的流直接记录到后台数据库,接口正常返回成功。
接口原型
- 请求方法:GET
- 请求地址:
https://rtc-api.zego.im/?Action=ForbidRTCStreams
- 传输协议:HTTPS
- 调用频率限制:20 次/秒(测试环境:5 次/秒)
请求参数
以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表请参考 完整公共参数列表请参考 调用方式 中的 “公共请求参数”。
说明
测试环境下(详见 调用方式 中的 “公共参数” 中的 IsTest 的参数说明),流 ID 需要加上 “zegotest-AppId-” 前缀。例如,流 ID 为 “test”,在 AppId 为 “123456789” 的测试环境下,流 ID 应为 “zegotest-123456789-test”。
参数 | 类型 | 是否必选 | 描述 |
---|---|---|---|
StreamId[] | Array of String | 是 | 流 ID 列表,最大支持 20 个流 ID。 |
Sequence | String | 是 | 请求序列号。 注意 对于同一个流 StreamId,连续 10 秒内,必须保证发出的该 StreamId 的请求序列号是严格递增的;避免服务端收到请求的时序不一致而导致操作错乱。 如果没有并发场景,推荐使用时间戳(毫秒级别)。 |
请求示例
https://rtc-api.zego.im/?Action=ForbidRTCStreams
&StreamId[]=rtc01
&StreamId[]=rtc02
&Sequence=1617249600001
&<公共请求参数>
响应参数
参数 | 类型 | 是否必选 | 描述 |
---|---|---|---|
Code | Number | 是 | 返回码。 |
Message | String | 是 | 操作结果描述。 |
RequestId | String | 是 | 请求 ID。 |
Data | Object | 否 | 响应数据。 |
响应示例
{
"Code":0,
"Message":"ok",
"RequestId":"1929203990360298509",
"Data":null
}
返回码
以下仅列出了接口业务逻辑相关的部分返回码,完整返回码请参考 全局返回码。
返回码 | 说明 | 处理建议 |
---|---|---|
30002 | 接口调用频率过高。 | 请降低接口请求频率。 |
30003 | 内部错误。 | 请联系 ZEGO 技术支持处理。 |
30004 | 参数 isTest 错误。 | 请检查公共请求参数 isTest 是否正确。 |
30005 | 无效的 AppId。 | 请检查 AppId 是否正确。 |
30006 | 无效的 StreamId 列表。 | 请检查 StreamId[] 是否正确。 |
42003 | 批量禁用直播失败。 | 请重试,重试无效请联系 ZEGO 技术支持。 |