logo
实时音视频
服务端 API
当前页

批量恢复 RTC 推流


描述

调用本接口批量恢复 RTC 推流,可批量恢复被禁止推往 RTC 媒体服务的流 ID 。配合批量禁止 RTC 推流使用。

接口原型

  • 请求方法:GET
  • 请求地址:https://rtc-api.zego.im/?Action=ResumeRTCStreams
  • 传输协议: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=ResumeRTCStreams
&StreamId[]=rtc01
&StreamId[]=rtc02
&Sequence=1
&<公共请求参数>

响应参数

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

响应示例

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

返回码

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

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

Previous

批量禁止 RTC 推流

Next

启动旁路推流