# Restrict media zones (/en/realtime-media/video/build/manage-connection-and-quality/geofencing/ios)

> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).

When a user joins a channel, Video SDK automatically connects them to the Agora SDRTN® media zone that is geographically closest to the user. However, to meet the laws and regulations of the user's country, you may need to specify, or filter out connections to a specific geographical zone. Agora enables you to control and customize data routing in your app by specifying the Agora SDRTN® media zone users connect to.

    <CalloutContainer type="info">
      <CalloutDescription>
        This is an advanced feature suitable only for use-cases with access security restrictions.
      </CalloutDescription>
    </CalloutContainer>

    ## Understand the tech [#understand-the-tech-1]

    After you turn on the restricted media zones feature, the SDK only accesses the Agora server in the specified zone(s), irrespective of the geographical location of the user. As an example, the following table shows the outcome if you specify North America as the access zone, and users connect to Agora SDRTN® from North America and China respectively:

    | Designated access zone | User's location | Zone actually accessed by the SDK | User experience         |
    | ---------------------- | --------------- | --------------------------------- | ----------------------- |
    | North America          | North America   | North America                     | Normal                  |
    | North America          | China           | North America                     | Quality may be affected |

    <CalloutContainer type="info">
      <CalloutDescription>
        * If a server in the specified zone is not available, the SDK reports an error.
        * Due to cross-regional public internet between the designated zone and the geographical location where the app user is located, the audio and video experience may be affected.
      </CalloutDescription>
    </CalloutContainer>

    The following figure shows the workflow you implement to restrict access to media zones:

    **Restrict media zones**

    ![Restrict media zones](https://assets-docs.agora.io/images/video-sdk/restrict-media-zones.svg)

    ## Prerequisites [#prerequisites-1]

    Ensure that you have implemented the [SDK quickstart](/en/realtime-media/video/get-started-sdk) in your project.

    ## Implement restricted media zones [#implement-restricted-media-zones-1]

    This section shows you how to restrict access to media zones in your app.

    You specify the access zones by setting the `AgoraRtcEngineConfig.areaCode` parameter when calling the `sharedEngineWithConfig` method to create an instance of `AgoraRtcEngineKit`.

    * `AgoraAreaCodeType.global`: Global (Default)
    * `AgoraAreaCodeType.AS` : Asia except Mainland China
    * `AgoraAreaCodeType.CN` : Mainland China
    * `AgoraAreaCodeType.EUR` : Europe
    * `AgoraAreaCodeType.IN` : India
    * `AgoraAreaCodeType.JP` : Japan
    * `AgoraAreaCodeType.NA` : North America

    <CalloutContainer type="info">
      <CalloutDescription>
        Media zones support bitwise operations.
      </CalloutDescription>
    </CalloutContainer>

    ### Include a media zone [#include-a-media-zone-1]

    To limit access to servers in only one zone, such as North America, set `config.areaCode = .NA` before creating the `AgoraRtcEngineKit` instance.

    ```swift
    // Initialize AgoraEngine
    func initializeAgoraEngine() {
       let config = AgoraRtcEngineConfig()
       // Pass in your App ID
       config.appId = "YourAppId"
       config.channelProfile = .liveBroadcasting
       // Specify access to only servers in North America
       config.areaCode = .NA
       agoraKit = AgoraRtcEngineKit.sharedEngine(with: config, delegate: self)
     }
    ```

    ### Exclude a media zone [#exclude-a-media-zone-1]

    To exclude servers in a zone, such as Mainland China, set `config.areaCode = AgoraAreaCodeType(rawValue: AgoraAreaCodeType.global.rawValue ^ AgoraAreaCodeType.CN.rawValue)！` before creating the `AgoraRtcEngineKit` instance.

    ```swift
    // Initialize AgoraEngine
    func initializeAgoraEngine() {
      let config = AgoraRtcEngineConfig()
      // Pass in your App ID
      config.appId = "YourAppId"
      config.channelProfile = .liveBroadcasting
      // Exclude Mainland China from access area
      config.areaCode = AgoraAreaCodeType(rawValue: AgoraAreaCodeType.global.rawValue ^ AgoraAreaCodeType.CN.rawValue)！
      agoraKit = AgoraRtcEngineKit.sharedEngine(with: config, delegate: self)
    }
    ```

    ## Reference [#reference-1]

    This section contains content that completes the information on this page, or points you to documentation that explains other aspects to this product.

    ### API reference [#api-reference-1]

    * [`areaCode`](https://api-ref.agora.io/en/video-sdk/ios/4.x/documentation/agorartckit/agorartcengineconfig/areacode)
    * [`AgoraRtcEngineConfig`](https://api-ref.agora.io/en/video-sdk/ios/4.x/documentation/agorartckit/agorartcengineconfig)
    * [`AgoraAreaCodeType`](https://api-ref.agora.io/en/video-sdk/ios/4.x/documentation/agorartckit/agoraareacodetype)

    
  
      
  
      
  
      
  
      
  
      
  
      
  
      
  
      
  
      
  
