To meet the laws and regulations of different countries or regions, the Agora RTC SDK supports geofencing. After enabling geofencing, the SDK only connects to Agora servers within the specified region, regardless of where your app users are located.
For example, if you specify North America as the region for connection, when two users attempt to connect to Agora servers from different locations, the result is as follows:
Specified region for connection | App user location | Actual region for connection | User experience after connection 1 |
---|---|---|---|
North America | North America | North America | Normal |
China | Can be less than optimal 2 |
As of v3.0.1, the Agora RTC Unity SDK supports network geofencing.
When initializing the SDK by calling GetEngine
, set the areaCode
parameter in RtcEngineConfig
to specify the region for connection.
AREA_CODE_GLOB
: (Default) GlobalAREA_CODE_CN
: Mainland ChinaAREA_CODE_NA
: North AmericaAREA_CODE_EU
: EuropeAREA_CODE_AS
: Asia, excluding Mainland ChinaAREA_CODE_JP
: JapanAREA_CODE_IN
: India// Initialize IRtcEngine and specify the region as North America.
RtcEngineConfig mRtcEngineConfig = new RtcEngineConfig(appId, AREA_CODE.AREA_CODE_NA);
mRtcEngine = IRtcEngine.GetEngine(mRtcEngineConfig);
}
If a firewall is deployed in your network environment, ensure that you whitelist all domains and ports listed in Use Cloud Proxy.