ZegoVideoConfig

视频配置

详情

配置码率、帧率、分辨率等推流用到的参数。开发者应该注意的是，移动端与桌面端的宽高分辨率是相反的，例如，360p，移动端的分辨率为 360x640，而桌面端为 640x360。使用外部采集时，RTC的采集和编码分辨率不能设置为0*0，不然会导致整个引擎生命周期里的推流，都没有视频数据。

Declared in ZegoExpressDefines.h

属性

captureResolution

nonatomic, assign CGSize captureResolution

采集分辨率，控制摄像头图像采集的分辨率。SDK 要求将宽和高设置为偶数。仅摄像头启动前且没有使用自定义视频采集时，设置有效。出于性能考虑，SDK 在采集摄像头画面后、渲染预览画面之前，就将视频帧缩放为编码分辨率，因此预览画面的分辨率是编码分辨率，如果您需要预览画面的分辨率为此值，请先调用 [setCapturePipelineScaleMode] 将采集缩放模式改为 [Post]

encodeResolution

nonatomic, assign CGSize encodeResolution

编码分辨率，控制编码器编码推流的图像分辨率。SDK 要求将宽和高设置为偶数。推流前后设置均可生效

fps

nonatomic, assign int fps

帧率，控制摄像头采集帧率以及编码器编码帧率的大小。推流端设置60帧，拉流端生效需联系技术支持

bitrate

nonatomic, assign int bitrate

码率，单位为 kbps。推流前后设置均可生效。SDK 会根据开发者选择的场景，自动设置适配该场景的码率。若开发者手动设置的码率超出合理范围，SDK会自动按照合理区间处理码率。如因业务需要配置高码率，请联系 ZEGO 商务。

codecID

nonatomic, assign ZegoVideoCodecID codecID

要使用的编码器，默认为 default。仅在推流前设置生效

keyFrameInterval

nonatomic, assign int keyFrameInterval

视频关键帧间隔，单位秒。

是否必填：否。
默认值：2秒。
取值范围：[2, 5]。

注意事项：仅在推流前设置有效。

方法

defaultConfig

- (void)+ (instancetype)defaultConfig;

创建默认视频配置

Declared in ZegoExpressDefines.h

360p, 15fps, 600kbps

ZegoVideoConfig 实例

configWithPreset

- (void)+ (instancetype)configWithPreset:(ZegoVideoConfigPreset)preset;

通过预设枚举值创建视频配置

Declared in ZegoExpressDefines.h

ZegoVideoConfig 实例

initWithPreset

- (instancetype)initWithPreset:(ZegoVideoConfigPreset)preset;

通过预设枚举值创建视频配置

Declared in ZegoExpressDefines.h

ZegoVideoConfig 实例