文档中心
ExpressVideoSDK 实时音视频
文档中心
体验 App
SDK 中心
API 中心
常见问题
代码市场
进入控制台
立即注册
登录
中文站 English
  • 文档中心
  • 实时音视频
  • 通信能力
  • 网络测速

网络测速

更新时间:2024-01-02 18:48

功能简介

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

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

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

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

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

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

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

/Pics/Common/ZegoExpressEngine/Network_speed_test.png

示例源码下载

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

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

前提条件

在实现网络测速功能之前,请确保:

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

使用步骤

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

2 开始测速

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

调用 startNetworkSpeedTest 接口开启测速后,默认支持测速 30 秒(如需调整时长,请联系 ZEGO 技术支持修改动态配置),超时后会强制结束测速。如需继续测速,请再次调用该接口。

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 中各参数如下:

参数 描述 说明
connectCost
连接服务器耗时,单位为毫秒。
测速过程中如果网络连接断开会自动发起重连,此变量会相应更新,数值越小越好。
rtt
网络延时,单位为毫秒。
代表 SDK 与服务器往返之间所消耗的时间,数值越小越好。
packetLostRate
丢包率,单位为百分比。
取值范围在 0.0 - 1.0,例如 0.5 代表每向服务器发送的 10 个数据包中,可能有其中 5 个会在中途丢失。
quality
网络质量
代表当前网络质量水平,具体可参见 ZegoStreamQualityLevel。

  • ZegoStreamQualityLevelExcellent:质量极好。
  • ZegoStreamQualityLevelGood:质量好。
  • ZegoStreamQualityLevelMedium:质量正常。
  • ZegoStreamQualityLevelBad:质量差。
  • ZegoStreamQualityLevelDie:质量异常。
  • ZegoStreamQualityLevelUnknown:质量未知。

    3 停止测速

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

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

    [[ZegoExpressEngine sharedEngine] stopNetworkSpeedTest];
    本篇目录
    • 免费试用
    • 提交工单
      咨询集成、功能及报价等问题
      电话咨询
      400 1006 604
      咨询客服
      微信扫码,24h在线

      联系我们

    • 文档反馈