多路径网络传输 (Multipath)

功能简介

随着电子设备的系统能力提升，越来越多的设备支持同时使用多出口访问网络，典型的有两出口（Wi-Fi + 蜂窝网络），甚至三出口（Wi-Fi + 双卡的蜂窝网络）。各不同出口从实际网络传输路径上互相独立，不共享瓶颈带宽。

基于该特性，RTC SDK 从 v4.6.0 起新增多路径网络传输 (Multipath) 功能，适用于终端支持多网卡传输（比如 5G、Wi-Fi、LAN）的设备，可以有效降低甚至消除弱网带来的体验回退。声网实验室测试数据显示，在带宽频繁抖动的弱网条件下，开启 Multipath 可以实现画质、延迟不回退的前提下，卡顿率降低 50% 以上，可广泛应用于网络环境差、同时对传输稳定性要求高的实时音视频互动场景，如视频会议、在线教育、IoT 平行操作、远程采播等。

本文介绍如何在你的项目中实现多路径网络传输功能。

前提条件

Android 7.0 或以上版本的移动设备，且存在两个及以上的可用网络出口。
Android API 级别 24 及以上。
已参考快速开始在项目中实现了基础的音视频互动功能。

项目设置

多路径网络传输需要读取和修改设备的网络状态权限，因此，你需要在项目的 app/src/main/AndroidManifest.xml 文件中添加如下权限：

XML

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

实现多路径网络传输

关键 API 介绍

RTC SDK 通过 ChannelMediaOptions 中的如下参数支持开启和配置多路径传输能力：

Java

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

其中，enableMultipath 参数用于开启多路径传输能力。开启后，SDK 支持两种多路径传输模式：

动态模式：（默认）根据网络状况动态选择最佳路径进行传输，适用于流量敏感、对体验要求比较高的场景，如会议、教育等。动态模式下，你可以通过 preferMultipathType 指定首选的网络传输路径（如优先 Wi-Fi 或移动网络）。
全冗余模式：数据会在所有可用网络路径上同时传输，适用于流量不敏感，对体验有极致要求的场景，如户外采播、平行操控等。该模式会产生额外费用，如需使用请联系技术支持。

上下行可以分别通过 uplinkMultipathMode 和 downlinkMultipathMode 配置传输模式。

启用后，SDK 会在 onMultipathStats 回调中实时报告各路径的传输统计信息，包括每一种网络类型的流量消耗以及每一个传输路径的实时统计数据，便于开发者监控和优化网络表现。

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;
}

示例代码

如下示例代码展示了如何开通并配置多路径网络传输功能：

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(multipathMode);
// 设置下行传输模式
mediaOptions.downlinkMultipathMode = Constants.MultipathMode.getValue(multipathMode);

// 动态传输模式下，设置传输出口类型偏好
mediaOptions.preferMultipathType = Constants.MultipathType.MULTIPATH_TYPE_WIFI.getValue();


// 报告多路径传输统计信息
@Override
public void onMultipathStats(MultipathStats stats) {
  super.onMultipathStats(stats);
  activePathNum = stats.activePathNum;
}

iOS 12.0 或以上版本的移动设备，且存在两个及以上的可用网络出口。
已参考快速开始在项目中实现了基础的音视频互动功能。

实现多路径网络传输

关键 API 介绍

RTC SDK 通过 AgoraRtcChannelMediaOptions 中的如下参数支持开启和配置多路径传输能力：

Objective-C

__attribute__((visibility("default"))) @interface AgoraRtcChannelMediaOptions : NSObject
// ...
@property(assign, nonatomic) BOOL enableMultipath;
@property(assign, nonatomic) AgoraMultipathMode uplinkMultipathMode;
@property(assign, nonatomic) AgoraMultipathMode downlinkMultipathMode;
@property(assign, nonatomic) AgoraMultipathType preferMultipathType;
@end

其中，enableMultipath 参数用于开启多路径传输能力。开启后，SDK 支持两种多路径传输模式：

动态模式：（默认）根据网络状况动态选择最佳路径进行传输，适用于流量敏感、对体验要求比较高的场景，如会议、教育等。动态模式下，你可以通过 preferMultipathType 指定首选的网络传输路径（如优先 Wi-Fi 或移动网络）。
全冗余模式：数据会在所有可用网络路径上同时传输，适用于流量不敏感，对体验有极致要求的场景，如户外采播、平行操控等。该模式会产生额外费用，如需使用请联系技术支持。

上下行可以分别通过 uplinkMultipathMode 和 downlinkMultipathMode 配置传输模式。

