设置视频属性

更新时间: 2024/09/18 16:26:13

不同场景对于视频清晰度、流畅性等方面的要求各有不同,您需要根据场景调整合适的分辨率、码率、帧率等,以便给用户最优的通话体验。

功能描述

NERTC SDK 支持调用setLocalVideoConfig 方法的 videoConfigstreamType 参数,自定义设置主流和辅流的视频编码属性,包括分辨率、码率、帧率、带宽受限时的适应性偏好等。

注意事项

  • 本文中各参数的设置可能会影响计费。
  • NERTC SDK 会根据实时网络环境,对设置的参数作自适应调整,通常会下调参数。
  • NERTC SDK 支持在加入房间通话中后,您根据实际场景变化动态调用 setLocalVideoConfig 方法。
  • setLocalVideoConfig 为全量参数配置接口,重复调用此接口时,SDK 会刷新此前的所有参数配置,以最新的传参为准。所以每次修改配置时都需要设置所有参数,未设置的参数将取默认值。

设置视频编码分辨率、码率和帧率

您可以通过 setLocalVideoConfig 方法中的如下参数,自定义视频编码的分辨率、码率和帧率。

参数 说明
widthheight 视频编码的分辨率。单位为 px 。用来衡量编码质量,通常情况下分辨率越高,视频越清晰。
默认为 640 x 360,取值范围为64 x 64 ~ 1920 x 1080,如果设置取值范围以外的数值,则保持默认设置,即 640 x 360。
frameRate 视频编码帧率(fps)。指每秒钟编码多少帧画面。
  • 在通信模式下,建议您将帧率设置为 24 fps,用户在视觉上不会出现卡顿现象。
  • 在直播模式下,建议您将帧率适当降低至 15 fps,保证直播画面的高清晰度。
bitrate 视频码率(Bitrate),单位为 kbps。指每秒钟编码器输出多少 Kbit 的编码后的二进制数据。
推荐使用默认码率, SDK 会根据场景属性、分辨率和帧率自动设置合适的码率。若您对画面清晰度有更高的要求,推荐将码率提升至默认码率的 1.2 倍。

此处设置的数值均为理想情况下的最大值,实际场景中,如果视频引擎因网络环境或设备采集能力等原因无法达到设置的分辨率、帧率或码率的最大值时,会根据设备采集能力自动向下取值。

视频的分辨率、码率和帧率并不是越高越好,三者之间需要维持一个平衡的映射关系关系,您可以参考分辨率、帧率和码率参照表设置分辨率和码率。

典型场景的推荐配置

典型场景的视频参数推荐配置请参见音视频参数配置推荐

设置带宽受限的适应性偏好

在弱网环境下,视频的清晰度和流畅度可能无法兼顾,为保证音视频通话或互动直播场景下的视频体验,您可以通过 degradationPrefer 参数设置带宽受限时视频编码的适应性偏好。

参数 描述
DEGRADATION_BALANCED 在编码帧率和视频质量之间保持平衡。

DEGRADATION_DEFAULT

根据场景模式调整适应性偏好。

  • 通信场景中,选择 DEGRADATION_BALANCED 模式,在编码帧率和视频质量之间保持平衡。
  • 直播场景中,选择 DEGRADATION_MAINTAIN_QUALITY 模式,降低编码帧率以保证视频质量。
DEGRADATION_MAINTAIN_FRAMERATE 流畅优先,降低视频质量以保证编码帧率。在弱网环境下,降低视频清晰度以保证视频流畅,此时画质降低,画面会变得模糊,但可以保持视频流畅。
DEGRADATION_MAINTAIN_QUALITY 清晰优先,降低编码帧率以保证视频质量。在弱网环境下,降低视频帧率以保证视频清晰,此时可能会出现一定卡顿。

设置镜像模式

您可以通过 mirrorMode 参数来设置视频编码的镜像模式,影响远端用户看到的视频画面。

