提交工单
咨询集成、功能及报价等问题
调用本接口停止旁路推流。如果指定流正旁路推流至 CDN 直播服务,则会停止该转推任务。开发者需要保证转推的地址一致 (携带参数可以不一致),才能够正确停止对应的转推任务。
开发者 启动旁路推流,将 RTC 流旁路转推至指定 CDN 直播地址后,如果不再需要将流转推至 CDN 时,请参考本文档停止旁路推流。
首次使用本接口之前,需要联系 ZEGO 技术支持开通。
以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表请参考 调用方式 - 公共请求参数。
测试环境下(详见 调用方式 - 公共参数 中 “IsTest” 的参数说明),流 ID 需要加上 “zegotest-AppId-” 前缀。例如,流 ID 为 “test”,在 AppId 为 “123456789” 的测试环境下,流 ID 应为 “zegotest-123456789-test”。
参数 | 类型 | 是否必选 | 描述 |
---|---|---|---|
StreamId |
String |
是 |
流 ID。 |
CDNUrl |
String |
是 |
转推的 CDN 地址,必须是 RTMP 格式。 使用时,请对该参数内容进行 UrlEncode。 |
Sequence |
String |
是 |
请求序列号,开发者需保证发出的请求严格递增,推荐使用时间戳(毫秒级别)。 |
https://rtc-api.zego.im/?Action=DeleteCDNTransferRule
&StreamId=rtc01
&CDNUrl=rtmp%3A%2F%2Fwsdemo.zego.im%2Flivestream%2Frtc01
&Sequence=1617249600002
&<公共请求参数>
参数 | 类型 | 描述 |
---|---|---|
Code |
Number |
返回码。 |
Message |
String |
操作结果描述。 |
RequestId |
String |
请求 ID。 |
Data |
Object |
响应数据。 |
{
"Code":0,
"Message":"ok",
"RequestId":"4741109603321226039",
"Data":null
}
以下仅列出了接口业务逻辑相关的返回码,完整返回码请参考 全局返回码。
返回码 | 说明 | 处理建议 |
---|---|---|
41001 | 直播保存失败。 | 请检查直播是否存在。如果存在,请重试,重试无效请 ZEGO 联系技术支持。 |
41002 | 频道保存失败。 | 请检查频道是否存在。如果存在,请重试,重试无效请 ZEGO 联系技术支持。 |
41003 | 直播不存在。 | 请检查直播是否存在。如果存在,请重试,重试无效请 ZEGO 联系技术支持。 |
41004 | 流已不存在。 | 请检查流是否存在。如果存在,请重试,重试无效请 ZEGO 联系技术支持。 |
42001 | 禁用直播失败。 | 请重试,重试无效请 ZEGO 联系技术支持。 |
42002 | 恢复直播失败。 | 请重试,重试无效请 ZEGO 联系技术支持。 |
42003 | 批量禁用直播失败。 | 请重试,重试无效请 ZEGO 联系技术支持。 |
42004 | 批量恢复直播失败。 | 请重试,重试无效请 ZEGO 联系技术支持。 |
43001 | 创建录制索引文件失败。 | 请重试,重试无效请 ZEGO 联系技术支持。 |
联系我们
文档反馈