设置视频属性
更新时间: 2024/09/18 16:26:13
不同场景对于视频清晰度、流畅性等方面的要求各有不同,您需要根据场景调整合适的分辨率、码率、帧率等,以便给用户最优的通话体验。
功能描述
NERTC SDK 支持调用setLocalVideoConfig
方法的 videoConfig
和 streamType
参数,自定义设置主流和辅流的视频编码属性,包括分辨率、码率、帧率、带宽受限时的适应性偏好等。
-
degradationPrefer
:设置带宽受限时视频编码的适应性偏好。 -
orientationMode
:设置本地视频编码的旋转方向模式。 -
mirrorMode
:设置视频编码的镜像模式。
注意事项
- 本文中各参数的设置可能会影响计费。
- NERTC SDK 会根据实时网络环境,对设置的参数作自适应调整,通常会下调参数。
- NERTC SDK 支持在加入房间通话中后,您根据实际场景变化动态调用
setLocalVideoConfig
方法。 setLocalVideoConfig
为全量参数配置接口,重复调用此接口时,SDK 会刷新此前的所有参数配置,以最新的传参为准。所以每次修改配置时都需要设置所有参数,未设置的参数将取默认值。
设置视频编码分辨率、码率和帧率
您可以通过 setLocalVideoConfig
方法中的如下参数,自定义视频编码的分辨率、码率和帧率。
参数 | 说明 |
---|---|
width 和 height |
视频编码的分辨率。单位为 px 。用来衡量编码质量,通常情况下分辨率越高,视频越清晰。 默认为 640 x 360,取值范围为64 x 64 ~ 1920 x 1080,如果设置取值范围以外的数值,则保持默认设置,即 640 x 360。 |
frameRate |
视频编码帧率(fps)。指每秒钟编码多少帧画面。
|
bitrate |
视频码率(Bitrate),单位为 kbps。指每秒钟编码器输出多少 Kbit 的编码后的二进制数据。 推荐使用默认码率, SDK 会根据场景属性、分辨率和帧率自动设置合适的码率。若您对画面清晰度有更高的要求,推荐将码率提升至默认码率的 1.2 倍。 |
此处设置的数值均为理想情况下的最大值,实际场景中,如果视频引擎因网络环境或设备采集能力等原因无法达到设置的分辨率、帧率或码率的最大值时,会根据设备采集能力自动向下取值。
视频的分辨率、码率和帧率并不是越高越好,三者之间需要维持一个平衡的映射关系关系,您可以参考分辨率、帧率和码率参照表设置分辨率和码率。
典型场景的推荐配置
典型场景的视频参数推荐配置请参见音视频参数配置推荐。
设置带宽受限的适应性偏好
在弱网环境下,视频的清晰度和流畅度可能无法兼顾,为保证音视频通话或互动直播场景下的视频体验,您可以通过 degradationPrefer
参数设置带宽受限时视频编码的适应性偏好。
参数 | 描述 |
---|---|
degradationBalanced | 在编码帧率和视频质量之间保持平衡。 |
degradationDefault |
根据场景模式调整适应性偏好。
|
degradationMaintainFrameRate | 流畅优先,降低视频质量以保证编码帧率。在弱网环境下,降低视频清晰度以保证视频流畅,此时画质降低,画面会变得模糊,但可以保持视频流畅。 |
degradationMaintainQuality | 清晰优先,降低编码帧率以保证视频质量。在弱网环境下,降低视频帧率以保证视频清晰,此时可能会出现一定卡顿。 |
设置镜像模式
您可以通过 mirrorMode
参数来设置视频编码的镜像模式,影响远端用户看到的视频画面。
默认情况下,编码时由 SDK 决定镜像模式。移动端如果使用前置摄像头,则默认开启镜像模式;如果使用后置摄像头,则关闭镜像模式。
NERtcVideoView.mirrorListenable
设置为 true 表示开启镜像模式,默认情况下镜像模式为关闭状态。
此外,由于设置本地画布NERtcVideoView
或切换前后置摄像头switchCamera
时,SDK 均会重置本地画布的镜像模式,建议在此之后再调用 setMirror
方法更新本地画布的镜像模式。
示例代码
int streamType = NERtcVideoStreamType.main;
NERtcVideoConfig videoConfig = 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;
await _engine.setLocalVideoConfig(videoConfig, streamType: streamType); //设置本地视频参数
相关参考
分辨率、帧率和码率参照表
在大多数场景下,您可以根据实际业务场景中的视频窗口的大小去配置分辨率、帧率、码率,以控制带宽压力及编解码的资源消耗。 在自定义视频编码参数的过程中,您也可以参考下表对这些参数进行自定义配置。
下表中的视频参数推荐仅适用于 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 |
常见问题
-
分辨率是越高越好吗?
分辨率不是越高越好,较高的分辨率需要有较高的码率来支撑。高分辨率、高码率会提供高质量的视频,但同时会增加对宽带的压力,可能导致视频卡顿。建议您根据实际场景选择对应的分辨率,具体请参考音视频参数配置推荐,如果需要自定义分辨率,请参考分辨率、帧率和码率参照表设置合理的值。