网络与性能

---

1 功能简介

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

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

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

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

2 前提条件

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

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

3 使用步骤

3.1 监听测速回调

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

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

ZegoNetWorkProbe.getInstance().setNetWorkProbeCallback(new IZegoNetWorkProbeCallback() {
    @Override
    public void onConnectResult(int errcode,ZegoNetConnectInfo info, final int type) {

    }

    @Override
    public void onUpdateSpeed(ZegoNetQualityInfo quality, final int type) {

    }

    @Override
    public void onTestStop(int errcode, final int type) {

    }
});

3.2 连接性测试

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

// 进行连通性测试
ZegoNetWorkProbe.getInstance().startConnectivityTest();
// 停止连通性测试
ZegoNetWorkProbe.getInstance().stopConnectivityTest();

3.3 上行测速

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

// 进行期望码率为 800000 的上行测速
ZegoNetWorkProbe.getInstance().startUplinkSpeedTest(800000);
// 停止上行测速
ZegoNetWorkProbe.getInstance().stopUplinkSpeedTest();

3.4 下行测速

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

// 进行期望码率为 800000 的下行测速
ZegoNetWorkProbe.getInstance().startDownlinkSpeedTest(800000);
// 停止下行测速
ZegoNetWorkProbe.getInstance().stopDownlinkSpeedTest();

4 API 参考列表