默认情况下,编码时由 SDK 决定镜像模式。移动端如果使用前置摄像头,则默认开启镜像模式;如果使用后置摄像头,则关闭镜像模式。

NERTC 同时支持设置视频画布的镜像模式,即画面是否左右翻转。本地设置的视频镜像模式仅影响本地用户所见,不影响远端用户所见。设置画布时 NERtcVideoView.setMirror 设置为 true 表示开启镜像模式,默认情况下镜像模式为关闭状态。
此外,由于设置本地画布(setupLocalVideoCanvas)或切换前后置摄像头(switchCamera)时,SDK 均会重置本地画布的镜像模式,建议在此之后再调用 setMirror 方法更新本地画布的镜像模式。

示例项目源码

网易云信提供 VideoQuality 示例项目源码,您可以参考该源码配置视频属性。

示例代码

NERtcVideoStreamType streamType = kNERtcStreamChannelTypeMainStream ;
NERtcVideoConfig videoConfig = new NERtcVideoConfig();
videoConfig.frontCamera = mFrontCamera;
videoConfig.videoProfile = mVideoProfile;
videoConfig.width = mVideoWidth;
videoConfig.height = mVideoHeight;
videoConfig.videoCropMode = mVideoCropMode;
videoConfig.colorFormat = mVideoColorFormat;
videoConfig.frameRate = mVideoFps;
videoConfig.minFramerate = mVideoMinFps;
videoConfig.degradationPrefer = mVideoDegradation;
videoConfig.bitrate = mVideoEncodeBitrate;
videoConfig.minBitrate = mVideoEncodeMinBitrate;
NERtcEx.getInstance().setLocalVideoConfig(videoConfig); //设置本地视频参数

相关参考

分辨率、帧率和码率参照表

在大多数场景下,您可以根据实际业务场景中的视频窗口的大小去配置分辨率、帧率、码率,以控制带宽压力及编解码的资源消耗。 在自定义视频编码参数的过程中,您也可以参考下表对这些参数进行自定义配置。

下表中的视频参数推荐仅适用于 Android、iOS、Windows、macOS 平台。

分辨率 帧率(fps) 通信场景码率(kbps) 直播场景码率(kbps)
90 x 90 30 49 73
90 x 90 15 32 48
120 x 90 30 61 91
120 x 90 15 40 60
120 x 120 30 75 113
120 x 120 15 50 75
160 x 90 30 75 113
160 x 90 15 50 75
160 x 120 30 94 141
160 x 120 15 62 93
180 x 180 30 139 208
180 x 180 15 91 137
240 x 180 30 172 259
240 x 180 15 113 170
240 x 240 30 214 321
240 x 240 15 141 212
320 x 180 30 214 321
320 x 180 15 141 212
320 x 240 30 259 389
320 x 240 15 175 263
360 x 360 30 393 590
360 x 360 15 259 389
424 x 240 15 217 325
480 x 360 30 488 732
480 x 360 15 322 483
480 x 480 30 606 909
480 x 480 15 400 600
640 x 360 30 606 909
640 x 360 15 400 600
640 x 480 30 752 1128
640 x 480 15 496 744
720 x 720 30 1113 1670
720 x 720 15 734 1102
848 x 480 30 929 1394
848 x 480 15 613 919
960 x 720 30 1382 2073
960 x 720 15 911 1367
1080 x 1080 30 2046 3069
1080 x 1080 15 1350 2025
1280 x 720 30 1714 2572
1280 x 720 15 1131 1697
1440 x 1080 30 2538 3808
1440 x 1080 15 1675 2512
1920 x 1080 30 3150 4725
1920 x 1080 15 2078 3117

常见问题

此文档是否对你有帮助?
有帮助
去反馈
  • 功能描述
  • 注意事项
  • 设置视频编码分辨率、码率和帧率
  • 典型场景的推荐配置
  • 设置带宽受限的适应性偏好
  • 设置镜像模式
  • 示例项目源码
  • 示例代码
  • 相关参考
  • 分辨率、帧率和码率参照表
  • 常见问题