功能简介

在视频通话或互动直播中设置视频属性,可以根据用户喜好,调整视频画面的清晰度和流畅度,获得较高的用户体验。

视频属性一般包含视频分辨率、帧率、码率、方向模式等参数。

实现方法

在设置视频属性前,请确保你已完成环境准备、安装包获取等步骤,详见集成客户端

Agora SDK 通过 setVideoEncoderConfiguration 方法来设置视频相关的属性,比如分辨率、码率、帧率等。参数均为理想情况下的最大值。当视频引擎因网络环境等原因无法达到设置的分辨率、帧率或码率的最大值时,会取最接近最大值的那个值。

// 配置一个 VideoEncoderConfiguration 实例,参数可参考下文中的 API 参考链接
VideoEncoderConfiguration config = new VideoEncoderConfiguration(
    // 视频分辨率。可以选择默认的几种分辨率选项,也可以自定义
    VideoDimensions.VD_640x480,
    // 视频编码帧率。可自定义。通常建议是 15 帧,不超过 30 帧
    FRAME_RATE_FPS_15,
    // 标准码率。也可以配置其它的码率值,但一般情况下推荐使用标准码率
    STANDARD_BITRATE,
    // 方向模式
    ORIENTATION_MODE_ADAPTIVE,
    // 带宽受限时,视频编码降级偏好;MAINTAIN_QUALITY(0),表示带宽受限时,降低帧率以保证视频质量
    MAINTAIN_QUALITY
);

rtcEngine.setVideoEncoderConfiguration(config);

API 参考

开发注意事项

  • degradationPrefer 参数设置为 MAINTAIN_QUALITY,表示带宽受限时,降低编码帧率以保证视频质量。此时开发者可以使用 minFrameRate 参数设置当前最低的编码帧率,用于平衡帧率和视频质量。通常来说:

    • minFrameRate 较低时,一旦带宽不足,帧率下降幅度较大,画质清晰度受影响比较小
    • minFrameRate 较高时,一旦带宽不足,帧率下降幅度有限,画质清晰度受影响比较大

    请确保 minFrameRate 的值不超过 frameRate 的值。minFrameRate 的系统默认值是经过实验且能满足一般情况下的需求,我们建议用户不要修改该参数的默认值。

  • 如果用户加入频道后不需要重新设置视频编码属性,建议在 enableVideo 前调用 setVideoEncoderConfiguration ,可以加快首帧出图的时间。

  • Agora SDK 会根据实时网络环境,对设置的参数作自适应调整,通常会下调参数。

  • 通常的,直播场景下需要较大码率来提升视频质量。因此 Agora 建议将直播码率值设为通信值的 2 倍。详情请参考设置码率

  • 直播模式通常需要更大的码率来支持清晰度,因此建议主播使用较稳定的网络。

  • 本文中各参数的设置可能会影响计费,详情请参考计费

用户常见问题

能否推荐一些常用的视频分辨率、帧率和码率?

通常来讲,视频参数的选择要根据产品实际情况和场景来确定,比如,如果是1对1 ,老师和学生的窗口比较大,要求分辨率会高一点,随之帧率和码率也要高一点;如果是1对4, 老师和学生的窗口都比较小,分辨率可以低一点,对应的码率帧率也会低一点,以减少编解码的资源消耗和缓解下行带宽压力。一般可按下列场景中的推荐值进行设置。

  • 2 人视频通话场景:
    • 分辨率 320*240、帧率 15 fps、码率 200 Kbps
    • 分辨率 640*360、帧率 15 fps、码率 400 Kbps
  • 多人视频通话场景:
    • 分辨率 160*120、帧率 15 fps、码率 65 Kbps
    • 分辨率 320*180、帧率 15 fps、码率 140 Kbps
    • 分辨率 320*240、帧率 15 fps、码率 200 Kbps

如果你希望自定义视频参数,比如调高码率以保证视频质量,也可以使用 setVideoEncoderConfiguration 对各参数进行自定义设置。