# 摄像头采集 (/zh-CN/api-reference/rtc/unreal-cpp/video/camera-capture)
> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).
## setCameraStabilizationMode [#setcamerastabilizationmode]
设置摄像头防抖模式。
```cpp
virtual int setCameraStabilizationMode(CAMERA_STABILIZATION_MODE mode) = 0;
```
:::caution
注意:
该方法仅适用于 iOS。
:::
摄像头防抖模式默认关闭,你需要调用该方法开启并设置合适的防抖模式。
### 适用场景 [#适用场景]
在移动拍摄、暗光环境拍摄、手持拍摄时,你可以设置摄像头防抖模式,以减小摄像头晃动导致的影响,获得更加稳定、清晰的画面。
### 调用时机 [#调用时机]
该方法必须在摄像头成功开启后调用,即 SDK 触发 [onLocalVideoStateChanged](/zh-CN/api-reference/rtc/unreal-cpp/video/video-basic#callback_irtcengineeventhandler_onlocalvideostatechanged) 回调,返回本地视频状态为 LOCAL_VIDEO_STREAM_STATE_CAPTURING (1) 后。
### 调用限制 [#调用限制]
- 摄像头防抖只对视频分辨率大于 1280 × 720 以上的场景生效。
- 开启摄像头防抖后,摄像头防抖等级越高,相机的视角就越小、相机时延就越大。为保障用户体验,建议你将 mode 参数设置为 CAMERA_STABILIZATION_MODE_LEVEL_1。
### 参数 [#参数]
摄像头的防抖模式。详见 [CAMERA_STABILIZATION_MODE](/zh-CN/api-reference/rtc/unreal-cpp/enum-camerastabilizationmode)。
### 返回值 [#返回值]
- 0: 方法调用成功。
- < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类]
- [IRtcEngine](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_irtcengine)
## startCameraCapture [#startcameracapture]
开始通过摄像头采集视频。
```cpp
virtual int startCameraCapture(VIDEO_SOURCE_TYPE sourceType, const CameraCapturerConfiguration& config) = 0;
```
### 详情 [#详情]
调用该方法可以通过指定 sourceType 同时开启多路摄像头采集。
:::note
注: 在 iOS 平台上调用该方法前,如果要开启多路摄像头采集,需要在调用该方法前,先调用 [enableMultiCamera](/zh-CN/api-reference/rtc/unreal-cpp/device-management/video-device#api_irtcengine_enablemulticamera) 并设置 enabled 为 `true`。
:::
### 参数 [#参数-1]
视频源的类型。详见 [VIDEO_SOURCE_TYPE](/zh-CN/api-reference/rtc/unreal-cpp/enum-videosourcetype)。
:::note
注:
- iOS 设备最多支持 2 路摄像头采集的视频流(要求设备配备多摄像头或支持外接摄像头)。
- Android 设备最多支持 4 路摄像头采集的视频流(要求设备配备多摄像头或支持外接摄像头)。
- 桌面端最多支持 4 路摄像头采集的视频流。
:::
视频采集配置。详见 [CameraCapturerConfiguration](/zh-CN/api-reference/rtc/unreal-cpp/class-cameracapturerconfiguration)。
:::note
注: 在 iOS 平台上,该参数无实际作用。请使用 [enableMultiCamera](/zh-CN/api-reference/rtc/unreal-cpp/device-management/video-device#api_irtcengine_enablemulticamera) 中的 config 参数设置视频采集配置。
:::
### 返回值 [#返回值-1]
- 0: 方法调用成功。
- < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类-1]
- [IRtcEngine](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_irtcengine)
## stopCameraCapture [#stopcameracapture]
停止通过摄像头采集视频。
```cpp
virtual int stopCameraCapture(VIDEO_SOURCE_TYPE sourceType) = 0;
```
### 详情 [#详情-1]
调用 [startCameraCapture](/zh-CN/api-reference/rtc/unreal-cpp/video/camera-capture#api_irtcengine_startcameracapture) 开启一路或多路摄像头采集的视频流后,你可以调用该方法,通过设置 sourceType 停止一路或多路摄像头的视频采集。
:::note
注: 在 iOS 平台上,如果要关闭多路摄像头采集,需要在调用该方法之后调用 [enableMultiCamera](/zh-CN/api-reference/rtc/unreal-cpp/device-management/video-device#api_irtcengine_enablemulticamera) 并设置 enabled 为 `false`。
:::
:::caution
注意: 如果你正在使用本地合图功能,调用该方法停止通过第一个摄像头采集视频,会造成本地合图中断。
:::
### 参数 [#参数-2]
视频源的类型,详见 [VIDEO_SOURCE_TYPE](/zh-CN/api-reference/rtc/unreal-cpp/enum-videosourcetype)。
### 返回值 [#返回值-2]
- 0: 方法调用成功。
- < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类-2]
- [IRtcEngine](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_irtcengine)