启用后，SDK 会在 multiPathStats 回调中实时报告各路径的传输统计信息，包括每一种网络类型的流量消耗以及每一个传输路径的实时统计数据，便于开发者监控和优化网络表现。

Objective-C

__attribute__((visibility("default"))) @interface AgoraMultipathStats : NSObject
@property (assign, nonatomic) NSUInteger lanRxBytes;
@property (assign, nonatomic) NSUInteger lanTxBytes;
@property (assign, nonatomic) NSUInteger wifiRxBytes;
@property (assign, nonatomic) NSUInteger wifiTxBytes;
@property (assign, nonatomic) NSUInteger mobileRxBytes;
@property (assign, nonatomic) NSUInteger mobileTxBytes;
@property (assign, nonatomic) NSUInteger activePathNum;
@property (copy, nonatomic) NSArray<AgoraPathStats *> *_Nullable pathStats NS_SWIFT_NAME(pathStats);
@end

示例代码

如下示例代码展示了如何开通并配置多路径网络传输功能：

Swift

// 初始化多路径传输控制器
@IBOutlet weak var selectModePicker: Picker!
func initSelectModePicker() {
    selectModePicker.label.stringValue = "Mode".localized
    selectModePicker.picker.addItems(withTitles: ["dynamic", "duplicate"])
    selectModePicker.picker.selectItem(at: 0)
}

// ...
// 开启多路径传输 
channelMediaOption.enableMultipath = (multipathSwitch.state == .on)
// 设置上行传输模式
channelMediaOption.uplinkMultipathMode = (selectModePicker.picker.indexOfSelectedItem == 0) ? .dynamic : .
// 设置下行传输模式
channelMediaOption.downlinkMultipathMode = (selectModePicker.picker.indexOfSelectedItem == 0) ? .dynamic : .duplicate

// 报告多路径传输统计信息
func rtcEngine(_ engine: AgoraRtcEngineKit, multiPathStats stats: AgoraMultipathStats) {
    videos[0].statsInfo?.updateMultipathStats(stats)
}

macOS 10.14 及以上版本的设备，且存在两个及以上的可用网络出口。
已参考快速开始在项目中实现了基础的音视频互动功能。

实现多路径网络传输

关键 API 介绍

RTC SDK 通过 AgoraRtcChannelMediaOptions 中的如下参数支持开启和配置多路径传输能力：

Objective-C

__attribute__((visibility("default"))) @interface AgoraRtcChannelMediaOptions : NSObject
// ...
@property(assign, nonatomic) BOOL enableMultipath;
@property(assign, nonatomic) AgoraMultipathMode uplinkMultipathMode;
@property(assign, nonatomic) AgoraMultipathMode downlinkMultipathMode;
@property(assign, nonatomic) AgoraMultipathType preferMultipathType;
@end

其中，enableMultipath 参数用于开启多路径传输能力。开启后，SDK 支持两种多路径传输模式：

动态模式：（默认）根据网络状况动态选择最佳路径进行传输，适用于流量敏感、对体验要求比较高的场景，如会议、教育等。动态模式下，你可以通过 preferMultipathType 指定首选的网络传输路径（如优先 Wi-Fi 或移动网络）。
全冗余模式：数据会在所有可用网络路径上同时传输，适用于流量不敏感，对体验有极致要求的场景，如户外采播、平行操控等。该模式会产生额外费用，如需使用请联系技术支持。

上下行可以分别通过 uplinkMultipathMode 和 downlinkMultipathMode 配置传输模式。

Objective-C

__attribute__((visibility("default"))) @interface AgoraMultipathStats : NSObject
@property (assign, nonatomic) NSUInteger lanRxBytes;
@property (assign, nonatomic) NSUInteger lanTxBytes;
@property (assign, nonatomic) NSUInteger wifiRxBytes;
@property (assign, nonatomic) NSUInteger wifiTxBytes;
@property (assign, nonatomic) NSUInteger mobileRxBytes;
@property (assign, nonatomic) NSUInteger mobileTxBytes;
@property (assign, nonatomic) NSUInteger activePathNum;
@property (copy, nonatomic) NSArray<AgoraPathStats *> *_Nullable pathStats NS_SWIFT_NAME(pathStats);
@end

示例代码

如下示例代码展示了如何开通并配置多路径网络传输功能：

Swift

// 初始化多路径传输控制器
@IBOutlet weak var selectModePicker: Picker!
func initSelectModePicker() {
    selectModePicker.label.stringValue = "Mode".localized
    selectModePicker.picker.addItems(withTitles: ["dynamic", "duplicate"])
    selectModePicker.picker.selectItem(at: 0)
}

