logo
实时语音
服务端 API
当前页

批量禁止 RTC 推流


描述

调用本接口批量禁止 RTC 推流,可以批量禁止指定流 ID 推送到 RTC 服务。禁止推流操作会向正在推流的客户端和正在拉流的客户端发送推流被禁止的通知。通常用于开发者需要通过服务端临时中断某终端推流时使用。

推流客户端接收推流被服务端禁止的通知使用 ZEGO SDK 回调接口:

平台ZegoExpress SDKLiveRoom SDK
接口错误码接口错误码
iOS/macOSonPublisherStateUpdate1003025onPublishStateUpdate12301011
AndroidonPublisherStateUpdate1003025onPublishStateUpdate12301011
WindowsonPublisherStateUpdate1003025OnPublishStateUpdate12301011

拉流客户端接收所拉流被服务端禁止的通知使用 ZEGO SDK 回调接口:

平台ZegoExpress SDKLiveRoom SDK
接口错误码接口错误码
iOS/macOSonPlayerStateUpdate1004025onPlayStateUpdate12301011
AndroidonPlayerStateUpdate1004025onPlayStateUpdate12301011
WindowsonPlayerStateUpdate1004025OnPlayStateUpdate12301011
注意

调用本接口后,正在推送的音视频流会被禁止推送,同时流 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。
SequenceString

请求序列号。

注意

对于同一个流 StreamId,连续 10 秒内,必须保证发出的该 StreamId 的请求序列号是严格递增的;避免服务端收到请求的时序不一致而导致操作错乱。

如果没有并发场景,推荐使用时间戳(毫秒级别)。

请求示例

https://rtc-api.zego.im/?Action=ForbidRTCStreams
&StreamId[]=rtc01
&StreamId[]=rtc02
&Sequence=1617249600001
&<公共请求参数>

响应参数

参数类型是否必选描述
CodeNumber返回码。
MessageString操作结果描述。
RequestIdString请求 ID。
DataObject响应数据。

响应示例

{
    "Code":0,
    "Message":"ok",
    "RequestId":"1929203990360298509",
    "Data":null
}

返回码

以下仅列出了接口业务逻辑相关的部分返回码,完整返回码请参考 全局返回码

返回码说明处理建议
30002接口调用频率过高。请降低接口请求频率。
30003内部错误。请联系 ZEGO 技术支持处理。
30004参数 isTest 错误。请检查公共请求参数 isTest 是否正确。
30005无效的 AppId。请检查 AppId 是否正确。
30006无效的 StreamId 列表。请检查 StreamId[] 是否正确。
42003批量禁用直播失败。请重试,重试无效请联系 ZEGO 技术支持。

Previous

恢复 RTC 推流

Next

批量恢复 RTC 推流