设置视频编码属性

功能介绍Copy Anchor Link

本文介绍如何调用声网提供的 API 设置视频编码属性。视频编码属性包含视频分辨率、帧率、码率等影响视频质量的参数设置。你可以通过设置视频编码属性，控制视频流在不同网络条件下的展示方式。

声网 SDK 提供了 setVideoEncoderConfiguration 方法，用于设置视频编码属性。你可以在 enableVideo 前调用该方法以加快首帧出图的时间；也可以在频道内调用该方法以灵活调整视频编码属性。

前提条件Copy Anchor Link

在进行操作之前，请确保你已经在项目中实现了基本的实时音视频功能。详见实现音视频互动。

实现方法Copy Anchor Link

你可以参考如下示例代码，在你的项目中设置各种视频编码参数：

// 根据用户在界面的选择设置视频编码的分辨率、帧率、码率与横竖屏方向模式
VideoEncoderConfiguration.VideoDimensions value = VD_640x360;
try {
    Field tmp = VideoEncoderConfiguration.class.getDeclaredField(dimension.getSelectedItem(toString());
    tmp.setAccessible(true);
    value = (VideoEncoderConfiguration.VideoDimensions) tmp.get(null);
} catch (NoSuchFieldException e) {
    Log.e("Field", "Can not find field " + dimension.getSelectedItem().toString());
} catch (IllegalAccessException e) {
    Log.e("Field", "Could not access field " + dimension.getSelectedItem().toString());
}

engine.setVideoEncoderConfiguration(new VideoEncoderConfiguration(
        value,
        VideoEncoderConfiguration.FRAME_RATE.valueOf(framerate.getSelectedItem().toString()),
        Integer.valueOf(et_bitrate.getText().toString()),
        VideoEncoderConfiguration.ORIENTATION_MODE.valueOf(orientation.getSelectedItem().toStri())
));

开发注意事项Copy Anchor Link

• setVideoEncoderConfiguration 中的各参数值是在理想网络状态下的最大值。声网 SDK 会根据实时网络环境和设备，对设置的参数作自适应调整，通常会下调参数。
• setVideoEncoderConfiguration 中的参数设置可能会影响计费。如果因自适应产生参数下调，计费按用户实际订阅的视频分辨率为准。详见计费说明。

参考信息Copy Anchor Link

示例项目Copy Anchor Link

声网提供了开源的实时音视频互动示例项目供你参考，你可以前往下载或查看其中的源代码。

API 参考Copy Anchor Link

• setVideoEncoderConfiguration
• onVideoSizeChanged

视频参数推荐值Copy Anchor Link

通常来讲，视频编码参数的选择要根据产品实际情况和场景来确定。比如，在一对一教学场景下，老师和学生的窗口比较大，要求分辨率会高一点，随之帧率和码率也要高一点； 如果是一对四场景， 老师和学生的窗口都比较小，分辨率可以低一点，对应的码率帧率也会低一点，以减少编解码的资源消耗和缓解下行带宽压力。

一般可按下列场景中的推荐值进行设置。

• 双人视频通话场景：
  • 分辨率 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

分辨率、帧率和码率Copy Anchor Link

视频编码属性的参数如下所示：

• dimensions：视频编码的分辨率 (px)。默认值为 960 × 540。通常情况下，分辨率越高，视频的清晰度会越好。该参数的值不代表最终视频输出的方向。点击旋转方向模式了解如何设置视频输出的方向模式。

• frameRate：视频编码的帧率 (fps)，即每秒钟要编码多少帧画面。默认值为 15。通常情况下，帧率越大，画面越流畅。在对视频流畅度要求较高的场景下，可以将此参数设置为 20 或 25。建议不要将 frameRate 设置为大于 30。

• bitrate：视频编码码率 (Kbps)。默认值为 STANDARD_BITRATE，即标准码率模式。在标准码率模式下，SDK 会根据已设置的频道场景、分辨率和帧率为你设置一个合适的码率。

• minBitrate：如果你对视频质量有特殊的需求，可以通过 minBitrate 参数进行设置。minBitrate 为视频最低编码码率 (Kbps)。声网 SDK 会根据网络条件进行码率自适应。将此参数设置为大于默认值时，会强制视频编码器输出高质量的视频图像，但可能会导致丢包率增高并影响视频播放的流畅度。

声网 SDK 提供了多种分辨率、帧率以供选择，你也可以根据下表自行定义。

视频模式Copy Anchor Link

视频模式包括多种设置，你可以根据业务需求调整视频的方向、画质和镜像效果。

旋转方向模式Copy Anchor Link

在视频旋转场景中，我们主要关注采集端和播放端的行为。其中：

• 采集端采集视频并输出视频。即视频和 Status Bar 的相对位置。
• 播放端渲染接收到的视频图像，并根据接收到的旋转信息，结合自身 Status Bar 的相对位置旋转视频。

为防止视频因旋转出现大头、缩放或剪切的问题，声网 SDK 在 setVideoEncoderConfiguration 中提供了 orientationMode 参数。你可以通过这个参数，结合视频场景需要，获取想要的视频渲染效果。

orientationMode 参数提供了三种模式以适应不同的用户需求：ORIENTATION_MODE_ADAPTIVE、ORIENTATION_MODE_FIXED_LANDSCAPE 和 ORIENTATION_MODE_FIXED_PORTRAIT。

无论采取哪种模式，声网 SDK 都保证视频和 Status Bar 的相对位置在采集端和播放端始终一致。

ORIENTATION_MODE_ADAPTIVE

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

当使用后置摄像头采集视频时，视频采集器和播放器的视频方向如下图所示。请注意，视频方向因 UI 是否锁定而异。

UI 锁定（或禁用 App 屏幕自动旋转）

Status Bar 与屏幕的相对方向保持一致，与手机重力感应无关（例如微信）。因此，视频和屏幕的相对位置在视频采集端和播放端始终一致。

• 采集端横屏时：

• 采集端竖屏时：

UI 不锁定（启用 App 屏幕自动旋转）

无论屏幕的方向如何（例如，在 Facetime 中），App 中的 Status Bar 始终在水平方向。因此，视频和重力的相对方向在采集端和播放端始终一致。

• 采集端横屏时：

• 采集端竖屏时：

ORIENTATION_MODE_FIXED_LANDSCAPE

在 ORIENTATION_MODE_FIXED_LANDSCAPE 模式下，输出的视频相对 Status Bar 总是处于横屏模式。如果采集到的视频是竖屏模式，则视频编码器会对其进行裁剪。该方式适用于接收端无法处理旋转信息的情况。

当使用后置摄像头作为视频采集器时，视频采集器和播放器的视频方向如下图所示。

• 横向模式下采集的视频（不需要视频裁剪）：

• 竖屏模式下采集的视频（需要视频裁剪）：

ORIENTATION_MODE_FIXED_PORTRAIT

在 ORIENTATION_MODE_FIXED_PORTRAIT 模式下，输出的视频相对 Status Bar 总是处于竖屏模式。如果采集到的视频是横屏模式，则视频编码器会对其进行裁剪。该方式适用于接收端无法处理旋转信息的情况。

当使用后置摄像头作为视频采集器时，视频采集器和播放器的视频方向如下图所示。

• 采集到的视频是竖屏模式（不需要视频裁剪）：

• 采集到的视频是横屏模式（需要视频裁剪）：

降级偏好Copy Anchor Link

为保证弱网下用户的视频体验，声网 SDK 还提供了 degradationPreference 参数，来设置带宽受限时视频编码的降级偏好。

镜像模式Copy Anchor Link

默认情况下，SDK 在编码时不对视频作镜像操作。你可以通过 mirrorMode 参数设置视频编码的镜像模式，从而决定远端用户看到的视频画面。

本文介绍如何调用声网提供的 API 设置视频编码属性。

功能介绍Copy Anchor Link

视频编码属性包含视频分辨率、帧率、码率等影响视频质量的参数设置。你可以通过设置视频编码属性，控制视频流在不同网络条件下的展示方式。

声网 SDK 提供了 setVideoEncoderConfiguration 方法，用于设置视频编码属性。你可以在 enableVideo 前调用该方法以加快首帧出图的时间；也可以在频道内调用该方法以灵活调整视频编码属性。

前提条件Copy Anchor Link

在进行操作之前，请确保你已经在项目中实现了基本的实时音视频功能。详见实现音视频互动。

实现方法Copy Anchor Link

你可以参考如下示例代码，在你的项目中设置各种视频编码参数：

// 根据用户在界面的选择设置视频编码的分辨率、帧率、码率与横竖屏方向模式
let resolution = configs["resolution"] as? CGSize,
let fps = configs["fps"] as? Int,
let orientation = config["orientation"] as? AgoraVideoOutputOrientationMode else {return}

agoraKit.setVideoEncoderConfiguration(AgoraVideoEncoderConfiguration(size: resolution,
                                                                     frameRate: AgoraVideoFrameRate(rawValue: fps) ?? .fps15,
                                                                     bitrate: AgoraVideoBitrateStandard,
                                                                     orientationMode: orientation))

开发注意事项Copy Anchor Link

• setVideoEncoderConfiguration 中的各参数值是在理想网络状态下的最大值。声网 SDK 会根据实时网络环境和设备，对设置的参数作自适应调整，通常会下调参数。
• setVideoEncoderConfiguration 中的参数设置可能会影响计费。如果因自适应产生参数下调，计费按用户实际订阅的视频分辨率为准。详见计费说明。

参考信息Copy Anchor Link

示例项目Copy Anchor Link

声网提供了开源的实时音视频互动示例项目供你参考，你可以前往下载或查看其中的源代码。

API 参考Copy Anchor Link

• setVideoEncoderConfiguration
• videoSizeChangedOfSourceType

视频参数推荐值Copy Anchor Link

通常来讲，视频编码参数的选择要根据产品实际情况和场景来确定。比如，在一对一教学场景下，老师和学生的窗口比较大，要求分辨率会高一点，随之帧率和码率也要高一点； 如果是一对四场景， 老师和学生的窗口都比较小，分辨率可以低一点，对应的码率帧率也会低一点，以减少编解码的资源消耗和缓解下行带宽压力。

一般可按下列场景中的推荐值进行设置。

• 双人视频通话场景：
  • 分辨率 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

分辨率、帧率和码率Copy Anchor Link

视频编码属性的参数如下所示：

• dimensions：视频编码的分辨率 (px)。默认值为 960 × 540。通常情况下，分辨率越高，视频的清晰度会越好。该参数的值不代表最终视频输出的方向。点击旋转方向模式了解如何设置视频输出的方向模式。

• frameRate：视频编码的帧率 (fps)，即每秒钟要编码多少帧画面。默认值为 15。通常情况下，帧率越大，画面越流畅。在对视频流畅度要求较高的场景下，可以将此参数设置为 20 或 25。建议不要将 frameRate 设置为大于 30。

• bitrate：视频编码码率 (Kbps)。默认值为 AgoraVideoBitrateStandard，即标准码率模式。在标准码率模式下，SDK 会根据已设置的频道场景、分辨率和帧率为你设置一个合适的码率。

• minBitrate：如果你对视频质量有特殊的需求，可以通过 minBitrate 参数进行设置。minBitrate 为视频最低编码码率 (Kbps)。声网 SDK 会根据网络条件进行码率自适应。将此参数设置为大于默认值时，会强制视频编码器输出高质量的视频图像，但可能会导致丢包率增高并影响视频播放的流畅度。

声网 SDK 提供了多种分辨率、帧率以供选择，你也可以根据下表自行定义。

视频模式Copy Anchor Link

视频模式包括多种设置，你可以根据业务需求调整视频的方向、画质和镜像效果。

旋转方向模式Copy Anchor Link

在视频旋转场景中，我们主要关注采集端和播放端的行为。其中：

• 采集端采集视频并输出视频。即视频和 Status Bar 的相对位置。
• 播放端渲染接收到的视频图像，并根据接收到的旋转信息，结合自身 Status Bar 的相对位置旋转视频。

为防止视频因旋转出现大头、缩放或剪切的问题，声网 SDK 在 setVideoEncoderConfiguration 中提供了 orientationMode 参数。你可以通过这个参数，结合视频场景需要，获取想要的视频渲染效果。

orientationMode 参数提供了三种模式以适应不同的用户需求：Adaptive, FixedLandscape, 和 FixedPortrait。

无论采取哪种模式，声网 SDK 都保证视频和 Status Bar 的相对位置在采集端和播放端始终一致。

Adaptive

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

当使用后置摄像头采集视频时，视频采集器和播放器的视频方向如下图所示。请注意，视频方向因 UI 是否锁定而异。

UI 已锁定（或禁用 App 屏幕自动旋转）

Status Bar 与屏幕的相对方向保持一致，与手机重力感应无关（例如微信）。因此，视频和屏幕的相对位置在视频采集端和播放端始终一致。

• 采集端横屏时：

• 采集端竖屏时：

UI 不锁定（启用 App 屏幕自动旋转）

无论屏幕的方向如何（例如，在 Facetime 中），App 中的 Status Bar 始终在水平方向。因此，视频和重力的相对方向在采集端和播放端始终一致。

• 采集端横屏时：

• 采集端竖屏时：

FixedLandscape

在 FixedLandscape 模式下，输出的视频相对 Status Bar 总是处于横屏模式。如果采集到的视频是竖屏模式，则视频编码器会对其进行裁剪。该方式适用于接收端无法处理旋转信息的情况。

当使用后置摄像头作为视频采集器时，视频采集器和播放器的视频方向如下图所示。

• 横向模式下采集的视频（不需要视频裁剪）：

• 竖屏模式下采集的视频（需要视频裁剪）：

FixedPortrait

在 FixedPortrait 模式下，输出的视频相对 Status Bar 总是处于竖屏模式。如果采集到的视频是横屏模式，则视频编码器会对其进行裁剪。该方式适用于接收端无法处理旋转信息的情况。

当使用后置摄像头作为视频采集器时，视频采集器和播放器的视频方向如下图所示。

• 采集到的视频是竖屏模式（不需要视频裁剪）：

• 采集到的视频是横屏模式（需要视频裁剪）：

降级偏好Copy Anchor Link

为保证弱网下用户的视频体验，声网 SDK 还提供了 degradationPreference 参数，来设置带宽受限时视频编码的降级偏好。

镜像模式Copy Anchor Link

默认情况下，SDK 在编码时不对视频作镜像操作。你可以通过 mirrorMode 参数设置视频编码的镜像模式，从而决定远端用户看到的视频画面。

本文介绍如何调用声网提供的 API 设置视频编码属性。

功能介绍Copy Anchor Link

视频编码属性包含视频分辨率、帧率、码率等影响视频质量的参数设置。你可以通过设置视频编码属性，控制视频流在不同网络条件下的展示方式。

声网 SDK 提供了 setVideoEncoderConfiguration 方法，用于设置视频编码属性。你可以在 enableVideo 前调用该方法以加快首帧出图的时间；也可以在频道内调用该方法以灵活调整视频编码属性。

前提条件Copy Anchor Link

在进行操作之前，请确保你已经在项目中实现了基本的实时音视频功能。详见实现音视频互动。

实现方法Copy Anchor Link

你可以参考如下示例代码，在你的项目中设置各种视频编码参数：

// 根据用户在界面的选择设置视频编码的分辨率、帧率、码率与横竖屏方向模式
let resolution = configs["resolution"] as? CGSize,
let fps = configs["fps"] as? Int,
let orientation = config["orientation"] as? AgoraVideoOutputOrientationMode else {return}

agoraKit.setVideoEncoderConfiguration(AgoraVideoEncoderConfiguration(size: resolution,
                                                                     frameRate: AgoraVideoFrameRate(rawValue: fps) ?? .fps15,
                                                                     bitrate: AgoraVideoBitrateStandard,
                                                                     orientationMode: orientation))

开发注意事项Copy Anchor Link

• setVideoEncoderConfiguration 中的各参数值是在理想网络状态下的最大值。声网 SDK 会根据实时网络环境和设备，对设置的参数作自适应调整，通常会下调参数。
• setVideoEncoderConfiguration 中的参数设置可能会影响计费。如果因自适应产生参数下调，计费按用户实际订阅的视频分辨率为准。详见计费说明。

参考信息Copy Anchor Link

示例项目Copy Anchor Link

声网提供了开源的实时音视频互动示例项目供你参考，你可以前往下载或查看其中的源代码。

API 参考Copy Anchor Link

• setVideoEncoderConfiguration
• videoSizeChangedOfSourceType

视频参数推荐值Copy Anchor Link

通常来讲，视频编码参数的选择要根据产品实际情况和场景来确定。比如，在一对一教学场景下，老师和学生的窗口比较大，要求分辨率会高一点，随之帧率和码率也要高一点； 如果是一对四场景， 老师和学生的窗口都比较小，分辨率可以低一点，对应的码率帧率也会低一点，以减少编解码的资源消耗和缓解下行带宽压力。

一般可按下列场景中的推荐值进行设置。

• 双人视频通话场景：
  • 分辨率 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

分辨率、帧率和码率Copy Anchor Link

视频编码属性的参数如下所示：

• dimensions：视频编码的分辨率 (px)。默认值为 960 × 540。通常情况下，分辨率越高，视频的清晰度会越好。该参数的值不代表最终视频输出的方向。点击旋转方向模式了解如何设置视频输出的方向模式。

• frameRate：视频编码的帧率 (fps)，即每秒钟要编码多少帧画面。默认值为 15。通常情况下，帧率越大，画面越流畅。在对视频流畅度要求较高的场景下，可以将此参数设置为 20 或 25。建议不要将 frameRate 设置为大于 30。

• bitrate：视频编码码率 (Kbps)。默认值为 AgoraVideoBitrateStandard，即标准码率模式。在标准码率模式下，SDK 会根据已设置的频道场景、分辨率和帧率为你设置一个合适的码率。

• minBitrate：如果你对视频质量有特殊的需求，可以通过 minBitrate 参数进行设置。minBitrate 为视频最低编码码率 (Kbps)。声网 SDK 会根据网络条件进行码率自适应。将此参数设置为大于默认值时，会强制视频编码器输出高质量的视频图像，但可能会导致丢包率增高并影响视频播放的流畅度。

声网 SDK 提供了多种分辨率、帧率以供选择，你也可以根据下表自行定义。

视频模式Copy Anchor Link

视频模式包括多种设置，你可以根据业务需求调整视频的方向、画质和镜像效果。

旋转方向模式Copy Anchor Link

在视频旋转场景中，我们主要关注采集端和播放端的行为。其中：

• 采集端采集视频并输出视频。即视频和 Status Bar 的相对位置。
• 播放端渲染接收到的视频图像，并根据接收到的旋转信息，结合自身 Status Bar 的相对位置旋转视频。

为防止视频因旋转出现大头、缩放或剪切的问题，声网 SDK 在 setVideoEncoderConfiguration 中提供了 orientationMode 参数。你可以通过这个参数，结合视频场景需要，获取想要的视频渲染效果。

orientationMode 参数提供了三种模式以适应不同的用户需求：Adaptive, FixedLandscape, 和 FixedPortrait。

无论采取哪种模式，声网 SDK 都保证视频和 Status Bar 的相对位置在采集端和播放端始终一致。

Adaptive

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

FixedLandscape

在 FixedLandscape 模式下，输出的视频相对 Status Bar 总是处于横屏模式。如果采集到的视频是竖屏模式，则视频编码器会对其进行裁剪。该方式适用于接收端无法处理旋转信息的情况。

当使用后置摄像头作为视频采集器时，视频采集器和播放器的视频方向如下图所示。

• 横向模式下采集的视频（不需要视频裁剪）：

• 竖屏模式下采集的视频（需要视频裁剪）：

FixedPortrait

在 FixedPortrait 模式下，输出的视频相对 Status Bar 总是处于竖屏模式。如果采集到的视频是横屏模式，则视频编码器会对其进行裁剪。该方式适用于接收端无法处理旋转信息的情况。

当使用后置摄像头作为视频采集器时，视频采集器和播放器的视频方向如下图所示。

• 采集到的视频是竖屏模式（不需要视频裁剪）：

• 采集到的视频是横屏模式（需要视频裁剪）：

降级偏好Copy Anchor Link

为保证弱网下用户的视频体验，声网 SDK 还提供了 degradationPreference 参数，来设置带宽受限时视频编码的降级偏好。

镜像模式Copy Anchor Link

默认情况下，SDK 在编码时不对视频作镜像操作。你可以通过 mirrorMode 参数设置视频编码的镜像模式，从而决定远端用户看到的视频画面。

你可以根据终端用户的设备、浏览器、网络状况和实际应用场景设置视频属性，调整视频的清晰度和流畅度，从而获得较高的用户体验。

点击在线体验试用设置视频属性功能。

前提条件Copy Anchor Link

开始前，请确保你已参考快速开始在你的项目中实现基本的实时音视频功能。

实现方法Copy Anchor Link

声网 Web SDK 提供两种方式设置视频属性：

• 在创建视频轨道时设置：
  • 调用 AgoraRTC.createCameraVideoTrack 创建摄像头视频轨道时，通过修改 encoderConfig 参数设置使用 SDK 预设值或者自定义配置。
  • 调用 AgoraRTC.createScreenVideoTrack 创建屏幕共享视频轨道时，通过修改 encoderConfig 参数设置使用 SDK 预设值或者自定义配置。
  • 调用 AgoraRTC.createCustomVideoTrack 创建自定义视频轨道时，通过修改 bitrateMax、bitrateMin 参数设置码率。自 v4.17.1 起，还可以通过 width、height、frameRate 参数设置分辨率和帧率。
• 创建视频轨道后动态调整（发布前和发布后都支持）：
  • 摄像头视频轨道可以调用 CameraVideoTrack.setEncoderConfiguration 动态调整视频属性。
  • 自 v4.17.1 起，屏幕共享视频轨道和自定义视频轨道也可以调用 LocalVideoTrack.setEncoderConfiguration 动态调整视频属性。

以摄像头视频轨道为例：

创建时使用预设视频编码属性

AgoraRTC.createCameraVideoTrack({
  encoderConfig: "720p_1",
}).then(localVideoTrack => { /** ... **/ });

SDK 支持的预设视频属性可参考下方的分辨率和浏览器对照表。SDK 默认的视频属性为 "480p_1"。

创建时自定义视频编码属性

AgoraRTC.createCameraVideoTrack({
  encoderConfig: {
    width: 640,
    // 支持指定一个范围和参考值，具体配置参考相关 API 文档
    height: { ideal: 480, min: 400, max: 500 },
    frameRate: 15,
    bitrateMin: 600, bitrateMax: 1000,
  },
}).then(localVideoTrack => {/** ... **/ });

创建后通过预设值动态调整视频编码属性

CameraVideoTrack.setEncoderConfiguration("480p_1").then(() => { /** ... **/ })

创建后动态调整自定义视频编码属性

CameraVideoTrack.setEncoderConfiguration({ width: 1280, height: 720 }).then(() => { /** ... **/ })

参考信息Copy Anchor Link

开发注意事项Copy Anchor Link

• 不同的浏览器对分辨率的支持可能不同，具体的支持情况详见分辨率和浏览器对照表。
• 由于部分浏览器的限制，用户通过 SDK 设置的分辨率有一定概率与实际采集的分辨率不符。当浏览器不支持用户设置的分辨率时，计量计费会以实际采集的分辨率为准，实际采集的分辨率有可能大于或者小于设置的分辨率。
• 视频能否达到 1080p 以上的分辨率取决于设备的性能，在性能配备较低的设备上有可能无法实现。如果采用 720p 分辨率而设备性能跟不上，则有可能出现帧率过低的情况。
• Safari 浏览器视频帧率为 30 fps，不支持自定义视频帧率。
• 动态修改视频属性仅支持 Chrome 63 及以上版本和 Safari 11 及以上版本。在部分 iOS 设备上动态修改视频属性可能会导致视频出现黑边。

API 参考Copy Anchor Link

• AgoraRTC.createCameraVideoTrack
• AgoraRTC.createScreenVideoTrack
• AgoraRTC.createCustomVideoTrack
• LocalVideoTrack.setEncoderConfiguration

常用分辨率、帧率和码率Copy Anchor Link

通常来讲，视频属性的选择要根据产品实际情况来确定，比如，如果是一对一场景，老师和学生的窗口比较大，要求分辨率会高一点，随之帧率和码率也要高一点；如果是一对四场景，老师和学生的窗口都比较小，分辨率可以低一点，对应的码率帧率也会低一点，以减少编解码的资源消耗和缓解下行带宽压力。

一般可按以下场景推荐值进行设置。

• 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

分辨率和浏览器对照表Copy Anchor Link

下表列出了 SDK 预设的视频属性配置，以及在各浏览器上的支持情况。你可以参考下表进行自定义设置。

本文介绍如何调用声网提供的 API 设置视频编码属性。

功能介绍Copy Anchor Link

视频编码属性包含视频分辨率、帧率、码率等影响视频质量的参数设置。你可以通过设置视频编码属性，控制视频流在不同网络条件下的展示方式。

声网 SDK 提供了 setVideoEncoderConfiguration 方法设置视频编码属性。你可以在 enableVideo 前调用该方法以加快首帧出图的时间；也可以在频道内调用该方法以灵活调整视频编码属性。

前提条件Copy Anchor Link

在进行操作之前，请确保你已经在项目中实现了基本的实时音视频功能。详见实现音视频互动。

实现方法Copy Anchor Link

你可以参考如下示例代码，在你的项目中设置各种视频编码参数：

// 创建视频编码配置对象
VideoEncoderConfiguration videoConfig;
// 设置视频宽度
videoConfig.dimensions.width = 1280;
// 设置视频高度
videoConfig.dimensions.height = 720;
 // 设置帧率为15 fps
videoConfig.frameRate = FRAME_RATE_FPS_15;
// 设置码率为800 Kbps
videoConfig.bitrate = 800 * 1000;
// 设置旋转方向模式为 ADAPTIVE
videoConfig.orientationMode = ORIENTATION_MODE_ADAPTIVE;
 // 设置降级偏好为 MAINTAIN_QUALITY
videoConfig.degradationPreference = MAINTAIN_QUALITY;

// 应用视频编码配置
rtcEngine->setVideoEncoderConfiguration(videoConfig);

开发注意事项Copy Anchor Link

• setVideoEncoderConfiguration 中的各参数值是在理想网络状态下的最大值。声网 SDK 会根据实时网络环境和设备，对设置的参数作自适应调整，通常会下调参数。
• setVideoEncoderConfiguration 中的参数设置可能会影响计费。如果因自适应产生参数下调，计费按用户实际订阅的视频分辨率为准。详见计费说明。

参考信息Copy Anchor Link

示例项目Copy Anchor Link

声网提供了开源的示例项目供你参考，你可以前往下载或查看其中的源代码。

API 参考Copy Anchor Link

• setVideoEncoderConfiguration
• onVideoSizeChanged

视频参数推荐值Copy Anchor Link

通常来讲，视频编码参数的选择要根据产品实际情况和场景来确定。比如，在一对一教学场景下，老师和学生的窗口比较大，要求分辨率会高一点，随之帧率和码率也要高一点；如果是一对四场景，老师和学生的窗口都比较小，分辨率可以低一点，对应的码率帧率也会低一点，以减少编解码的资源消耗和缓解下行带宽压力。

一般可按下列场景中的推荐值进行设置。

• 双人视频通话场景：
  • 分辨率 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

分辨率、帧率和码率Copy Anchor Link

视频编码属性的参数如下所示：

• dimensions：视频编码的分辨率 (px)。默认值为 960 × 540。通常情况下，分辨率越高，视频的清晰度会越好。该参数的值不代表最终视频输出的方向。点击旋转方向模式了解如何设置视频输出的方向模式。

• frameRate：视频编码的帧率 (fps)，即每秒钟要编码多少帧画面。默认值为 15。通常情况下，帧率越大，画面越流畅。在对视频流畅度要求较高的场景下，可以将此参数设置为 20 或 25。建议不要将 frameRate 设置为大于 30。

• bitrate：视频编码码率 (Kbps)。默认值为 STANDARD_BITRATE，即标准码率模式。在标准码率模式下，SDK 会根据已设置的频道场景、分辨率和帧率为你设置一个合适的码率。

• minBitrate：如果你对视频质量有特殊的需求，可以通过 minBitrate 参数进行设置。minBitrate 为视频最低编码码率 (Kbps)。声网 SDK 会根据网络条件进行码率自适应。将此参数设置为大于默认值时，会强制视频编码器输出高质量的视频图像，但可能会导致丢包率增高并影响视频播放的流畅度。

声网 SDK 提供了多种分辨率、帧率以供选择，你也可以根据下表自行定义。

视频模式Copy Anchor Link

视频模式包括多种设置，你可以根据业务需求调整视频的方向、画质和镜像效果。

旋转方向模式Copy Anchor Link

在视频旋转场景中，我们主要关注采集端和播放端的行为。其中：

• 采集端采集视频并输出视频。即视频和 Status Bar 的相对位置。
• 播放端渲染接收到的视频图像，并根据接收到的旋转信息，结合自身 Status Bar 的相对位置旋转视频。

为防止视频因旋转出现大头、缩放或剪切的问题，声网 SDK 在 setVideoEncoderConfiguration 中提供了 orientationMode 参数。你可以通过这个参数，结合视频场景需要，获取想要的视频渲染效果。

orientationMode 参数提供了三种模式以适应不同的用户需求：ORIENTATION_MODE_ADAPTIVE、ORIENTATION_MODE_FIXED_LANDSCAPE 和 ORIENTATION_MODE_FIXED_PORTRAIT。

无论采取哪种模式，声网 SDK 都保证视频和 Status Bar 的相对位置在采集端和播放端始终一致。

ORIENTATION_MODE_ADAPTIVE

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

• 如果采集的视频是横屏模式，则输出的视频也是横屏模式。

• 如果采集的视频是竖屏模式，则输出的视频也是竖屏模式。

ORIENTATION_MODE_FIXED_LANDSCAPE

在 ORIENTATION_MODE_FIXED_LANDSCAPE 模式下，输出的视频相对 Status Bar 总是处于横屏模式。如果采集到的视频是竖屏模式，则视频编码器会对其进行裁剪。该方式适用于接收端无法处理旋转信息的情况。

ORIENTATION_MODE_FIXED_PORTRAIT

在 ORIENTATION_MODE_FIXED_PORTRAIT 模式下，输出的视频相对 Status Bar 总是处于竖屏模式。如果采集到的视频是横屏模式，则视频编码器会对其进行裁剪。该方式适用于接收端无法处理旋转信息的情况。

降级偏好Copy Anchor Link

为保证弱网下用户的视频体验，声网 SDK 还提供了 degradationPreference 参数，来设置带宽受限时视频编码的降级偏好。

镜像模式Copy Anchor Link

默认情况下，SDK 在编码时不对视频作镜像操作。你可以通过 mirrorMode 参数设置视频编码的镜像模式，从而决定远端用户看到的视频画面。

本文介绍如何调用声网提供的 API 设置视频编码属性。

功能介绍Copy Anchor Link

视频编码属性包含视频分辨率、帧率、码率等影响视频质量的参数设置。你可以通过设置视频编码属性，控制视频流在不同网络条件下的展示方式。

声网 SDK 提供了 setVideoEncoderConfiguration 方法，用于设置视频编码属性。你可以在 enableVideo 前调用该方法以加快首帧出图的时间；也可以在频道内调用该方法以灵活调整视频编码属性。

前提条件Copy Anchor Link

在进行操作之前，请确保你已经在项目中实现了基本的实时音视频功能。详见实现音视频互动。

实现方法Copy Anchor Link

你可以参考如下示例代码，在你的项目中设置各种视频编码参数：

let encoderConfig = new VideoEncoderConfiguration()
encoderConfig.dimensions = new VideoDimensions(960, 540)
encoderConfig.frameRate = 15
encoderConfig.orientationMode = OrientationMode.ORIENTATION_MODE_ADAPTIVE
this.rtcEngine.setVideoEncoderConfiguration(encoderConfig)
this.rtcEngine.enableVideo()

开发注意事项Copy Anchor Link

• setVideoEncoderConfiguration 中的各参数值是在理想网络状态下的最大值。声网 SDK 会根据实时网络环境和设备，对设置的参数作自适应调整，通常会下调参数。
• setVideoEncoderConfiguration 中的参数设置可能会影响计费。如果因自适应产生参数下调，计费按用户实际订阅的视频分辨率为准。详见计费说明。

参考信息Copy Anchor Link

示例项目Copy Anchor Link

声网提供了开源的示例项目供你参考，你可以前往下载或查看其中的源代码。

API 参考Copy Anchor Link

• setVideoEncoderConfiguration
• onVideoSizeChanged

视频参数推荐值Copy Anchor Link

通常来讲，视频编码参数的选择要根据产品实际情况和场景来确定。比如，在一对一教学场景下，老师和学生的窗口比较大，要求分辨率会高一点，随之帧率和码率也要高一点； 如果是一对四场景， 老师和学生的窗口都比较小，分辨率可以低一点，对应的码率帧率也会低一点，以减少编解码的资源消耗和缓解下行带宽压力。

一般可按下列场景中的推荐值进行设置。

• 双人视频通话场景：
  • 分辨率 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

分辨率、帧率和码率Copy Anchor Link

视频编码属性的参数如下所示：

• dimensions：视频编码的分辨率 (px)。默认值为 960 × 540。通常情况下，分辨率越高，视频的清晰度会越好。该参数的值不代表最终视频输出的方向。点击旋转方向模式了解如何设置视频输出的方向模式。

• frameRate：视频编码的帧率 (fps)，即每秒钟要编码多少帧画面。默认值为 15。通常情况下，帧率越大，画面越流畅。在对视频流畅度要求较高的场景下，可以将此参数设置为 20 或 25。建议不要将 frameRate 设置为大于 30。

• minBitrate：如果你对视频质量有特殊的需求，可以通过 minBitrate 参数进行设置。minBitrate 为视频最低编码码率 (Kbps)。声网 SDK 会根据网络条件进行码率自适应。将此参数设置为大于默认值时，会强制视频编码器输出高质量的视频图像，但可能会导致丢包率增高并影响视频播放的流畅度。

声网 SDK 提供了多种分辨率、帧率以供选择，你也可以根据下表自行定义。

视频模式Copy Anchor Link

视频模式包括多种设置，你可以根据业务需求调整视频的方向、画质和镜像效果。

旋转方向模式Copy Anchor Link

在视频旋转场景中，我们主要关注采集端和播放端的行为。其中：

• 采集端采集视频并输出视频。即视频和 Status Bar 的相对位置。
• 播放端渲染接收到的视频图像，并根据接收到的旋转信息，结合自身 Status Bar 的相对位置旋转视频。

为防止视频因旋转出现大头、缩放或剪切的问题，声网 SDK 在 setVideoEncoderConfiguration 中提供了 orientationMode 参数。你可以通过这个参数，结合视频场景需要，获取想要的视频渲染效果。

orientationMode 参数提供了三种模式以适应不同的用户需求：ORIENTATION_MODE_ADAPTIVE、ORIENTATION_MODE_FIXED_LANDSCAPE 和 ORIENTATION_MODE_FIXED_PORTRAIT。

无论采取哪种模式，声网 SDK 都保证视频和 Status Bar 的相对位置在采集端和播放端始终一致。

ORIENTATION_MODE_ADAPTIVE

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

当使用后置摄像头采集视频时，视频采集器和播放器的视频方向如下图所示。请注意，视频方向因 UI 是否锁定而异。

UI 锁定（或禁用 App 屏幕自动旋转）

Status Bar 与屏幕的相对方向保持一致，与手机重力感应无关（例如微信）。因此，视频和屏幕的相对位置在视频采集端和播放端始终一致。

• 采集端横屏时：

• 采集端竖屏时：

UI 不锁定（启用 App 屏幕自动旋转）

无论屏幕的方向如何（例如，在 Facetime 中），App 中的 Status Bar 始终在水平方向。因此，视频和重力的相对方向在采集端和播放端始终一致。

• 采集端横屏时：

• 采集端竖屏时：

ORIENTATION_MODE_FIXED_LANDSCAPE

在 ORIENTATION_MODE_FIXED_LANDSCAPE 模式下，输出的视频相对 Status Bar 总是处于横屏模式。如果采集到的视频是竖屏模式，则视频编码器会对其进行裁剪。该方式适用于接收端无法处理旋转信息的情况。

当使用后置摄像头作为视频采集器时，视频采集器和播放器的视频方向如下图所示。

• 横向模式下采集的视频（不需要视频裁剪）：

• 竖屏模式下采集的视频（需要视频裁剪）：

ORIENTATION_MODE_FIXED_PORTRAIT

在 ORIENTATION_MODE_FIXED_PORTRAIT 模式下，输出的视频相对 Status Bar 总是处于竖屏模式。如果采集到的视频是横屏模式，则视频编码器会对其进行裁剪。该方式适用于接收端无法处理旋转信息的情况。

当使用后置摄像头作为视频采集器时，视频采集器和播放器的视频方向如下图所示。

• 采集到的视频是竖屏模式（不需要视频裁剪）：

• 采集到的视频是横屏模式（需要视频裁剪）：

降级偏好Copy Anchor Link

为保证弱网下用户的视频体验，声网 SDK 还提供了 degradationPreference 参数，来设置带宽受限时视频编码的降级偏好。

镜像模式Copy Anchor Link

默认情况下，SDK 在编码时不对视频作镜像操作。你可以通过 mirrorMode 参数设置视频编码的镜像模式，从而决定远端用户看到的视频画面。

本文介绍如何调用声网提供的 API 设置视频编码属性。

功能介绍Copy Anchor Link

视频编码属性包含视频分辨率、帧率、码率等影响视频质量的参数设置。你可以通过设置视频编码属性，控制视频流在不同网络条件下的展示方式。

声网 SDK 提供了 setVideoEncoderConfiguration 方法，用于设置视频编码属性。你可以在 enableVideo 前调用该方法以加快首帧出图的时间；也可以在频道内调用该方法以灵活调整视频编码属性。

前提条件Copy Anchor Link

在进行操作之前，请确保你已经在项目中实现了基本的实时音视频功能。详见实现音视频互动。

实现方法Copy Anchor Link

你可以参考如下示例代码，在你的项目中设置各种视频编码参数：

// 视频编码参数配置
this.engine?.setVideoEncoderConfiguration({
  // 设置视频编码类型为 H264
  codecType: VideoCodecType.VideoCodecH264,
  // 设置视频编码的分辨率为 640 x 360 (px) 
  dimensions: {
    width: 640,
    height: 360,
  },
  // 设置帧率为 15 fps
  frameRate: 15,
  // 设置码率模式为 StandardBitrate
  bitrate: 0,
  // 设置最低编码码率为 1 Kbps
  minBitrate: -1,
  // 设置旋转方向模式为 Adaptive
  orientationMode: OrientationMode.OrientationModeAdaptive,
  // 设置降级偏好为 MaintainQuality
  degradationPreference: DegradationPreference.MaintainQuality,
  // 禁用发送编码视频时的镜像模式
  mirrorMode: VideoMirrorModeType.VideoMirrorModeDisabled,
});

开发注意事项Copy Anchor Link

• setVideoEncoderConfiguration 中的各参数值是在理想网络状态下的最大值。声网 SDK 会根据实时网络环境和设备，对设置的参数作自适应调整，通常会下调参数。
• setVideoEncoderConfiguration 中的参数设置可能会影响计费。如果因自适应产生参数下调，计费按用户实际订阅的视频分辨率为准。详见计费说明。

参考信息Copy Anchor Link

API 参考Copy Anchor Link

• setVideoEncoderConfiguration

视频参数推荐值Copy Anchor Link

通常来讲，视频编码参数的选择要根据产品实际情况和场景来确定。比如，在一对一教学场景下，老师和学生的窗口比较大，要求分辨率会高一点，随之帧率和码率也要高一点； 如果是一对四场景， 老师和学生的窗口都比较小，分辨率可以低一点，对应的码率帧率也会低一点，以减少编解码的资源消耗和缓解下行带宽压力。

一般可按下列场景中的推荐值进行设置。

• 双人视频通话场景：
  • 分辨率 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

分辨率、帧率和码率Copy Anchor Link

视频编码属性的参数如下所示：

• dimensions：视频编码的分辨率 (px)。默认值为 960 × 540。通常情况下，分辨率越高，视频的清晰度会越好。该参数的值不代表最终视频输出的方向。点击旋转方向模式了解如何设置视频输出的方向模式。

• frameRate：视频编码的帧率 (fps)，即每秒钟要编码多少帧画面。默认值为 15。通常情况下，帧率越大，画面越流畅。在对视频流畅度要求较高的场景下，可以将此参数设置为 20 或 25。建议不要将 frameRate 设置为大于 30。

• bitrate：视频编码码率 (Kbps)。默认值为 STANDARD_BITRATE，即标准码率模式。在标准码率模式下，SDK 会根据已设置的频道场景、分辨率和帧率为你设置一个合适的码率。

• minBitrate：如果你对视频质量有特殊的需求，可以通过 minBitrate 参数进行设置。minBitrate 为视频最低编码码率 (Kbps)。声网 SDK 会根据网络条件进行码率自适应。将此参数设置为大于默认值时，会强制视频编码器输出高质量的视频图像，但可能会导致丢包率增高并影响视频播放的流畅度。

声网 SDK 提供了多种分辨率、帧率以供选择，你也可以根据下表自行定义。

视频模式Copy Anchor Link

旋转方向模式Copy Anchor Link

在视频旋转场景中，我们主要关注采集端和播放端的行为。其中：

• 采集端采集视频并输出视频。即视频和 Status Bar 的相对位置。
• 播放端渲染接收到的视频图像，并根据接收到的旋转信息，结合自身 Status Bar 的相对位置旋转视频。

为防止视频因旋转出现大头、缩放或剪切的问题，声网 SDK 在 setVideoEncoderConfiguration 中提供了 orientationMode 参数。你可以通过这个参数，结合视频场景需要，获取想要的视频渲染效果。

orientationMode 参数提供了三种模式以适应不同的用户需求：OrientationModeAdaptive、OrientationModeFixedLandscape 和 OrientationModeFixedPortrait。 无论采取哪种模式，声网 SDK 都保证视频和 Status Bar 的相对位置在采集端和播放端始终一致。

OrientationModeAdaptive

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

• 如果采集的视频是横屏模式，则输出的视频也是横屏模式。

• 如果采集的视频是竖屏模式，则输出的视频也是竖屏模式。

OrientationModeFixedLandscape

在 OrientationModeFixedLandscape 模式下，输出的视频相对 Status Bar 总是处于横屏模式。如果采集到的视频是竖屏模式，则视频编码器会对其进行裁剪。该方式适用于接收端无法处理旋转信息的情况。

OrientationFixedPortrait

在 OrientationFixedPortrait 模式下，输出的视频相对 Status Bar 总是处于竖屏模式。如果采集到的视频是横屏模式，则视频编码器会对其进行裁剪。该方式适用于接收端无法处理旋转信息的情况。

降级偏好Copy Anchor Link

为保证弱网下用户的视频体验，声网 SDK 还提供了 degradationPreference 参数，来设置带宽受限时视频编码的降级偏好。

镜像模式Copy Anchor Link

默认情况下，SDK 在编码时不对视频作镜像操作。你可以通过 mirrorMode 参数设置视频编码的镜像模式，从而决定远端用户看到的视频画面。

本文介绍如何调用声网提供的 API 设置视频编码属性。

功能介绍Copy Anchor Link

在视频通话或视频互动直播场景下，视频画面是否清晰流畅，很大程度上决定了用户体验。

视频编码属性包含视频分辨率、帧率、码率等影响视频质量的参数设置。你可以通过设置视频编码属性，控制视频流在不同网络条件下的展示方式。

声网 SDK 提供了 SetVideoEncoderConfiguration 方法设置视频编码属性。此方法可以在初始化 IRtcEngine 后的任何阶段（加入频道之前或之后）调用。

如果在加入频道后不需要重新设置视频编码属性，声网建议在 EnableVideo 前调用 SetVideoEncoderConfiguration，以加快首帧出图的时间。

前提条件Copy Anchor Link

在进行操作之前，请确保你已经在项目中实现了基本的实时音视频功能。详见实现音视频互动。

实现方法Copy Anchor Link

你可以参考如下示例代码，在你的项目中设置各种视频编码参数：

// 视频编码参数配置
VideoEncoderConfiguration config = new VideoEncoderConfiguration
{
    // 设置视频编码的分辨率 (px)
    dimensions = _dimensions[dim],
    // 设置帧率为 15 fps
    frameRate = 15,
    // 设置码率模式为 STANDARD_BITRATE
    bitrate = 0,
    // 设置最低编码码率为 1 Kbps
    minBitrate = 1,
    // 设置旋转方向模式为 ADAPTIVE
    orientationMode = ORIENTATION_MODE.ORIENTATION_MODE_ADAPTIVE,
    // 设置降级偏好为 MAINTAIN_FRAMERATE
    degradationPreference = DEGRADATION_PREFERENCE.MAINTAIN_FRAMERATE,
    // 设置发送编码视频时的镜像模式为 AUTO
    mirrorMode = VIDEO_MIRROR_MODE_TYPE.VIDEO_MIRROR_MODE_AUTO
};

// 设置视频编码属性
RtcEngine.SetVideoEncoderConfiguration(config);

参考信息Copy Anchor Link

开发注意事项Copy Anchor Link

• SetVideoEncoderConfiguration 中的各参数值是在理想网络状态下的最大值。声网 SDK 会根据实时网络环境和设备，对设置的参数作自适应调整，通常会下调参数。
• SetVideoEncoderConfiguration 中的参数设置可能会影响计费。如果因自适应产生参数下调，计费按用户实际订阅的视频分辨率为准。详见计费说明。

示例项目Copy Anchor Link

声网提供了开源的示例项目供你参考，你可以前往下载或查看其中的源代码。

视频参数推荐值Copy Anchor Link

通常来讲，视频编码参数的选择要根据产品实际情况和场景来确定。比如，在一对一教学场景下，老师和学生的窗口比较大，要求分辨率会高一点，随之帧率和码率也要高一点；如果是一对四场景，老师和学生的窗口都比较小，分辨率可以低一点，对应的码率帧率也会低一点，以减少编解码的资源消耗和缓解下行带宽压力。

一般可按下列场景中的推荐值进行设置。

• 双人视频通话场景：
  • 分辨率 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

分辨率、帧率和码率Copy Anchor Link

视频编码属性的参数如下所示：

• dimensions：视频编码的分辨率 (px)。默认值为 960 × 540。通常情况下，分辨率越高，视频的清晰度会越好。该参数的值不代表最终视频输出的方向。点击旋转方向模式了解如何设置视频输出的方向模式。

• frameRate：视频编码的帧率 (fps)，即每秒钟要编码多少帧画面。默认值为 15。通常情况下，帧率越大，画面越流畅。在对视频流畅度要求较高的场景下，可以将此参数设置为 20 或 25。建议不要将 frameRate 设置为大于 30。

• bitrate：视频编码码率 (Kbps)。默认值为 STANDARD_BITRATE，即标准码率模式。在标准码率模式下，SDK 会根据已设置的频道场景、分辨率和帧率为你设置一个合适的码率。

• minBitrate：如果你对视频质量有特殊的需求，可以通过 minBitrate 参数进行设置。minBitrate 为视频最低编码码率 (Kbps)。声网 SDK 会根据网络条件进行码率自适应。将此参数设置为大于默认值时，会强制视频编码器输出高质量的视频图像，但可能会导致丢包率增高并影响视频播放的流畅度。

声网 SDK 提供了多种分辨率、帧率以供选择，你也可以根据下表自行定义。

视频模式Copy Anchor Link

视频模式包括多种设置，你可以根据业务需求调整视频的方向、画质和镜像效果。

旋转方向模式Copy Anchor Link

在视频旋转场景中，我们主要关注采集端和播放端的行为。其中：

• 采集端采集视频并输出视频。即视频和 Status Bar 的相对位置。
• 播放端渲染接收到的视频图像，并根据接收到的旋转信息，结合自身 Status Bar 的相对位置旋转视频。

为防止视频因旋转出现大头、缩放或剪切的问题，声网 SDK 在 SetVideoEncoderConfiguration 中提供了 orientationMode 参数。你可以通过这个参数，结合视频场景需要，获取想要的视频渲染效果。

orientationMode 参数提供了三种模式以适应不同的用户需求：ORIENTATION_MODE_ADAPTIVE、ORIENTATION_MODE_FIXED_LANDSCAPE 和 ORIENTATION_MODE_FIXED_PORTRAIT。

无论采取哪种模式，声网 SDK 都保证视频和 Status Bar 的相对位置在采集端和播放端始终一致。

ORIENTATION_MODE_ADAPTIVE

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

• 如果采集的视频是横屏模式，则输出的视频也是横屏模式。

• 如果采集的视频是竖屏模式，则输出的视频也是竖屏模式。

ORIENTATION_MODE_FIXED_LANDSCAPE

在 ORIENTATION_MODE_FIXED_LANDSCAPE 模式下，输出的视频相对 Status Bar 总是处于横屏模式。如果采集到的视频是竖屏模式，则视频编码器会对其进行裁剪。该方式适用于接收端无法处理旋转信息的情况。

ORIENTATION_MODE_FIXED_PORTRAIT

在 ORIENTATION_MODE_FIXED_PORTRAIT 模式下，输出的视频相对 Status Bar 总是处于竖屏模式。如果采集到的视频是横屏模式，则视频编码器会对其进行裁剪。该方式适用于接收端无法处理旋转信息的情况。

降级偏好Copy Anchor Link

为保证弱网下用户的视频体验，声网 SDK 还提供了 degradationPreference 参数，来设置带宽受限时视频编码的降级偏好。

镜像模式Copy Anchor Link

默认情况下，SDK 在编码时不对视频作镜像操作。你可以通过 mirrorMode 参数设置视频编码的镜像模式，从而决定远端用户看到的视频画面。

本文介绍如何调用声网提供的 API 设置视频编码属性。

功能介绍Copy Anchor Link

视频编码属性包含视频分辨率、帧率、码率等影响视频质量的参数设置。你可以通过设置视频编码属性，控制视频流在不同网络条件下的展示方式。

声网 SDK 提供了 setVideoEncoderConfiguration 方法，用于设置视频编码属性。你可以在 enableVideo 前调用该方法以加快首帧出图的时间；也可以在频道内调用该方法以灵活调整视频编码属性。

前提条件Copy Anchor Link

在进行操作之前，请确保你已经在项目中实现了基本的实时音视频功能。详见实现音视频互动。

实现方法Copy Anchor Link

你可以参考如下示例代码，在你的项目中设置各种视频编码参数：

await _engine.setVideoEncoderConfiguration(
  const VideoEncoderConfiguration(
    dimensions: VideoDimensions(width: 1920, height: 1080), // 设置分辨率

    frameRate: 15, // 设置帧率

    bitrate: 800,  // 设置码率

    orientationMode: OrientationMode.orientationModeAdaptive, // 设置旋转方向模式

    degradationPreference: DegradationPreference.maintainQuality,  // 设置降级偏好

  ),
);

开发注意事项Copy Anchor Link

• setVideoEncoderConfiguration 中的各参数值是在理想网络状态下的最大值。声网 SDK 会根据实时网络环境和设备，对设置的参数作自适应调整，通常会下调参数。
• setVideoEncoderConfiguration 中的参数设置可能会影响计费。如果因自适应产生参数下调，计费按用户实际订阅的视频分辨率为准。详见计费说明。

参考信息Copy Anchor Link

API 参考Copy Anchor Link

• setVideoEncoderConfiguration

视频参数推荐值Copy Anchor Link

通常来讲，视频编码参数的选择要根据产品实际情况和场景来确定。比如，在一对一教学场景下，老师和学生的窗口比较大，要求分辨率会高一点，随之帧率和码率也要高一点； 如果是一对四场景， 老师和学生的窗口都比较小，分辨率可以低一点，对应的码率帧率也会低一点，以减少编解码的资源消耗和缓解下行带宽压力。

一般可按下列场景中的推荐值进行设置。

• 双人视频通话场景：
  • 分辨率 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

分辨率、帧率和码率Copy Anchor Link

视频编码属性的参数如下所示：

• dimensions：视频编码的分辨率 (px)。默认值为 960 × 540。通常情况下，分辨率越高，视频的清晰度会越好。该参数的值不代表最终视频输出的方向。点击旋转方向模式了解如何设置视频输出的方向模式。

• frameRate：视频编码的帧率 (fps)，即每秒钟要编码多少帧画面。默认值为 15。通常情况下，帧率越大，画面越流畅。在对视频流畅度要求较高的场景下，可以将此参数设置为 20 或 25。建议不要将 frameRate 设置为大于 30。

• bitrate：视频编码码率 (Kbps)。默认值为 standardBitrate，即标准码率模式。在标准码率模式下，SDK 会根据已设置的频道场景、分辨率和帧率为你设置一个合适的码率。

• minBitrate：如果你对视频质量有特殊的需求，可以通过 minBitrate 参数进行设置。minBitrate 为视频最低编码码率 (Kbps)。声网 SDK 会根据网络条件进行码率自适应。将此参数设置为大于默认值时，会强制视频编码器输出高质量的视频图像，但可能会导致丢包率增高并影响视频播放的流畅度。

声网 SDK 提供了多种分辨率、帧率以供选择，你也可以根据下表自行定义。

视频模式Copy Anchor Link

视频模式包括多种设置，你可以根据业务需求调整视频的方向、画质和镜像效果。

旋转方向模式Copy Anchor Link

在视频旋转场景中，我们主要关注采集端和播放端的行为。其中：

• 采集端采集视频并输出视频。即视频和 Status Bar 的相对位置。
• 播放端渲染接收到的视频图像，并根据接收到的旋转信息，结合自身 Status Bar 的相对位置旋转视频。

为防止视频因旋转出现大头、缩放或剪切的问题，声网 SDK 在 setVideoEncoderConfiguration 中提供了 orientationMode 参数。你可以通过这个参数，结合视频场景需要，获取想要的视频渲染效果。

orientationMode 参数提供了三种模式以适应不同的用户需求：orientationModeAdaptive、orientationModeFixedLandscape 和 orientationModeFixedPortrait。 无论采取哪种模式，声网 SDK 都保证视频和 Status Bar 的相对位置在采集端和播放端始终一致。

orientationModeAdaptive

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

• 如果采集的视频是横屏模式，则输出的视频也是横屏模式。

• 如果采集的视频是竖屏模式，则输出的视频也是竖屏模式。

orientationModeFixedLandscape

在 orientationModeFixedLandscape 模式下，输出的视频相对 Status Bar 总是处于横屏模式。如果采集到的视频是竖屏模式，则视频编码器会对其进行裁剪。该方式适用于接收端无法处理旋转信息的情况。

orientationModeFixedPortrait

在 orientationModeFixedPortrait 模式下，输出的视频相对 Status Bar 总是处于竖屏模式。如果采集到的视频是横屏模式，则视频编码器会对其进行裁剪。该方式适用于接收端无法处理旋转信息的情况。

降级偏好Copy Anchor Link

为保证弱网下用户的视频体验，声网 SDK 还提供了 degradationPreference 参数，来设置带宽受限时视频编码的降级偏好。

镜像模式Copy Anchor Link

默认情况下，SDK 在编码时不对视频作镜像操作。你可以通过 mirrorMode 参数设置视频编码的镜像模式，从而决定远端用户看到的视频画面。

本文介绍如何调用声网提供的 API 设置视频编码属性。

功能介绍Copy Anchor Link

视频编码属性包含视频分辨率、帧率、码率等影响视频质量的参数设置。你可以通过设置视频编码属性，控制视频流在不同网络条件下的展示方式。

声网 SDK 提供了 setVideoEncoderConfiguration 方法，用于设置视频编码属性。你可以在 enableVideo 前调用该方法以加快首帧出图的时间；也可以在频道内调用该方法以灵活调整视频编码属性。

前提条件Copy Anchor Link

在进行操作之前，请确保你已经在项目中实现了基本的实时音视频功能。详见实现音视频互动。

实现方法Copy Anchor Link

你可以参考如下示例代码，在你的项目中设置各种视频编码参数：

// 视频编码参数配置
this.engine?.setVideoEncoderConfiguration({
  // 设置视频编码类型为 H264
  codecType: VideoCodecType.VideoCodecH264,
  // 设置视频编码的分辨率为 640 x 360 (px) 
  dimensions: {
    width: 640,
    height: 360,
  },
  // 设置帧率为 15 fps
  frameRate: 15,
  // 设置码率模式为 StandardBitrate
  bitrate: 0,
  // 设置最低编码码率为 1 Kbps
  minBitrate: -1,
  // 设置旋转方向模式为 Adaptive
  orientationMode: OrientationMode.OrientationModeAdaptive,
  // 设置降级偏好为 MaintainQuality
  degradationPreference: DegradationPreference.MaintainQuality,
  // 禁用发送编码视频时的镜像模式
  mirrorMode: VideoMirrorModeType.VideoMirrorModeDisabled,
});

开发注意事项Copy Anchor Link

• setVideoEncoderConfiguration 中的各参数值是在理想网络状态下的最大值。声网 SDK 会根据实时网络环境和设备，对设置的参数作自适应调整，通常会下调参数。
• setVideoEncoderConfiguration 中的参数设置可能会影响计费。如果因自适应产生参数下调，计费按用户实际订阅的视频分辨率为准。详见计费说明。

参考信息Copy Anchor Link

API 参考Copy Anchor Link

• setVideoEncoderConfiguration

视频参数推荐值Copy Anchor Link

通常来讲，视频编码参数的选择要根据产品实际情况和场景来确定。比如，在一对一教学场景下，老师和学生的窗口比较大，要求分辨率会高一点，随之帧率和码率也要高一点； 如果是一对四场景， 老师和学生的窗口都比较小，分辨率可以低一点，对应的码率帧率也会低一点，以减少编解码的资源消耗和缓解下行带宽压力。

一般可按下列场景中的推荐值进行设置。

• 双人视频通话场景：
  • 分辨率 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

分辨率、帧率和码率Copy Anchor Link

视频编码属性的参数如下所示：

• dimensions：视频编码的分辨率 (px)。默认值为 960 × 540。通常情况下，分辨率越高，视频的清晰度会越好。该参数的值不代表最终视频输出的方向。点击旋转方向模式了解如何设置视频输出的方向模式。

• frameRate：视频编码的帧率 (fps)，即每秒钟要编码多少帧画面。默认值为 15。通常情况下，帧率越大，画面越流畅。在对视频流畅度要求较高的场景下，可以将此参数设置为 20 或 25。建议不要将 frameRate 设置为大于 30。

• bitrate：视频编码码率 (Kbps)。默认值为 STANDARD_BITRATE，即标准码率模式。在标准码率模式下，SDK 会根据已设置的频道场景、分辨率和帧率为你设置一个合适的码率。

• minBitrate：如果你对视频质量有特殊的需求，可以通过 minBitrate 参数进行设置。minBitrate 为视频最低编码码率 (Kbps)。声网 SDK 会根据网络条件进行码率自适应。将此参数设置为大于默认值时，会强制视频编码器输出高质量的视频图像，但可能会导致丢包率增高并影响视频播放的流畅度。

声网 SDK 提供了多种分辨率、帧率以供选择，你也可以根据下表自行定义。

视频模式Copy Anchor Link

旋转方向模式Copy Anchor Link

在视频旋转场景中，我们主要关注采集端和播放端的行为。其中：

• 采集端采集视频并输出视频。即视频和 Status Bar 的相对位置。
• 播放端渲染接收到的视频图像，并根据接收到的旋转信息，结合自身 Status Bar 的相对位置旋转视频。

为防止视频因旋转出现大头、缩放或剪切的问题，声网 SDK 在 setVideoEncoderConfiguration 中提供了 orientationMode 参数。你可以通过这个参数，结合视频场景需要，获取想要的视频渲染效果。

orientationMode 参数提供了三种模式以适应不同的用户需求：OrientationModeAdaptive、OrientationModeFixedLandscape 和 OrientationModeFixedPortrait。 无论采取哪种模式，声网 SDK 都保证视频和 Status Bar 的相对位置在采集端和播放端始终一致。

OrientationModeAdaptive

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

• 如果采集的视频是横屏模式，则输出的视频也是横屏模式。

• 如果采集的视频是竖屏模式，则输出的视频也是竖屏模式。

OrientationModeFixedLandscape

在 OrientationModeFixedLandscape 模式下，输出的视频相对 Status Bar 总是处于横屏模式。如果采集到的视频是竖屏模式，则视频编码器会对其进行裁剪。该方式适用于接收端无法处理旋转信息的情况。

OrientationFixedPortrait

在 OrientationFixedPortrait 模式下，输出的视频相对 Status Bar 总是处于竖屏模式。如果采集到的视频是横屏模式，则视频编码器会对其进行裁剪。该方式适用于接收端无法处理旋转信息的情况。

降级偏好Copy Anchor Link

为保证弱网下用户的视频体验，声网 SDK 还提供了 degradationPreference 参数，来设置带宽受限时视频编码的降级偏好。

镜像模式Copy Anchor Link

默认情况下，SDK 在编码时不对视频作镜像操作。你可以通过 mirrorMode 参数设置视频编码的镜像模式，从而决定远端用户看到的视频画面。

本文介绍如何调用声网提供的 API 设置视频编码属性。

功能介绍Copy Anchor Link

视频编码属性包含视频分辨率、帧率、码率等影响视频质量的参数设置。你可以通过设置视频编码属性，控制视频流在不同网络条件下的展示方式。

声网 SDK 提供了 setVideoEncoderConfiguration 方法设置视频编码属性。你可以在 enableVideo 前调用该方法以加快首帧出图的时间；也可以在频道内调用该方法以灵活调整视频编码属性。

前提条件Copy Anchor Link

在进行操作之前，请确保你已经在项目中实现了基本的实时音视频功能。详见实现音视频互动。

实现方法Copy Anchor Link

你可以参考如下示例代码，在你的项目中设置各种视频编码参数：

// 创建视频编码配置对象
VideoEncoderConfiguration videoConfig;
// 设置视频宽度
videoConfig.dimensions.width = 1280;
// 设置视频高度
videoConfig.dimensions.height = 720;
 // 设置帧率为15 fps
videoConfig.frameRate = FRAME_RATE_FPS_15;
// 设置码率为800 Kbps
videoConfig.bitrate = 800 * 1000;
// 设置旋转方向模式为 ADAPTIVE
videoConfig.orientationMode = ORIENTATION_MODE_ADAPTIVE;
 // 设置降级偏好为 MAINTAIN_QUALITY
videoConfig.degradationPreference = MAINTAIN_QUALITY;

// 应用视频编码配置
rtcEngine->setVideoEncoderConfiguration(videoConfig);

开发注意事项Copy Anchor Link

• setVideoEncoderConfiguration 中的各参数值是在理想网络状态下的最大值。声网 SDK 会根据实时网络环境和设备，对设置的参数作自适应调整，通常会下调参数。
• setVideoEncoderConfiguration 中的参数设置可能会影响计费。如果因自适应产生参数下调，计费按用户实际订阅的视频分辨率为准。详见计费说明。

参考信息Copy Anchor Link

示例项目Copy Anchor Link

声网提供了开源的示例项目供你参考，你可以前往下载或查看其中的源代码。

API 参考Copy Anchor Link

• setVideoEncoderConfiguration
• onVideoSizeChanged

视频参数推荐值Copy Anchor Link

通常来讲，视频编码参数的选择要根据产品实际情况和场景来确定。比如，在一对一教学场景下，老师和学生的窗口比较大，要求分辨率会高一点，随之帧率和码率也要高一点；如果是一对四场景，老师和学生的窗口都比较小，分辨率可以低一点，对应的码率帧率也会低一点，以减少编解码的资源消耗和缓解下行带宽压力。

一般可按下列场景中的推荐值进行设置。

• 双人视频通话场景：
  • 分辨率 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

分辨率、帧率和码率Copy Anchor Link

视频编码属性的参数如下所示：

• dimensions：视频编码的分辨率 (px)。默认值为 960 × 540。通常情况下，分辨率越高，视频的清晰度会越好。该参数的值不代表最终视频输出的方向。点击旋转方向模式了解如何设置视频输出的方向模式。

• frameRate：视频编码的帧率 (fps)，即每秒钟要编码多少帧画面。默认值为 15。通常情况下，帧率越大，画面越流畅。在对视频流畅度要求较高的场景下，可以将此参数设置为 20 或 25。建议不要将 frameRate 设置为大于 30。

• bitrate：视频编码码率 (Kbps)。默认值为 STANDARD_BITRATE，即标准码率模式。在标准码率模式下，SDK 会根据已设置的频道场景、分辨率和帧率为你设置一个合适的码率。

• minBitrate：如果你对视频质量有特殊的需求，可以通过 minBitrate 参数进行设置。minBitrate 为视频最低编码码率 (Kbps)。声网 SDK 会根据网络条件进行码率自适应。将此参数设置为大于默认值时，会强制视频编码器输出高质量的视频图像，但可能会导致丢包率增高并影响视频播放的流畅度。

声网 SDK 提供了多种分辨率、帧率以供选择，你也可以根据下表自行定义。

视频模式Copy Anchor Link

视频模式包括多种设置，你可以根据业务需求调整视频的方向、画质和镜像效果。

旋转方向模式Copy Anchor Link

在视频旋转场景中，我们主要关注采集端和播放端的行为。其中：

• 采集端采集视频并输出视频。即视频和 Status Bar 的相对位置。
• 播放端渲染接收到的视频图像，并根据接收到的旋转信息，结合自身 Status Bar 的相对位置旋转视频。

为防止视频因旋转出现大头、缩放或剪切的问题，声网 SDK 在 setVideoEncoderConfiguration 中提供了 orientationMode 参数。你可以通过这个参数，结合视频场景需要，获取想要的视频渲染效果。

orientationMode 参数提供了三种模式以适应不同的用户需求：ORIENTATION_MODE_ADAPTIVE、ORIENTATION_MODE_FIXED_LANDSCAPE 和 ORIENTATION_MODE_FIXED_PORTRAIT。

无论采取哪种模式，声网 SDK 都保证视频和 Status Bar 的相对位置在采集端和播放端始终一致。

ORIENTATION_MODE_ADAPTIVE

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

• 如果采集的视频是横屏模式，则输出的视频也是横屏模式。

• 如果采集的视频是竖屏模式，则输出的视频也是竖屏模式。

ORIENTATION_MODE_FIXED_LANDSCAPE

在 ORIENTATION_MODE_FIXED_LANDSCAPE 模式下，输出的视频相对 Status Bar 总是处于横屏模式。如果采集到的视频是竖屏模式，则视频编码器会对其进行裁剪。该方式适用于接收端无法处理旋转信息的情况。

ORIENTATION_MODE_FIXED_PORTRAIT

在 ORIENTATION_MODE_FIXED_PORTRAIT 模式下，输出的视频相对 Status Bar 总是处于竖屏模式。如果采集到的视频是横屏模式，则视频编码器会对其进行裁剪。该方式适用于接收端无法处理旋转信息的情况。

降级偏好Copy Anchor Link

为保证弱网下用户的视频体验，声网 SDK 还提供了 degradationPreference 参数，来设置带宽受限时视频编码的降级偏好。

镜像模式Copy Anchor Link

默认情况下，SDK 在编码时不对视频作镜像操作。你可以通过 mirrorMode 参数设置视频编码的镜像模式，从而决定远端用户看到的视频画面。

本文介绍如何调用声网提供的 API 设置视频编码属性。

功能介绍Copy Anchor Link

视频编码属性包含视频分辨率、帧率、码率等影响视频质量的参数设置。你可以通过设置视频编码属性，控制视频流在不同网络条件下的展示方式。

声网 SDK 提供了 SetVideoEncoderConfiguration 方法设置视频编码属性。 你可以在 EnableVideo 前调用该方法以加快首帧出图的时间；也可以在频道内调用该方法以灵活调整视频编码属性。

前提条件Copy Anchor Link

在进行操作之前，请确保你已经在项目中实现了基本的实时音视频功能。详见实现音视频互动。

实现步骤Copy Anchor Link

创建 UI 元素Copy Anchor Link

在 BP_VideoWidget 中，创建一个 Video Encoder Configuration 区域，包含以下控件：

• ET_FPS：设置视频编码的帧率。
• ET_Width：设置视频的宽度。
• ET_Height：设置视频的高度。
• ET_BitRate：设置视频的码率。
• ET_MinBitRate：设置视频的最低编码码率。

设置好的 UI 界面如下图所示：

绑定事件Copy Anchor Link

按照以下步骤，在节点中绑定对应的事件。

1. 在 Bind UIEvent 节点中，绑定 OnVideoConfigConfirmClicked UI 回调，当用户在 Video Encoder Confguration 中设置了视频编码参数时，会触发该回调。如下图所示：

2. 在 Bind Event 节点中，绑定 OnVideoSizeChanged 回调，当视频大小和旋转信息发生改变时触发该回调。如下图所示：

实现回调函数Copy Anchor Link

实现 OnVideoConfigConfirmClicked 回调函数Copy Anchor Link

按照以下步骤，实现 OnVideoConfigConfirmClicked 回调函数，并调用 SetVideoEncoderConfiguration 方法设置视频编码属性。

1. 在关卡蓝图的 My Blueprint 面板中，创建 OnVideoConfigConfirmClicked UI 事件节点。
2. 将已创建好的 UI 元素连接至 Make VideoEncoderConfiguration，将用户输入的编码参数传入 VideoEncoderConfiguration。 如下图所示：

3. 调用 Set Video Encoder Configuration 方法，并根据实际需求在 Make VideoEncoderConfiguration 中设置以下参数：

   • Orientation Mode：视频的旋转方向。
   • Degradation Preference：当带宽受限时视频编码的降级偏好。
   • Mirror Mode：远端用户看到的视频画面是否镜像。
   • Compression Preference：视频编码的压缩偏好。

   设置好的界面如下图所示：

实现 OnVideoSizeChanged 回调函数Copy Anchor Link

按照以下步骤，实现 OnVideoSizeChanged 回调函数，并通过回调中获取的视频变化信息调整本地视图。

1. 在关卡蓝图的 My Blueprint 面板中，创建 OnVideoSizeChanged 事件节点。
2. 从 OnVideoSizeChanged 中获取视频变化信息关键参数：sourceType、uid、width、height、rotation，然后将这些参数传入 Make FVideoViewIdentity，分别调整本地视图和远端视图，如下图所示。

开发注意事项Copy Anchor Link

• SetVideoEncoderConfiguration 中的各参数值是在理想网络状态下的最大值。声网 SDK 会根据实时网络环境和设备，对设置的参数作自适应调整，通常会下调参数。
• SetVideoEncoderConfiguration 中的参数设置可能会影响计费。如果因自适应产生参数下调，计费按用户实际订阅的视频分辨率为准。详见计费说明。

参考信息Copy Anchor Link

示例项目Copy Anchor Link

声网提供了开源的示例项目供你参考，你可以前往下载或查看其中的源代码。

API 参考Copy Anchor Link

• SetVideoEncoderConfiguration
• FOnVideoSizeChanged

视频参数推荐值Copy Anchor Link

通常来讲，视频编码参数的选择要根据产品实际情况和场景来确定。比如，在一对一教学场景下，老师和学生的窗口比较大，要求分辨率会高一点，随之帧率和码率也要高一点； 如果是一对四场景， 老师和学生的窗口都比较小，分辨率可以低一点，对应的码率帧率也会低一点，以减少编解码的资源消耗和缓解下行带宽压力。

一般可按下列场景中的推荐值进行设置。

• 双人视频通话场景：
  • 分辨率 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

分辨率、帧率和码率Copy Anchor Link

视频编码属性的参数如下所示：

• dimensions：视频编码的分辨率 (px)。默认值为 960 × 540。通常情况下，分辨率越高，视频的清晰度会越好。该参数的值不代表最终视频输出的方向。点击旋转方向模式了解如何设置视频输出的方向模式。

• frameRate：视频编码的帧率 (fps)，即每秒钟要编码多少帧画面。默认值为 15。通常情况下，帧率越大，画面越流畅。在对视频流畅度要求较高的场景下，可以将此参数设置为 20 或 25。建议不要将 frameRate 设置为大于 30。

• minBitrate：如果你对视频质量有特殊的需求，可以通过 minBitrate 参数进行设置。minBitrate 为视频最低编码码率 (Kbps)。声网 SDK 会根据网络条件进行码率自适应。将此参数设置为大于默认值时，会强制视频编码器输出高质量的视频图像，但可能会导致丢包率增高并影响视频播放的流畅度。

声网 SDK 提供了多种分辨率、帧率以供选择，你也可以根据下表自行定义。

视频模式Copy Anchor Link

视频模式包括多种设置，你可以根据业务需求调整视频的方向、画质和镜像效果。

旋转方向模式Copy Anchor Link

在视频旋转场景中，我们主要关注采集端和播放端的行为。其中：

• 采集端采集视频并输出视频，以及视频和 Status Bar（状态栏）的相对位置。
• 播放端渲染接收到的视频图像，并根据接收到的旋转信息，结合自身 Status Bar 的相对位置旋转视频。

为防止视频因旋转出现大头、缩放或剪切的问题，声网 SDK 在 SetVideoEncoderConfiguration 中提供了 Orientation Mode 参数。你可以通过这个参数，结合视频场景需要，获取想要的视频渲染效果。

Orientation Mode 参数提供了三种模式以适应不同的用户需求：ORIENTATION_MODE_ADAPTIVE、ORIENTATION_MODE_FIXED_LANDSCAPE 和 ORIENTATION_MODE_FIXED_PORTRAIT。

无论采取哪种模式，声网 SDK 都保证视频和 Status Bar 的相对位置在采集端和播放端始终一致。

ORIENTATION_MODE_ADAPTIVE

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

• 如果采集的视频是横屏模式，则输出的视频也是横屏模式。
• 如果采集的视频是竖屏模式，则输出的视频也是竖屏模式。

ORIENTATION_MODE_FIXED_LANDSCAPE

在该模式下，输出的视频相对 Status Bar 总是处于横屏模式。如果采集到的视频是竖屏模式，则视频编码器会对其进行裁剪。该方式适用于接收端无法处理旋转信息的情况。

ORIENTATION_MODE_FIXED_PORTRAIT

在该模式下，输出的视频相对 Status Bar 总是处于竖屏模式。如果采集到的视频是横屏模式，则视频编码器会对其进行裁剪。该方式适用于接收端无法处理旋转信息的情况。

降级偏好Copy Anchor Link

为保证弱网下用户的视频体验，声网 SDK 还提供了 Degradation Preference 参数，来设置带宽受限时视频编码的降级偏好。

镜像模式Copy Anchor Link

默认情况下，SDK 在编码时不对视频作镜像操作。你可以通过设置 Mirror Mode 参数从而确定远端用户看到的视频画面是否镜像。