QAVVideoCtrl类 参考

视频控制器的封装类

#import <QAVVideoCtrl.h>

类 QAVVideoCtrl 继承关系图:

构造函数
(QAVResult)	- switchCamera:complete:
	切换摄像头。 更多...
(QAVResult)	- enableCamera:complete:
	打开/关闭摄像头。 更多...
(NSString *)	- getQualityTips
	获取通话中实时视频质量相关信息，业务侧可以不用关心，主要用来查看通话情况、排查问题等。 更多...
(void)	- setRemoteVideoDelegate:
	设置用远端视频设备输出远端视频的代理。 更多...
(void)	- setLocalVideoDelegate:
	设置打开本地输入视频流的代理。 更多...
(void)	- setScreenVideoDelegate:
	设置打开远端屏幕分享视频流的代理。 更多...
(void)	- setExternalCamAbility:
	开启外部采集之前必须设置外部采集的能力，包括图像大小，帧率。 更多...
(int)	- fillExternalCaptureFrame:
	向音视频SDK传入捕获的视频帧。 更多...
(AVCaptureVideoPreviewLayer *)	- getPreviewLayer
	获取摄像头视频的预览layer 更多...
(AVCaptureSession *)	- getCaptureSession
	获取本地摄像头的CaptureSession 更多...

属性
BOOL	isCameraOn
	打开/关闭摄像头 更多...
BOOL	isEnableExternalCapture
	打开/关闭外部视频捕获设备 更多...

函数文档

- (QAVResult) enableCamera:		(BOOL)	bEnable
complete:		(cameraOptionComplete)	block

参数

bEnable	是否打开。
block	返回打开/关闭摄像头的结果是成功还是失败。

返回

返回错误码。当返回QAV_OK时，操作回调才会被执行；否则就不会执行，需要处理具体的错误码。

- (int) fillExternalCaptureFrame:

(QAVVideoFrame *)

frame

参数

frame

视频帧数据及相关参数。

备注

要控制好传入视频帧的频率，最好控制在每秒10帧左右，具体频率视实际使用场景而定。

分辨率宽高比例限定只能为4：3，且最大宽度为640

图像颜色格式。当前仅支持QAVCOLOR_FORMAT_I420。

视频源类型。当前仅支持QAVVIDEO_SRC_TYPE_CAMERA。

返回

返回值为QAV_OK时表示成功，否则表示失败。

- (AVCaptureSession*) getCaptureSession

返回

返回值AVCaptureSession实例。失败时返回nil

- (AVCaptureVideoPreviewLayer*) getPreviewLayer

返回

返回值AVCaptureVideoPreviewLayer实例。失败时返回nil

- (NSString*) getQualityTips

返回

以字符串形式返回视频相关的质量参数。

- (void) setExternalCamAbility:

(QAVCameraInfo *)

info

参数

info	设置摄像头采集信息。

- (void) setLocalVideoDelegate:

(id< QAVLocalVideoDelegate >)

delegate

参数

delegate

本地输入视频流委托对象，都统一传递继承QAVLocalVideoDelegate的委托对象。

- (void) setRemoteVideoDelegate:

(id< QAVRemoteVideoDelegate >)

delegate

参数

delegate

远端视频流委托对象，都统一传递继承QAVRemoteVideoDelegate的委托对象。

- (void) setScreenVideoDelegate:

(id< QAVScreenVideoDelegate >)

delegate

参数

delegate

输入屏幕分享视频流委托对象，都统一传递继承QAVScreenVideoDelegate的委托对象。

- (QAVResult) switchCamera:		(cameraPos)	pos
complete:		(cameraOptionComplete)	block

参数

pos	摄像头的前后方向。
block	返回切换摄像头的结果是成功还是失败。

返回

返回错误码。当返回QAV_OK时，操作回调才会被执行；否则就不会执行，需要处理具体的错误码。

属性说明

- (BOOL) isCameraOn

readwritenonatomicassign

- (BOOL) isEnableExternalCapture

readwritenonatomicassign