网络测速

1 功能简介

ZEGO 提供网络测速功能，可在用户进行推/拉流前，检测上行和下行网络速度，判断当前网络环境下适合推/拉多大码率的音视频流。

当上行测速结果显示丢包率较高时，推荐使用降低分辨率或降低帧率等方法降低推流码率，以保证正常推流；当下行测速结果显示丢包率较高时，推荐使用 SDK 提供的 视频进阶 - 分层视频编码 功能拉取低码率的流，以保证正常拉流。

开发者业务中出现以下情况时，ZEGO 推荐使用 SDK 的网络测速功能：

• 通话场景下，需要进行网络质量评估。

• 教育场景下，需要进行课前网络检测。

• 直播场景下，需要进行网络连接速度测试。

网络测速基本原理如下图所示：

2 示例源码下载

请参考 下载示例源码 获取源码。

相关源码请查看 “/ZegoExpressExample/Examples/Others/NetworkAndPerformance” 目录下的文件。

3 前提条件

在实现网络测速功能之前，请确保：

• 已在项目中集成 ZEGO Express SDK，实现基本的实时音视频功能，详情请参考 快速开始 - 集成 和 快速开始 - 实现流程。
• 已在 ZEGO 控制台 创建项目，并申请有效的 AppID 和 AppSign，详情请参考 控制台 - 项目信息。

4 使用步骤

4.1 监听测速回调

开始测速前，可先设置测速相关的回调。

• 正常测速情况下，网速质量更新时会触发 onNetworkSpeedTestQualityUpdate 回调。
• 测速过程中发生错误时，会触发 onNetworkSpeedTestError 回调。

// 网络测速质量回调
- (void)onNetworkSpeedTestQualityUpdate:(ZegoNetworkSpeedTestQuality *)quality type:(ZegoNetworkSpeedTestType)type {
     NSLog(@"onNetworkSpeedTestQualityUpdate rtt=%d packetLostRate=%f connectCost=%d type=%d", quality.rtt, quality.packetLostRate, quality.connectCost, type);
}

// 网络测速异常回调
- (void)onNetworkSpeedTestError:(int)errorCode type:(ZegoNetworkSpeedTestType)type {
     NSLog(@"onNetworkSpeedTestError errorCode=%d, type=%d", errorCode, type);
}

4.2 开始测速

创建 ZegoNetworkSpeedTestConfig 网络测速配置的实例，根据实际情况设置是否进行上下行测速及期望码率，调用 startNetworkSpeedTest 接口开启网络测速。

ZegoNetworkSpeedTestConfig *config = [[ZegoNetworkSpeedTestConfig alloc] init];
ZegoVideoConfig *videoConfig = [[ZegoExpressEngine sharedEngine] getVideoConfig];

// 进行上行测速，指定期望推流码率
config.testUplink = YES;
config.expectedUplinkBitrate = videoConfig.bitrate;

// 进行下行测速，指定期望拉流码率
config.testDownlink = YES;
config.expectedDownlinkBitrate = videoConfig.bitrate;

// 开始测速，默认回调间隔为 3 秒
[[ZegoExpressEngine sharedEngine] startNetworkSpeedTest:config];

// 若需设置回调间隔，可参考如下调用（以 1.5 秒为例）
[[ZegoExpressEngine sharedEngine] startNetworkSpeedTest:config interval:1500];

测速结果将在 onNetworkSpeedTestQualityUpdate 中的网络测速质量 ZegoNetworkSpeedTestQuality 返回，通过分析各参数值，可得知当前网络质量是否良好。

ZegoNetworkSpeedTestQuality 中各参数如下：

4.3 停止测速

调用 stopNetworkSpeedTest 接口停止网络测速。

停止测速后，将不会再收到 onNetworkSpeedTestQualityUpdate 或 onNetworkSpeedTestError 回调。

[[ZegoExpressEngine sharedEngine] stopNetworkSpeedTest];

5 API 参考列表