# CameraCapturerConfiguration (/zh-CN/api-reference/rtc/cpp-all-platforms/class-cameracapturerconfiguration) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). ```cpp struct CameraCapturerConfiguration { #if defined(__ANDROID__) || (defined(__APPLE__) && TARGET_OS_IOS) || defined(__OHOS__) Optional cameraDirection; Optional cameraFocalLengthType; #else Optional deviceId; #endif #if defined(__ANDROID__) Optional cameraId; #endif Optional followEncodeDimensionRatio; VideoFormat format; }; ``` ## 属性 [#属性] (可选)摄像头方向,详见 [CAMERA_DIRECTION](/zh-CN/api-reference/rtc/cpp-all-platforms/enum-cameradirection)。 :::note 注: 该参数仅适用于 Android 和 iOS 平台。 ::: (可选)摄像头焦距类型,详见 [CAMERA_FOCAL_LENGTH_TYPE](/zh-CN/api-reference/rtc/cpp-all-platforms/enum-camerafocallengthtype)。 :::note 注: 该参数仅适用于 Android 和 iOS 平台。 - 设置摄像头焦距类型时,仅支持通过 `cameraDirection` 指定摄像头,不支持通过 `cameraId` 指定。 - 对于配备多镜头后置摄像头的 iOS 设备(如双摄:广角和超广角,或三摄:广角、超广角和长焦),可通过以下方式实现超广角视角的视频采集: - 方法一:将该参数设置为 `CAMERA_FOCAL_LENGTH_ULTRA_WIDE`(2)(超广角镜头)。 - 方法二:将该参数设置为 `CAMERA_FOCAL_LENGTH_DEFAULT`(0)(标准镜头),然后调用 [setCameraZoomFactor](/zh-CN/api-reference/rtc/cpp-all-platforms/device-management/video-device#api_irtcengine_setcamerazoomfactor) 将摄像头变焦因子设置为小于 1.0 的值,最小为 0.5。 两种方法的区别在于,方法一的超广角尺寸不可调节,而方法二支持自由调节变焦因子。 ::: 摄像头 ID,最大长度为 [MAX_DEVICE_ID_LENGTH_TYPE](/zh-CN/api-reference/rtc/cpp-all-platforms/enum-maxdeviceidlengthtype)。 :::note 注: 该参数仅适用于 Windows 和 macOS 平台。 ::: (可选)摄像头 ID。 :::note 注: 该参数仅适用于 Android 平台。 - 该参数与 `cameraDirection` 互斥,二者只能选其一。 - 使用 `cameraDirection` 指定摄像头更为简便,仅需指定摄像头方向(前置或后置),SDK 会通过 Android 原生 API 获取并确认实际摄像头 ID。 - 使用 `cameraId` 可更精确地指定某个摄像头,适用于多摄像头设备中 `cameraDirection` 无法识别或访问所有摄像头的场景,建议直接使用 `cameraId` 指定目标摄像头。 ::: (可选)是否遵循 [setVideoEncoderConfiguration](/zh-CN/api-reference/rtc/cpp-all-platforms/video/video-basic#api_irtcengine_setvideoencoderconfiguration) 中设置的视频宽高比: - true:(默认)遵循设置的视频宽高比。SDK 会根据设置的视频宽高比裁剪采集的视频,并同步更新本地预览画面以及 [onCaptureVideoFrame](/zh-CN/api-reference/rtc/cpp-all-platforms/video/video-raw#callback_ivideoframeobserver_oncapturevideoframe) 和 [onPreEncodeVideoFrame](/zh-CN/api-reference/rtc/cpp-all-platforms/video/video-raw#callback_ivideoframeobserver_onpreencodevideoframe) 中的视频帧。 - false:不遵循设置的视频宽高比。SDK 不会更改采集视频帧的宽高比。 (可选)视频帧的格式,详见 [VideoFormat](/zh-CN/api-reference/rtc/cpp-all-platforms/class-videoformat)。