为了保障 RTMP 网关功能的可靠性,声网建议你参考本文档集成 RTMP 网关功能。阅读本文档前,建议你参考 RTMP 网关功能使用说明了解 RTMP 网关功能使用的基础流程。
开始使用前,你需要联系技术支持开通 RTMP 网关功能。
声网服务器限制 RTMP 网关 API 调用速率,超出限制速率时会返回状态码 429(Too Many Requests)
。如果你有更高调用速率需求,请联系技术支持。
API | 限流说明 |
---|---|
Create |
一个项目中,创建推流码的速率上限为 50 次/秒。 |
Delete |
一个项目中,销毁推流码的速率上限为 50 次/秒。 |
Query |
一个项目中,单次查询的速率上限为 100 次/秒。 |
Update |
一个项目中,设置服务配置的速率上限为 50 次/秒。 |
最大并发任务数默认为 50,表示允许在一个项目下最多同时推送 50 条 RTMP 流或者 SRT 流。如需更高配额,请联系技术支持。
为保障推流服务的高可用,避免因区域网络故障造成的服务不可用,声网提供切换域名的方案。
根据你的源流所在地,设置主域名和备份域名:
主域名 | 备用域名 | 地理区域 |
---|---|---|
rtls-ingress-prod-cn.agoramdn.com |
rtls-ingress-prod-backup-cn.agoramdn.com |
中国大陆 |
rtls-ingress-prod-ap.agoramdn.com |
rtls-ingress-prod-backup-ap.agoramdn.com |
除中国大陆以外的亚洲区域 |
rtls-ingress-prod-eu.agoramdn.com |
rtls-ingress-prod-backup-eu.agoramdn.com |
欧洲 |
rtls-ingress-prod-na.agoramdn.com |
rtls-ingress-prod-backup-na.agoramdn.com |
北美 |
当使用主域名请求失败时,使用该域名重试一次。
如果步骤 2 的重试依然失败,使用备用域名重试。
为保障 REST 服务的高可用,避免因区域网络故障造成的服务不可用,声网提供切换域名的方案。
根据你的业务服务器所在地设置主域名:
api.sd-rtn.com
。api.agora.io
。当使用主域名发起 RESTful API 请求失败时,使用该域名重试一次。
如果步骤 2 的重试依然失败,使用备用的主域名重试:
api.sd-rtn.com
,备用的主域名指 api.agora.io
。api.agora.io
,备用的主域名指 api.sd-rtn.com
。如果步骤 3 的重试依然失败,使用与当前解析区域相邻的区域域名重试。
例如,假设你的业务服务器位于欧洲,你设置主域名为 api.agora.io
,而且业务服务器解析主域名解析到德国。德国位于欧洲中部 api-eu-central-1.agora.io
,查域名信息表可知,相邻区域为欧洲西部 api-eu-west-1.agora.io
或 api-eu-west-1.sd-rtn.com
。因此,出现网络故障且步骤 2、3 的重试失败时,请使用 api-eu-west-1.agora.io
或 api-eu-west-1.sd-rtn.com
域名重试。
主域名 | 区域域名 | 地理区域 |
api.sd-rtn.com |
api-us-west-1.sd-rtn.com |
美国西部 |
api-us-east-1.sd-rtn.com |
美国东部 | |
api-ap-southeast-1.sd-rtn.com |
亚太东南 | |
api-ap-northeast-1.sd-rtn.com |
亚太东北 | |
api-eu-west-1.sd-rtn.com |
欧洲西部 | |
api-eu-central-1.sd-rtn.com |
欧洲中部 | |
api-cn-east-1.sd-rtn.com |
中国华东 | |
api-cn-north-1.sd-rtn.com |
中国华北 | |
api.agora.io |
api-us-west-1.agora.io |
美国西部 |
api-us-east-1.agora.io |
美国东部 | |
api-ap-southeast-1.agora.io |
亚太东南 | |
api-ap-northeast-1.agora.io |
亚太东北 | |
api-eu-west-1.agora.io |
欧洲西部 | |
api-eu-central-1.agora.io |
欧洲中部 | |
api-cn-east-1.agora.io |
中国华东 | |
api-cn-north-1.agora.io |
中国华北 |
参考以下表格,快速确认每条检查项是否符合集成要求,以保证 RTMP 网关功能的可靠性。
序号 | 是否必需 | 检查内容 |
---|---|---|
1 | 必需 | 开通 RTMP 网关服务。 |
2 | 必需 | 确保一个项目中,API 的调用速率低于最大限制。详见 API 调用限制。 |
3 | 必需 | 确保一个项目中,并发任务数低于 50。详见最大并发任务数。 |
4 | 必需 |
|
5 | 可选 | 如果调用 RESTful API 失败,请按照如下方案进行问题排查:
X-Request-ID 字段值,并联系声网技术支持。 |
6 | 可选 | 如果使用 RTMP/SRT 协议推流失败,请按照如下方案进行问题排查:
|