云代理

功能简介

通过设置 SDK 的云代理接口，将 SDK 对应的所有流量通过云端的代理服务器中转，实现与 RTC、L3（超低延迟直播）通信。

当前 ZEGO 提供了 普通云代理 和 智能云代理 两种模式，开发者可以根据您的业务需要，选择合适的云代理模式。

前提条件

在使用云代理之前，请确保：

• 已在 ZEGO 控制台 创建项目，并申请有效的 AppID 和 AppSign，详情请参考 控制台 - 项目信息。
• 已在项目中集成 ZEGO Express SDK，并实现了基本的音视频推拉流功能，详情请参考 快速开始 - 集成 和 快速开始 - 实现流程。

使用流程

1 开通云代理服务

向 ZEGO 技术支持申请开通云代理服务。开通服务后，开发者将会获取到一个云代理域名与端口信息。

2 配置云代理

调用 setCloudProxyConfig 配置云代理。

• 接口原型

/**
 * 设置云代理。
 *
 * 此接口需要在 createEngine 之前调用。
 * 调用此接口后，Express SDK 所有的网络请求与发送将通过云代理中转。
 *
 * @param proxyList 云代理信息列表，支持设置多个云代理信息。
 * @param token 鉴权 token，如果客户使用的鉴权方式是 appsign，这里可为空。否则必须填入 token。
 * @param enable 是否启用云代理。
 */
public static void setCloudProxyConfig(ArrayList<ZegoProxyInfo> proxyList, String token,
    boolean enable) 

• 调用示例

ZegoProxyInfo proxy = new ZegoProxyInfo();
//域名与端口，开发者根据开通云代理服务时获取的填写
proxy.hostName = "xxxxxxxxxxx.zego.im"; 
proxy.port = 1080;
ArrayList<ZegoProxyInfo> list = new ArrayList<~>();
list.add(proxy);
ZegoExpressEngine.setCloudProxyConfig(list, "", true);

常见问题

设置云代理不生效要如何解决？

• 确保已开通云代理服务，获取到有效的代理端口与域名。
• 确保在 createEngine 前正确设置云代理，不支持中途修改。

是否提供本地代理方案？

提供，详情请参考 本地代理。