使用云代理

简介

为允许用户在有网络访问限制的环境中使用 Agora RTSA SDK，Agora 提供云代理服务。用户只需在防火墙上将特定的 IP 地址和端口加入白名单，并调用 API 配置 Agora 云代理服务。

工作原理

1. Agora SDK 向 Agora 云代理发起请求。Agora 云代理返回相应代理信息。
2. Agora SDK 向 Agora 云代理发送数据。Agora 云代理接收数据并将数据透传给 Agora SD-RTN™（Software Defined Real-time Network）。
3. Agora SD-RTN™ 向 Agora 云代理返回数据。Agora 云代理接收数据并将数据发送给 Agora SDK。

实现方法

准备工作

1. 下载 Agora RTSA SDK。

2. 参考 快速跑通示例项目 文档完成开发环境准备。

3. 提交工单 联系技术支持，并提供以下信息申请开通云代理服务。

   • App ID
   • 代理服务使用区域
   • 并发规模
   • 网络运营商等信息

添加白名单

收到申请后，Agora 会提供用于云代理的 IP 地址和端口。请确保用户将 Agora 提供的 IP 地址和端口添加到防火墙白名单。

调用 API

你可以调用 agora_rtc_set_cloud_proxy（C API）或 setCloudProxy（Java API）方法开启云代理。

1. 添加白名单后，调用 agora_rtc_set_cloud_proxy（C API）或 setCloudProxy（Java API），并将 type 设为 CLOUD_PROXY_UDP(1)。

2. 测试是否能正常实现媒体流传输。

如需关闭云代理服务，调用 agora_rtc_set_cloud_proxy（C API）或 setCloudProxy（Java API），并将 type 设为 CLOUD_PROXY_NONE(0)。

开发注意事项

• agora_rtc_set_cloud_proxy（C API）或 setCloudProxy（Java API）方法需要在使用云代理服务之前调用。例如你需要使用云代理才能加入 RTC 频道，则需要在 agora_rtc_join_channel（C API）或 joinChannel（Java API） 之前调用。

API 参考

C API 文档

• agora_rtc_set_cloud_proxy

Java API 文档

• setCloudProxy