SetForbidStreamRule
GET
https://rtc-api.zego.im/
设置音视频流封禁规则。
设置成功后,您可以 查询音视频流封禁规则 或 删除音视频流封禁规则。
调用频率限制
同一个 AppID 下所有房间:10 次/秒。
注意
参数 DisableAudio 和 DisableVideo 的使用:
- 必须至少有一个取值为 1,否则调用本接口会出错。
- 针对同一条流 ID,如果多次调用本接口设置不同的封禁规则(每次调用接口时的 DisableAudio 和 DisableVideo 参数取值不同),则以最后一次调用接口的参数设置为准。
Request
Query Parameters
Action string必填
可选值: [SetForbidStreamRule]
接口原型参数
https://rtc-api.zego.im?Action=SetForbidStreamRule
AppId uint32必填
💡公共参数。AppId,ZEGO 分配的用户唯一凭证。
SignatureNonce string必填
💡公共参数。随机字符串。
Timestamp int64必填
💡公共参数。Unix 时间戳,单位为秒。最多允许 10 分钟的误差。
Signature string必填
💡公共参数。签名,用于验证请求的合法性。请参考签名机制生成。
SignatureVersion string必填
可选值: [2.0]
默认值: 2.0
💡公共参数。签名版本号。
RoomId string必填
房间 ID。
StreamId string必填
可选值: <= 256 characters
流 ID,最大不超过 256 字节。
DisableAudio int32
可选值: [0, 1]
默认值: 0
是否封禁音频。0:不封禁(默认);1:封禁。
DisableVideo int32
可选值: [0, 1]
默认值: 0
是否封禁视频。0:不封禁(默认);1:封禁。
EffectiveTime int64
可选值: >= 1 and <= 86400
默认值: 21600
封禁规则有效时长,单位:秒。默认 21600。范围 1 ~ 86400(超过 24 小时的取值将自动调整为 24 小时)。
Responses
- 200
操作成功
- application/json
- curl
- python
- go
- nodejs
- ruby
- csharp
- php
- java
- powershell
- CURL
RESPONSE清除

