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

功能描述

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

• degradation_preference ：设置带宽受限时视频编码的适应性偏好。

• orientation_mode ：设置本地视频编码的旋转方向模式。

• mirror_mode ：设置视频编码的镜像模式。

前提条件

请确保已在项目中实现了基本的音视频通信或直播功能。

注意事项

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

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

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

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

典型场景的推荐配置

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

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

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

设置旋转方向模式

旋转方向模式指移动端视频是横屏还是竖屏显示。采集端采集图像时，同时收集视频的旋转方向模式信息；播放端将接收到的视频图像进行渲染，并旋转方向模式信息对应地旋转视频，以达到和采集端表现一致。

NERTC SDK 支持根据 orientation_mode 参数设置本地视频编码的旋转方向模式，使接收端的视频展示为指定的方向效果。其中，orientation_mode 参数中提供了 kNERtcVideoOutputOrientationModeAdaptative（自适应）、kNERtcVideoOutputOrientationModeFixedLandscape（风景） 和 kNERtcVideoOutputOrientationModeFixedPortrait （肖像） 三种方向模式。

• kNERtcVideoOutputOrientationModeAdaptative

  自适应模式下，SDK 输出的视频方向与采集到的视频方向一致。接收端会根据收到的视频旋转信息对视频进行旋转。该模式适用于接收端可以自主调整视频方向的场景。

• kNERtcVideoOutputOrientationModeFixedLandscape

  该模式下 SDK 固定输出横屏模式的视频。如果采集到的视频是竖屏模式，则视频编码器会对其进行裁剪。该模式适用于当接收端无法调整视频方向时，例如旁路推流场景。

• kNERtcVideoOutputOrientationModeFixedPortrait

  该模式下 SDK 固定输出竖屏模式的视频，如果采集到的视频是横屏模式，则视频编码器会对其进行裁剪。该模式适用于当接收端无法调整视频方向时，例如旁路推流场景。

设置镜像模式

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

设置视频属性时默认关闭镜像模式，即 NERtcVideoMirrorMode 类型的默认值为 kNERtcVideoMirrorModeDisabled。

示例代码

//设置本地视频编码的镜像模式，即本地发送视频的镜像模式，只影响远端用户看到的视频画面。
nertc::NERtcVideoStreamType type = nertc::NERtcVideoStreamType::kNERTCVideoStreamMain;//以主流为例
nertc::NERtcVideoConfig config;
memset(&config, 0, sizeof(config));
nertc::NERtcVideoMirrorMode mirroeMode = kNERtcVideoMirrorModeEnabled;
config.mirror_mode = mirroeMode;
coreEngine->setVideoConfig(type, config);

//本地的视频镜像模式仅影响本地用户所见，不影响远端用户所见。 方法1
nertc::NERtcVideoCanvas canvas;
memset(&canvas, 0, sizeof(canvas));
canvas.window = window;
canvas.mirror_mode = kNERtcVideoMirrorModeEnabled;
coreEngine->setupLocalVideoCanvas(canvas);

//本地的视频镜像模式，仅影响本地用户所见，不影响远端用户所见。 方法2
nertc::NERtcVideoStreamType type = nertc::NERtcVideoStreamType::kNERTCVideoStreamMain;//以主流为例
nertc::NERtcVideoMirrorMode mirroeMode = kNERtcVideoMirrorModeEnabled;
coreEngine->setLocalVideoMirrorMode(mirrorMode);

//设置远端用户的视频镜像
nertc::NERtcVideoCanvas canvas;
memset(&canvas, 0, sizeof(canvas));
canvas.window = window;
canvas.mirror_mode = kNERtcVideoMirrorModeEnabled;
coreEngine->setupRemoteVideoCanvas(uid, canvas);

示例代码

C++//以设置主流为例
NERtcVideoStreamType kNERTCVideoStreamMain;
NERtcVideoConfig videoConfig;
videoConfig.max_profile = kNERtcVideoProfileHD1080P; // width & height不为0，该字段设置无效。
videoConfig.width = 900;
videoConfig.height = 600;
videoConfig.crop_mode_ = kNERtcVideoCropModeDefault;
videoConfig.framerate = 24; // 设置24帧采集
videoConfig.min_framerate = 15; // 设置最低15帧采集
videoConfig.bitrate = 0; 
videoConfig.min_bitrate = 0;
videoConfig.degradation_preference = kNERtcDegradationDefault; 
nrtc_engine_->setVideoConfig(type,videoConfig); //设置本地视频参数
nrtc_engine_->enableDualStreamMode(true); //设置是否支持小流

相关参考

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

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

常见问题

分辨率是越高越好吗？

分辨率不是越高越好，较高的分辨率需要有较高的码率来支撑。高分辨率、高码率会提供高质量的视频，但同时会增加对宽带的压力，可能导致视频卡顿。建议您根据实际场景选择对应的分辨率，具体请参考音视频参数配置推荐，如果需要自定义分辨率，请参考分辨率、帧率和码率参照表设置合理的值。