# AgoraVideoEncoderConfiguration (/zh-CN/api-reference/rtc/macos/class-videoencoderconfiguration)
> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).
```objc
__attribute__((visibility("default"))) @interface AgoraVideoEncoderConfiguration : NSObject
@property(assign, nonatomic) CGSize dimensions;
@property(assign, nonatomic) AgoraVideoCodecType codecType;
@property(assign, nonatomic) NSInteger frameRate;
@property(assign, nonatomic) NSInteger bitrate;
@property(assign, nonatomic) NSInteger minBitrate;
@property(assign, nonatomic) AgoraVideoOutputOrientationMode orientationMode;
@property(assign, nonatomic) AgoraVideoMirrorMode mirrorMode;
@property (assign, nonatomic) AgoraDegradationPreference degradationPreference;
@property (strong, nonatomic) AgoraAdvancedVideoOptions *_Nullable advancedVideoOptions;
@end
```
## 属性 [#属性]
:::note
注:
- 是否支持 720p 或更高分辨率取决于设备性能。如果设备不支持 720p,帧率将低于设置值。
- 默认值为 960 × 540。
:::
你可以自行设置分辨率,或从以下列表中选择:
- `AgoraVideoDimension120x120`:120 × 120。
- `AgoraVideoDimension160x120`:160 × 120。
- `AgoraVideoDimension180x180`:180 × 180。
- `AgoraVideoDimension240x180`:240 × 180。
- `AgoraVideoDimension320x180`:320 × 180。
- `AgoraVideoDimension240x240`:240 × 240。
- `AgoraVideoDimension320x240`:320 × 240。
- `AgoraVideoDimension424x240`:424 × 240。
- `AgoraVideoDimension360x360`:360 × 360。
- `AgoraVideoDimension480x360`:480 × 360。
- `AgoraVideoDimension640x360`:640 × 360。
- `AgoraVideoDimension480x480`:480 × 480。
- `AgoraVideoDimension640x480`:640 × 480。
- `AgoraVideoDimension840x480`:840 × 480。
- `AgoraVideoDimension960x540`:960 × 540。
- `AgoraVideoDimension960x720`:960 × 720。
- `AgoraVideoDimension1280x720`:1280 × 720。
- `AgoraVideoDimension1920x1080`:1920 × 1080。
- `AgoraVideoDimension2540x1440`:2540 × 1440。
- `AgoraVideoDimension3840x2160`:3840 × 2160。
本地视频流的首选编码器类型。详见 [AgoraVideoCodecType](/zh-CN/api-reference/rtc/macos/enum-videocodectype)。
编码视频帧的帧率(fps)。默认值为 15。详见 [AgoraVideoFrameRate](/zh-CN/api-reference/rtc/macos/enum-framerate)。
视频的编码码率(Kbps)。无需手动设置该参数,保持默认值 AgoraVideoBitrateStandard 即可。SDK 会根据设置的视频分辨率和帧率自动匹配最合适的码率。
- AgoraVideoBitrateStandard(0):(推荐)标准码率模式。
- AgoraVideoBitrateCompatible(-1):自适应码率模式,一般不建议使用该值。
视频的最小编码码率(Kbps)。SDK 会自动调整编码码率以适应网络状况。设置高于默认值会强制编码器输出高质量图像,但可能导致更多丢包,影响视频流畅性。
:::note
注: 该参数仅适用于互动直播场景。
:::
编码视频的方向模式。详见 [AgoraVideoOutputOrientationMode](/zh-CN/api-reference/rtc/macos/enum-orientationmode)。
设置本地视频流发布时的镜像模式,仅影响远端用户看到的视频。详见 [AgoraVideoMirrorMode](/zh-CN/api-reference/rtc/macos/enum-videomirrormodetype)。
:::note
注: 默认情况下,视频不镜像。
:::
在带宽受限的情况下的视频降级偏好。详见 [AgoraDegradationPreference](/zh-CN/api-reference/rtc/macos/enum-degradationpreference)。
:::note
注: 当该参数设置为 `AgoraDegradationMaintainFramerate`(1)或 `AgoraDegradationBalanced`(2)时,`orientationMode` 需同时设置为 `AgoraVideoOutputOrientationModeAdaptative`(0),否则设置不生效。
:::
视频编码的高级选项。详见 [AgoraAdvancedVideoOptions](/zh-CN/api-reference/rtc/macos/class-advanceoptions)。
### 相关参考 [#相关参考]
- [initWithSize\:frameRate\:bitrate\:orientationMode\:mirrorMode:](/zh-CN/api-reference/rtc/macos/api-videoencoderconfiguration-initwithsize)
- [initWithWidth\:height\:frameRate\:bitrate\:orientationMode\:mirrorMode:](/zh-CN/api-reference/rtc/macos/api-videoencoderconfiguration-initwithwidth)