Skip to main content

You are viewing Agora Docs forBeta products and features. Switch to Docs

You are looking at Signaling v1.x Docs. The newest version is  Signaling 2.x


To meet the laws and regulations of different countries or regions, the Agora Signaling SDK supports geofencing. You can limit the data transmission of the Signaling SDK to a specific region. After enabling geofencing, the Signaling SDK only connects to Agora Signaling within the specified region.


You need to call AgoraRTM.setArea method to specify the region for connection. After specifying the region, the SDK connects to the Agora servers within that region. The following regions are supported:

  • GLOBAL: (Default) Global.

  • CHINA: Mainland China.

  • ASIA: Asia excluding mainland China.

  • EUROPE: Europe.

  • INDIA: India.

  • JAPAN: Japan.

  • NORTH_AMERICA: North America.

If you specify the region for connection as GLOBAL, you can use the excludeArea parameter in the AgoraRTM.setArea method to remove individual region from the regions for connection possibilities.

Sample code

// Set region for geofencing
RtmServiceContext ctx = new RtmServiceContext();
ctx.areaCode = RtmServiceContext.RtmAreaCode.AREA_CODE_CN | RtmServiceContext.RtmAreaCode.AREA_CODE_AS;


Firewall requirements

If a firewall is deployed in your network environment, ensure that you add the domains in the following table according to the region you specify, allow all IP addresses, and open the following firewall ports.

  • Whitelist domains

    Region Domain

    Mainland China

    North America




    Asia excluding mainland China

  • Port - See the Firewall Requirements

API reference