阿里云RTC提供网络质量监控功能,您可以通过使用AliRtcNetworkQuality回调来获取网络质量评价。

功能简介

在网络质量不理想的情况下,音视频通信的质量受客观因素影响会下降。当监控到弱网环境时,为保证基础通信体验,建议您使用SDK对应的方法分别在发布端和订阅端进行如下优化。

  • 调整视频流规格:通过设置较低档位规格的VideoProfile,减少视频通信的网络资源占用。
  • 切换视频为小流:小流有着与大流相同的宽高比,但是分辨率和码率相对较低,网络资源占用的需求较低。
  • 仅发布音频流:在极端网络环境下,可以选择只发送音频流,从而保证通信的持续。

通过使用AliRtcNetworkQuality回调获取的网络评价如下所示。

枚举名 描述
Network_Excellent 网络极好,流程度清晰度质量好
Network_Good 网络好,流畅度清晰度和极好差不多
Network_Poor 网络较差,音视频流畅度清晰度有瑕疵,不影响沟通
Network_Bad 网络差,视频卡顿严重,音频能正常沟通
Network_VeryBad 网络极差,基本无法沟通
Network_Disconnected 网络中断
Network_Unknow 未知原因

实现方法

在实现该功能之前,需要您已经搭建AppServer、实现基本功能等操作。详情请参见入门概述

具体实现方法如下所示。

您可以通过onNetworkQualityChanged(网络状况变化时回调)方法获得网络质量,然后在根据实际策略进行优化。

void onNetworkQualityChanged(String uid, AliRtcNetworkQuality upQuality, AliRtcNetworkQuality downQuality);
参数 类型 描述
downQuality AliRtcNetworkQuality 下行网络质量
upQuality AliRtcNetworkQuality 上行网络质量
uid String 用户ID
  • 您可以在视频中调用setVideoProfile设置视频流规格。

    说明 通过设置较低规格的视频流,减少视频通信的网络资源占用。
    //调用示例
    mAliRtcEngine.setVideoProfile(profile, vt);
    //接口方法
    public void setVideoProfile(AliRtcVideoProfile profile, AliRtcVideoTrack track);
    参数 类型 描述
    profile AliRtcVideoProfile 视频流参数。默认分辨率480*640,帧率15的相机流。
    track AliRtcVideoTrack 需要设置的视频流类型。
  • 调用configRemoteCameraTrack将订阅视频切换为小流。

    说明 当网络质量恢复优良状态时,请您根据实际需求决定是否切换至优先订阅大流(即默认的订阅模式)。
    //接口方法
    public void configRemoteCameraTrack(String uid, boolean master, boolean enable)
    //重新订阅
    mAliRtcEngine.subscribe(uid);
    参数 类型 描述
    uid String 用户ID
    master boolean 是否大流
    enable boolean 是否可用
    • 订阅视频切换为小流可以编写如下代码:
      mAliRtcEngine.configRemoteCameraTrack(uid, false, true);
      mAliRtcEngine.subscribe(uid);
    • 订阅视频切换为大流可以编写如下代码:
      mAliRtcEngine.configRemoteCameraTrack(uid, true, true);
      mAliRtcEngine.subscribe(uid);
  • 调用configLocalCameraPublish方法实现仅发布音频流。

    说明 当网络质量恢复优良状态时,请您根据实际需求决定是否重新发布音视频流。
    mAliRtcEngine.configLocalCameraPublish(false);
    mAliRtcEngine.publish();
    参数 类型 描述
    enable boolean 是否允许

获得更多功能实现方法,请参见AliRtcEngine接口