// ...
// 开启多路径传输 
channelMediaOption.enableMultipath = (multipathSwitch.state == .on)
// 设置上行传输模式
channelMediaOption.uplinkMultipathMode = (selectModePicker.picker.indexOfSelectedItem == 0) ? .dynamic : .
// 设置下行传输模式
channelMediaOption.downlinkMultipathMode = (selectModePicker.picker.indexOfSelectedItem == 0) ? .dynamic : .duplicate

// 报告多路径传输统计信息
func rtcEngine(_ engine: AgoraRtcEngineKit, multiPathStats stats: AgoraMultipathStats) {
    videos[0].statsInfo?.updateMultipathStats(stats)
}

Windows Vista 及以上版本的设备，且存在两个及以上的可用网络出口。
已参考快速开始在项目中实现了基础的音视频互动功能。

实现多路径网络传输

关键 API 介绍

RTC SDK 通过 ChannelMediaOptions 中的如下参数支持开启和配置多路径传输能力：

C++

struct ChannelMediaOptions {
  // ...
  Optional<bool> enableMultipath;
  Optional<MultipathMode> uplinkMultipathMode;
  Optional<MultipathMode> downlinkMultipathMode;
  Optional<MultipathType> preferMultipathType;
};

其中，enableMultipath 参数用于开启多路径传输能力。开启后，SDK 支持两种多路径传输模式：

动态模式：（默认）根据网络状况动态选择最佳路径进行传输，适用于流量敏感、对体验要求比较高的场景，如会议、教育等。动态模式下，你可以通过 preferMultipathType 指定首选的网络传输路径（如优先 Wi-Fi 或移动网络）。
全冗余模式：数据会在所有可用网络路径上同时传输，适用于流量不敏感，对体验有极致要求的场景，如户外采播、平行操控等。该模式会产生额外费用，如需使用请联系技术支持。

上下行可以分别通过 uplinkMultipathMode 和 downlinkMultipathMode 配置传输模式。

C++

struct MultipathStats {
  uint32_t lanTxBytes;
  uint32_t lanRxBytes;
  uint32_t wifiTxBytes;
  uint32_t wifiRxBytes;
  uint32_t mobileTxBytes;
  uint32_t mobileRxBytes;
  int activePathNum;
  const PathStats* pathStats;
};

示例代码

如下示例代码展示了如何开通并配置多路径网络传输功能：

C++

// 初始化多路径传输相关的界面元素
m_cmbMultipathMode.InsertString(0, _T("Duplicate"));
m_cmbMultipathMode.InsertString(1, _T("Dynamic"));
m_cmbMultipathMode.SetCurSel(0);

// 初始化多路径传输相关控制
m_staEnableMultipath.SetWindowText(_T("Enable Multipath:"));
m_chkEnableMultipath.SetCheck(BST_UNCHECKED);

// 配置 ChannelMediaOptions
ChannelMediaOptions options;
// ...
// 开启多路径网络传输
options.enableMultipath = (m_chkEnableMultipath.GetCheck() == BST_CHECKED);;

// 获取用户指定的传输模式
int modeIndex = m_cmbMultipathMode.GetCurSel();
MultipathMode mode = (modeIndex == 0) ? Duplicate : Dynamic;
// 设置上行传输模式
options.uplinkMultipathMode = mode;
// 设置下行传输模式
options.downlinkMultipathMode = mode;

// 动态传输模式下，设置传输出口类型偏好
options.preferMultipathType = WIFI;

// 报告多路径传输统计信息
void CMultipathRtcEngineEventHandler::onMultipathStats(const MultipathStats& stats)
{
  if (m_hMsgHanlder)
  {
    MultipathStats* statsPtr = new MultipathStats(stats);
    ::PostMessage(m_hMsgHanlder, WM_MSGID(EID_MULTIPATH_STATS), (WPARAM)statsPtr, 0);
  }
}

功能简介Copy Anchor Link

前提条件Copy Anchor Link

项目设置Copy Anchor Link

实现多路径网络传输Copy Anchor Link

关键 API 介绍Copy Anchor Link

示例代码Copy Anchor Link

参考信息Copy Anchor Link

示例项目Copy Anchor Link

Multipath（Gitee）

Multipath（GitHub）

API 参考Copy Anchor Link

咨询电话

咨询电话

功能简介

前提条件

项目设置

实现多路径网络传输

关键 API 介绍

示例代码

参考信息

示例项目

API 参考