网络与性能

---

1 功能简介

ZEGO 提供网络测速功能，可用于检测网络环境是否适合推/拉指定码率的流。

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

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

• 通话场景下，需要进行网络质量评估。
• 教育场景下，需要进行课前网络检测。
• 直播场景下，需要进行网络连接速度测试。

2 前提条件

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

• 已在项目中集成 ZEGO LiveRoom SDK，实现基本的互动视频功能，详情请参考 快速开始 的相关文档。
• 已在 ZEGO 控制台 创建项目，并申请有效的 AppID 和 AppSign，详情请参考 控制台 - 项目管理。

3 使用步骤

3.1 监听测速回调

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

测试连接的结果，会通过 onConnectResult: 回调。正常测速情况下，网速质量更新时会触发 onUpdateSpeed:probeType: 回调。测速过程中发生错误时，会触发 onTestStop:probeType: 回调，主动停止不会触发 onTestStop:probeType: 。

- (void)onConnectResult:(int)errcode connectinfo:(ZegoNetConnectInfo*)info probeType:(ZegoProbeType)type;
{
    NSLog(@"onConnectResulterrorCode=%d type=%d cost=%d", errorCode, type, info.connectcost);
}

- (void)onUpdateSpeed:(ZegoNetQuality*)quality probeType:(ZegoProbeType)type
{
    NSLog(@"onUpdateSpeedrtt=%d packetLostRate=%f connectCost=%d type=%d", netQuality.rtt, netQuality.pktlostrate, netQuality.connectcost, type);
}

- (void)onTestStop:(int)errcode probeType:(ZegoProbeType)type
{
    NSLog(@"onTestStoperrorCode=%d type=%d", errorCode, type);
}

3.2 连接性测试

调用 startConnectivityTest 接口开启网络连接性测试；连接性测试结果，会通过 onConnectResult: 回调通知；调用 stopConnectivityTest 接口停止网络连通性测试。

// 进行连通性测试
[[ZegoNetWorkProbe sharedInstance] startConnectivityTest];
// 停止连通性测试
[[ZegoNetWorkProbe sharedInstance] stopConnectivityTest];

3.3 上行测速

调用 startUplinkSpeedTest: 接口开启上行测速；调用 stopUplinkSpeedTest 接口停止上行测速。

// 进行期望码率为 800000 的上行测速
[[ZegoNetWorkProbe sharedInstance] startUplinkSpeedTest:800000];
// 停止上行测速
[[ZegoNetWorkProbe sharedInstance] stopUplinkSpeedTest];

3.4 下行测速

调用 startDownlinkSpeedTest: 接口开启下行测速；调用 stopDownlinkSpeedTest 接口停止下行测速。

// 进行期望码率为 800000 的下行测速
[[ZegoNetWorkProbe sharedInstance] startDownlinkSpeedTest:800000];
// 停止下行测速
[[ZegoNetWorkProbe sharedInstance] stopDownlinkSpeedTest];

4 API 参考列表