#include <IAgoraRtcEngine.h>
◆ VideoEncoderConfiguration() [1/3]
◆ VideoEncoderConfiguration() [2/3]
◆ VideoEncoderConfiguration() [3/3]
agora::rtc::VideoEncoderConfiguration::VideoEncoderConfiguration |
( |
| ) |
|
|
inline |
◆ dimensions
视频编码的分辨率 (px)。
视频编码的像素,用于衡量编码质量,以长 × 宽表示,默认值为 640 x 360。用户可以自行设置分辨率: VideoDimensions 。
◆ frameRate
FRAME_RATE agora::rtc::VideoEncoderConfiguration::frameRate |
◆ minFrameRate
int agora::rtc::VideoEncoderConfiguration::minFrameRate |
◆ bitrate
int agora::rtc::VideoEncoderConfiguration::bitrate |
视频编码码率,单位为 Kbps:
你可以根据场景需要参照下表手动设置你想要的码率。若设置的视频码率超出合理范围,SDK 会自动按照合理区间处理码率。你也可以直接选择如下任意一种模式进行设置:
- STANDARD_BITRATE : (推荐) 标准码率模式。该模式下,视频在通信和直播场景下的码率有所不同:通信场景下,码率与基准码率一致;直播场景下,码率对照基准码率翻倍。
- COMPATIBLE_BITRATE : 适配码率模式。该模式下,视频在通信和直播场景下的码率均与基准码率一致。直播下如果选择该模式,视频帧率可能会低于设置的值。
声网在通信和直播场景下采用不同的编码方式,以提升不同场景下的用户体验。通信场景保证流畅,而直播场景则更注重画面质量,因此直播场景对码率的需求大于通信场景。所以声网推荐将该参数设置为 STANDARD_BITRATE 。
分辨率 | 帧率(fps) | 通信码率(Kbps) | 直播码率(Kbps) |
160 × 120 | 15 | 65 | 130 |
120 × 120 | 15 | 50 | 100 |
320 × 180 | 15 | 140 | 280 |
180 × 180 | 15 | 100 | 200 |
240 × 180 | 15 | 120 | 240 |
320 × 240 | 15 | 200 | 400 |
240 × 240 | 15 | 140 | 280 |
424 × 240 | 15 | 220 | 440 |
640 × 360 | 15 | 400 | 800 |
360 × 360 | 15 | 260 | 520 |
640 × 360 | 30 | 600 | 1200 |
360 × 360 | 30 | 400 | 800 |
480 × 360 | 15 | 320 | 640 |
480 × 360 | 30 | 490 | 980 |
640 × 480 | 15 | 500 | 1000 |
480 × 480 | 15 | 400 | 800 |
640 × 480 | 30 | 750 | 1500 |
480 × 480 | 30 | 600 | 1200 |
848 × 480 | 15 | 610 | 1220 |
848 × 480 | 30 | 930 | 1860 |
640 × 480 | 10 | 400 | 800 |
1280 × 720 | 15 | 1130 | 2260 |
1280 × 720 | 30 | 1710 | 3420 |
960 × 720 | 15 | 910 | 1820 |
960 × 720 | 30 | 1380 | 2760 |
1920 × 1080 | 15 | 2080 | 4160 |
1920 × 1080 | 30 | 3150 | 6300 |
1920 × 1080 | 60 | 4780 | 6500 |
- 注解
- 该表中的基准码率适用于通信场景。直播场景下通常需要较大码率来提升视频质量。声网推荐通过设置 STANDARD_BITRATE 模式来实现。你也可以直接将码率值设为基准码率值 × 2。
◆ minBitrate
int agora::rtc::VideoEncoderConfiguration::minBitrate |
最低编码码率,单位为 Kbps。
SDK 会根据网络状况自动调整视频编码码率。将参数设为高于默认值可强制视频编码器输出高质量图片,但在网络状况不佳情况下可能导致网络丢包并影响视频播放的流畅度造成卡顿。因此如非对画质有特殊需求,声网建议不要修改该参数的值。
- 注解
- 该参数仅适用于直播场景。
◆ orientationMode
◆ degradationPreference
◆ mirrorMode