AgoraVideoEncoderConfiguration

  • iOS

更新时间不可用

视频编码器配置。

Objective-C
__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

属性

参数名描述
dimensions

注:

  • 是否支持 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。
codecType

本地视频流的首选编码器类型。详见 AgoraVideoCodecType。

frameRate

编码视频帧的帧率(fps)。默认值为 15。详见 AgoraVideoFrameRate。

bitrate

视频的编码码率(Kbps)。无需手动设置该参数,保持默认值 AgoraVideoBitrateStandard 即可。SDK 会根据设置的视频分辨率和帧率自动匹配最合适的码率。

  • AgoraVideoBitrateStandard(0):(推荐)标准码率模式。
  • AgoraVideoBitrateCompatible(-1):自适应码率模式,一般不建议使用该值。
minBitrate

视频的最小编码码率(Kbps)。SDK 会自动调整编码码率以适应网络状况。设置高于默认值会强制编码器输出高质量图像,但可能导致更多丢包,影响视频流畅性。

注: 该参数仅适用于互动直播场景。

orientationMode

编码视频的方向模式。详见 AgoraVideoOutputOrientationMode。

mirrorMode

设置本地视频流发布时的镜像模式,仅影响远端用户看到的视频。详见 AgoraVideoMirrorMode。

注: 默认情况下,视频不镜像。

degradationPreference

在带宽受限的情况下的视频降级偏好。详见 AgoraDegradationPreference。

注: 当该参数设置为 AgoraDegradationMaintainFramerate(1)或 AgoraDegradationBalanced(2)时,orientationMode 需同时设置为 AgoraVideoOutputOrientationModeAdaptative(0),否则设置不生效。

advancedVideoOptions

视频编码的高级选项。详见 AgoraAdvancedVideoOptions。

表格内容超出当前宽度,可横向滚动查看更多列。

相关参考

这个页面有帮助吗?