为适应不同国家或地区的法律法规,声网支持限定访问区域功能。开启限定访问区域功能后,不论用户在哪个区域使用你的 app,SDK 都只会访问指定区域的声网服务器。
例如你指定了北美为访问区域,假设有两位用户分别从北美和中国连接声网服务器:
指定的访问区域 | App 用户所在区域 | SDK 实际访问的区域 | 连接后的用户体验 1 |
---|---|---|---|
北美 | 北美 | 北美 | 正常 |
中国 | 可能受到较大影响 2 |
声网 RTC Native SDK 从 v3.0.0.2 起,支持限定区域访问。一旦指定了访问区域,音视频数据将不会访问指定区域以外的服务器。
你需要在调用 create
方法创建 RtcEngine
实例时,通过设置 RtcEngineConfig
中的 mAreaCode
参数来指定访问区域。
AREA_CODE_GLOB
: (默认)全球。AREA_CODE_CN
: 中国大陆。AREA_CODE_NA
: 北美。AREA_CODE_EU
: 欧洲。AREA_CODE_AS
: 除中国大陆以外的亚洲区域。AREA_CODE_JP
: 日本。AREA_CODE_IN
: 印度。// 初始化 RtcEngine 对象。
private void initializeEngine() {
try {
// 指定仅访问北美的服务器。
int areaCode = AREA_CODE_NA;
RtcEngineConfig config = new RtcEngineConfig();
config.mAppId = appId;
config.mContext = mContext;
config.mEventHandler = mEngineEventHandler.mRtcEventHandler;
config.mAreaCode = areaCode;
mRtcEngine = RtcEngine.create(config);
} catch (Exception e) {
Log.e(TAG, Log.getStackTraceString(e));
throw new RuntimeException("NEED TO check rtc sdk init fatal error\n" + Log.getStackTraceString(e));
}
...
}
如果你的网络环境部署了防火墙,使用该功能还需要根据使用云代理添加防火墙白名单。