为允许用户在有网络访问限制的环境中使用服务端网关 SDK,声网提供云代理服务。用户只需在防火墙上将特定的 IP 地址和端口加入白名单,并调用 API 配置声网云代理服务。
1.声网 SDK 向声网云代理发起请求。声网云代理返回相应代理信息。
2.声网 SDK 向声网云代理发送数据。声网云代理接收数据并将数据透传给声网 SD-RTN™(Software Defined Real-time Network)。
3.声网 SD-RTN™ 向声网云代理返回数据。声网云代理接收数据并将数据发送给声网 SDK。
参考跑通示例项目文档下载服务端网关 SDK 并完成开发环境准备。
联系 sales@agora.io,提供以下信息申请开通云代理服务。
收到申请后,声网会提供用于云代理的 IP 地址和端口。请确保将声网提供的 IP 地址和端口添加到防火墙白名单。
调用 io.agora.rtc.AgoraParameter.setParameters
,通过私有参数开启云代理。
// 在调用 connect 前开启云代理服务,并通过以下一种方式配置云代理服务。
mAgoraParameter.setParameters("{\"rtc.enable_proxy\": true}");
// TCP(加密)协议的云代理,即 Force TCP 云代理模式。在该模式下,SDK 始终通过 TLS 443 传输数据。
mAgoraParameter.setParameters("{\"rtc.proxy_server\":[13,\"\",0]}");
// UDP 协议的云代理,即 Force UDP 云代理模式。在该模式下,SDK 始终通过 UDP 协议传输数据。
mAgoraParameter.setParameters("{\"rtc.proxy_server\":[1,\"\",0]}");