# Multipath network transmission (/en/realtime-media/video/build/manage-connection-and-quality/multipath-transmission/android)

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

A growing number of electronic devices support simultaneous network access through multiple connections, such as Wi-Fi and cellular, or Wi-Fi and dual-SIM cellular. Each connection is independent of the actual network transmission path and does not share bandwidth bottlenecks.

This page explains how to implement multipath network transmission in your Video Calling project.

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

Starting with v4.6.0, Video SDK adds a network transmission feature called Multipath. This feature is designed for devices that support multiple network interfaces, including 5G, Wi-Fi, and LAN. Multipath helps reduce or even eliminate poor user experiences caused by weak network conditions. In lab tests, under weak network conditions with frequent bandwidth jitter, enabling Multipath reduces lag by more than 50% while maintaining image quality and latency.

Multipath improves real-time audio and video experiences that require stable transmission in poor network conditions, including video conferencing, online education, IoT parallel operations, and remote production and broadcasting.

## Prerequisites [#prerequisites]

Before you begin, make sure you have:

      
    * A mobile device running Android 7.0 (API level 24) or later, with two or more active network connections.

    
  
      
  
      
  
      
  
* Basic audio and video interaction functions already implemented in your project. See [Quickstart](/en/realtime-media/video/get-started-sdk).

## Implementation [#implementation]

      
    ### Add network permissions [#add-network-permissions]

    Multipath requires permission to access and manage the device network state. Add the following permissions to `/app/src/main/AndroidManifest.xml`:

    ```xml
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
    <uses-permission android:name="android.permission.CHANGE_NETWORK_STATE"/>
    ```

    ### Multipath APIs [#multipath-apis]

    Video SDK supports enabling and configuring Multipath through the following `ChannelMediaOptions` fields:

    ```java
    public class ChannelMediaOptions {
      // ...
      public Boolean enableMultipath;
      public Integer uplinkMultipathMode;
      public Integer downlinkMultipathMode;
      public Integer preferMultipathType;
    }
    ```

    Use `enableMultipath` to enable multipath transmission. Once enabled, the SDK supports two transmission modes:

    * **Dynamic mode** (default): Dynamically selects the optimal transmission path based on network conditions. This mode is suitable for traffic-sensitive scenarios with high user experience requirements, such as conferences and education. In this mode, you can use `preferMultipathType` to specify a preferred network path, such as Wi-Fi or mobile network.

    * **Full redundancy mode**: Sends data simultaneously across all available network paths. This mode is suitable for scenarios where traffic use is less sensitive but a highly reliable user experience is required, such as outdoor production, broadcasting, and parallel operation. This mode incurs additional fees. Contact [support@agora.io](mailto\:support@agora.io) to enable it.

    You can configure the transmission mode separately for uplink (`uplinkMultipathMode`) and downlink (`downlinkMultipathMode`).

    When Multipath is enabled, the SDK reports transmission statistics for each path in real time through the `onMultipathStats` callback. These statistics include traffic consumption for each network type and real-time performance metrics for each path, making it easier to monitor and optimize network performance.

    ```java
    public static class MultipathStats {
      public int lanTxBytes;
      public int lanRxBytes;
      public int wifiTxBytes;
      public int wifiRxBytes;
      public int mobileTxBytes;
      public int mobileRxBytes;
      public int activePathNum;
      public PathStats[] pathStats;
    }
    ```

    ### Sample code [#sample-code]

    ```java
    private String multipathModeStr = "";
    private int activePathNum = 0;

    mediaOptions.enableMultipath = true;

    multipathModeStr = spinner_multipath_mode.getSelectedItem().toString();
    Constants.MultipathMode multipathMode = Constants.MultipathMode.valueOf(multipathModeStr);

    mediaOptions.uplinkMultipathMode = Constants.MultipathMode.getValue(Constants.MultipathMode.DYNAMIC);
    mediaOptions.downlinkMultipathMode = Constants.MultipathMode.getValue(Constants.MultipathMode.DYNAMIC);
    mediaOptions.preferMultipathType = Constants.MultipathType.MULTIPATH_TYPE_WIFI.getValue();

    @Override
    public void onMultipathStats(MultipathStats stats) {
      super.onMultipathStats(stats);
      activePathNum = stats.activePathNum;
    }
    ```

    
  
      
  
      
  
      
  
## Reference [#reference]

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

      
    ### API reference [#api-reference]

    * [`ChannelMediaOptions`](/en/api-reference/rtc/android/class-and-enum/classes/class-channelmediaoptions)
    * [MultipathStats](https://api-ref.agora.io/en/video-sdk/android/4.x/API/class_multipathstats.html)
    * [`onMultipathStats`](/en/api-reference/rtc/android/network-and-other#callback_irtcengineeventhandler_onmultipathstats)