# 视频设备管理 (/zh-CN/api-reference/rtc/ios/device-management/video-device)

> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).

<a id="toc_video_device"></a>

<a id="api_irtcengine_enablemulticamera"></a>

<a id="ariaid-title2"></a>

## enableMultiCamera\:config: [#enablemulticameraconfig]

启用或关闭多摄像头采集模式。

<a id="api_irtcengine_enablemulticamera__prototype"></a>

```objc
- (int)enableMultiCamera:(BOOL)enabled config:(AgoraCameraCapturerConfiguration* _Nullable)config NS_SWIFT_NAME(enableMultiCamera(_:config:));
```

<a id="api_irtcengine_enablemulticamera__detailed_desc"></a>

声网建议你在已有摄像头用于视频采集的场景中，按照以下步骤使用多摄像头进行视频采集和发布：

1. 调用该方法启用多摄像头采集模式。
2. 调用 [startPreview:](/zh-CN/api-reference/rtc/ios/video/video-basic#api_irtcengine_startpreview2) 启动本地视频预览。
3. 调用 [startCameraCapture\:config:](/zh-CN/api-reference/rtc/ios/video/camera-capture#api_irtcengine_startcameracapture)，并设置 `sourceType` 以使用第二个摄像头进行视频采集。
4. 调用 [joinChannelExByToken\:connection\:delegate\:mediaOptions\:joinSuccess:](/zh-CN/api-reference/rtc/ios/channel#api_irtcengineex_joinchannelex)，并将 `publishSecondaryCameraTrack` 设置为 YES，以在频道中发布第二个摄像头采集的视频流。

如果你想关闭多摄像头采集模式，请按以下步骤操作：

1. 调用 [stopCameraCapture:](/zh-CN/api-reference/rtc/ios/video/camera-capture#api_irtcengine_stopcameracapture)。
2. 调用该方法并将 `enabled` 设置为 NO。

使用该功能时，请确保系统版本为 iOS 13.0 或更高。支持多摄像头采集的最低 iOS 设备型号如下：

- iPhone XR
- iPhone XS
- iPhone XS Max
- iPad Pro 第三代及更新机型

:::note
注： 你可以在调用 [startPreview:](/zh-CN/api-reference/rtc/ios/video/video-basic#api_irtcengine_startpreview2) 之前或之后调用该方法启用多摄像头采集：

- 如果在 [startPreview:](/zh-CN/api-reference/rtc/ios/video/video-basic#api_irtcengine_startpreview2) 之前启用，本地视频预览会同时显示两个摄像头采集的画面。
- 如果在 [startPreview:](/zh-CN/api-reference/rtc/ios/video/video-basic#api_irtcengine_startpreview2) 之后启用，SDK 会先停止当前摄像头采集，然后启用主摄像头和第二个摄像头。本地视频预览会短暂变黑，然后自动恢复正常。
:::

<a id="api_irtcengine_enablemulticamera__parameters"></a>

### 参数 [#参数]

<ParameterList>
<a id="enabled"></a>
<Parameter name="enabled">

是否启用多摄像头视频采集模式：

- YES：启用多摄像头采集模式，SDK 使用多个摄像头进行视频采集。
- NO：关闭多摄像头采集模式，SDK 使用单个摄像头进行视频采集。

</Parameter>
<a id="config"></a>
<Parameter name="config">

第二个摄像头的采集配置。详见 [AgoraCameraCapturerConfiguration](/zh-CN/api-reference/rtc/ios/class-cameracapturerconfiguration)。

</Parameter>
</ParameterList>

<a id="api_irtcengine_enablemulticamera__return_values"></a>

### 返回值 [#返回值]

- 0：方法调用成功。
- &lt; 0：方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。

### 所属接口类 [#所属接口类]

- [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/ios/rtc-interface-class#class_irtcengine)

<a id="api_irtcengine_getcameramaxzoomfactor"></a>

<a id="ariaid-title3"></a>

## cameraMaxZoomFactor [#cameramaxzoomfactor]

获取摄像头支持的最大变焦倍数。

<a id="api_irtcengine_getcameramaxzoomfactor__prototype"></a>

```objc
- (CGFloat)cameraMaxZoomFactor NS_SWIFT_NAME(cameraMaxZoomFactor());
```

<a id="api_irtcengine_getcameramaxzoomfactor__detailed_desc"></a>

:::note
注： 你必须在 SDK 触发 [rtcEngine\:localVideoStateChangedOfState\:reason\:sourceType:](/zh-CN/api-reference/rtc/ios/video/video-basic#callback_irtcengineeventhandler_onlocalvideostatechanged) 回调，并返回本地视频状态为 `AgoraVideoLocalStateCapturing`（1）后调用该方法。
:::

<a id="api_irtcengine_getcameramaxzoomfactor__return_values"></a>

### 返回值 [#返回值-1]

方法调用成功，返回摄像头支持的最大变焦倍数。

### 所属接口类 [#所属接口类-1]

- [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/ios/rtc-interface-class#class_irtcengine)

<a id="api_irtcengine_iscameraautoexposurefacemodesupported"></a>

<a id="ariaid-title4"></a>

## isCameraAutoExposureFaceModeSupported [#iscameraautoexposurefacemodesupported]

检查设备是否支持自动曝光。

<a id="api_irtcengine_iscameraautoexposurefacemodesupported__prototype"></a>

```objc
- (BOOL)isCameraAutoExposureFaceModeSupported NS_SWIFT_NAME(isCameraAutoExposureFaceModeSupported());
```

<a id="api_irtcengine_iscameraautoexposurefacemodesupported__detailed_desc"></a>

:::note
注： [isCameraAutoExposureFaceModeSupported](/zh-CN/api-reference/rtc/ios/device-management/video-device#api_irtcengine_iscameraautoexposurefacemodesupported) 方法必须在 SDK 触发 [rtcEngine\:localVideoStateChangedOfState\:reason\:sourceType:](/zh-CN/api-reference/rtc/ios/video/video-basic#callback_irtcengineeventhandler_onlocalvideostatechanged) 回调并返回本地视频状态为 `AgoraVideoLocalStateCapturing`（1）后调用。
:::

<a id="api_irtcengine_iscameraautoexposurefacemodesupported__return_values"></a>

### 返回值 [#返回值-2]

- YES：设备支持自动曝光。
- NO：设备不支持自动曝光。

### 所属接口类 [#所属接口类-2]

- [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/ios/rtc-interface-class#class_irtcengine)

<a id="api_irtcengine_iscameraautofocusfacemodesupported"></a>

<a id="ariaid-title5"></a>

## isCameraAutoFocusFaceModeSupported [#iscameraautofocusfacemodesupported]

检查设备是否支持人脸自动对焦功能。

<a id="api_irtcengine_iscameraautofocusfacemodesupported__prototype"></a>

```objc
- (BOOL)isCameraAutoFocusFaceModeSupported NS_SWIFT_NAME(isCameraAutoFocusFaceModeSupported());
```

<a id="api_irtcengine_iscameraautofocusfacemodesupported__detailed_desc"></a>

:::note
注： 你必须在 SDK 触发 [rtcEngine\:localVideoStateChangedOfState\:reason\:sourceType:](/zh-CN/api-reference/rtc/ios/video/video-basic#callback_irtcengineeventhandler_onlocalvideostatechanged) 回调并返回本地视频状态为 `AgoraVideoLocalStateCapturing`（1）后调用此方法。
:::

<a id="api_irtcengine_iscameraautofocusfacemodesupported__return_values"></a>

### 返回值 [#返回值-3]

- YES：设备支持人脸自动对焦功能。
- NO：设备不支持人脸自动对焦功能。

### 所属接口类 [#所属接口类-3]

- [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/ios/rtc-interface-class#class_irtcengine)

<a id="api_irtcengine_iscameraexposurepositionsupported"></a>

<a id="ariaid-title6"></a>

## isCameraExposurePositionSupported [#iscameraexposurepositionsupported]

检查设备是否支持手动曝光。

<a id="api_irtcengine_iscameraexposurepositionsupported__prototype"></a>

```objc
- (BOOL)isCameraExposurePositionSupported NS_SWIFT_NAME(isCameraExposurePositionSupported());
```

<a id="api_irtcengine_iscameraexposurepositionsupported__detailed_desc"></a>

:::note
注： 必须在 SDK 触发 [rtcEngine\:localVideoStateChangedOfState\:reason\:sourceType:](/zh-CN/api-reference/rtc/ios/video/video-basic#callback_irtcengineeventhandler_onlocalvideostatechanged) 回调并返回本地视频状态为 `AgoraVideoLocalStateCapturing`（1）后调用此方法。
:::

<a id="api_irtcengine_iscameraexposurepositionsupported__return_values"></a>

### 返回值 [#返回值-4]

- YES：设备支持手动曝光。
- NO：设备不支持手动曝光。

### 所属接口类 [#所属接口类-4]

- [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/ios/rtc-interface-class#class_irtcengine)

<a id="api_irtcengine_iscameraexposuresupported"></a>

<a id="ariaid-title7"></a>

## isCameraExposureSupported [#iscameraexposuresupported]

查询当前摄像头是否支持调节曝光值。

<a id="api_irtcengine_iscameraexposuresupported__prototype"></a>

```objc
- (BOOL)isCameraExposureSupported NS_SWIFT_NAME(isCameraExposureSupported());
```

<a id="api_irtcengine_iscameraexposuresupported__detailed_desc"></a>

:::info[自从]
自 v4.2.2 版本新增。
:::

:::note
注：

- 你必须在 SDK 触发 [rtcEngine\:localVideoStateChangedOfState\:reason\:sourceType:](/zh-CN/api-reference/rtc/ios/video/video-basic#callback_irtcengineeventhandler_onlocalvideostatechanged) 回调并返回本地视频状态为 `AgoraVideoLocalStateCapturing`（1）后调用该方法。
- 在调用 [setCameraExposureFactor:](/zh-CN/api-reference/rtc/ios/device-management/video-device#api_irtcengine_setcameraexposurefactor) 之前，建议你先调用该方法，确认当前摄像头是否支持调节曝光值。
- 该方法用于调节当前激活摄像头的曝光值，即调用 [setCameraCapturerConfiguration:](/zh-CN/api-reference/rtc/ios/device-management/video-device#api_irtcengine_setcameracapturerconfiguration) 时指定的摄像头。
:::

<a id="api_irtcengine_iscameraexposuresupported__return_values"></a>

### 返回值 [#返回值-5]

- YES：查询成功，当前摄像头支持调节曝光值。
- NO：查询失败，当前摄像头不支持调节曝光值。

### 所属接口类 [#所属接口类-5]

- [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/ios/rtc-interface-class#class_irtcengine)

<a id="api_irtcengine_iscamerafocussupported"></a>

<a id="ariaid-title8"></a>

## isCameraFocusPositionInPreviewSupported [#iscamerafocuspositioninpreviewsupported]

检查设备是否支持手动对焦功能。

<a id="api_irtcengine_iscamerafocussupported__prototype"></a>

```objc
- (BOOL)isCameraFocusPositionInPreviewSupported NS_SWIFT_NAME(isCameraFocusPositionInPreviewSupported());
```

<a id="api_irtcengine_iscamerafocussupported__detailed_desc"></a>

:::note
注： 必须在 SDK 触发 [rtcEngine\:localVideoStateChangedOfState\:reason\:sourceType:](/zh-CN/api-reference/rtc/ios/video/video-basic#callback_irtcengineeventhandler_onlocalvideostatechanged) 回调并返回本地视频状态为 `AgoraVideoLocalStateCapturing`（1）后调用此方法。
:::

<a id="api_irtcengine_iscamerafocussupported__return_values"></a>

### 返回值 [#返回值-6]

- YES：设备支持手动对焦功能。
- NO：设备不支持手动对焦功能。

### 所属接口类 [#所属接口类-6]

- [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/ios/rtc-interface-class#class_irtcengine)

<a id="api_irtcengine_iscameratorchsupported"></a>

<a id="ariaid-title9"></a>

## isCameraTorchSupported [#iscameratorchsupported]

检查设备是否支持相机闪光灯。

<a id="api_irtcengine_iscameratorchsupported__prototype"></a>

```objc
- (BOOL)isCameraTorchSupported NS_SWIFT_NAME(isCameraTorchSupported());
```

<a id="api_irtcengine_iscameratorchsupported__detailed_desc"></a>

:::note
注： 你必须在 SDK 触发 [rtcEngine\:localVideoStateChangedOfState\:reason\:sourceType:](/zh-CN/api-reference/rtc/ios/video/video-basic#callback_irtcengineeventhandler_onlocalvideostatechanged) 回调并返回本地视频状态为 `AgoraVideoLocalStateCapturing`（1）后调用该方法。App 默认启用前置摄像头。如果前置摄像头不支持闪光灯，该方法返回 NO。如果你想检查后置摄像头是否支持闪光灯功能，请在调用该方法前调用 [switchCamera](/zh-CN/api-reference/rtc/ios/device-management/video-device#api_irtcengine_switchcamera)。在系统版本为 15 的 iPad 上，即使 [isCameraTorchSupported](/zh-CN/api-reference/rtc/ios/device-management/video-device#api_irtcengine_iscameratorchsupported) 返回 YES，你也可能因系统问题调用 [setCameraTorchOn:](/zh-CN/api-reference/rtc/ios/device-management/video-device#api_irtcengine_setcameratorchon) 启用闪光灯失败。
:::

<a id="api_irtcengine_iscameratorchsupported__return_values"></a>

### 返回值 [#返回值-7]

- YES：设备支持相机闪光灯。
- NO：设备不支持相机闪光灯。

### 所属接口类 [#所属接口类-7]

- [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/ios/rtc-interface-class#class_irtcengine)

<a id="api_irtcengine_iscamerazoomsupported"></a>

<a id="ariaid-title10"></a>

## isCameraZoomSupported [#iscamerazoomsupported]

检查设备是否支持摄像头变焦。

<a id="api_irtcengine_iscamerazoomsupported__prototype"></a>

```objc
- (BOOL)isCameraZoomSupported NS_SWIFT_NAME(isCameraZoomSupported());
```

<a id="api_irtcengine_iscamerazoomsupported__detailed_desc"></a>

<a id="api_irtcengine_iscamerazoomsupported__timing"></a>

### 调用时机 [#调用时机]

你必须在 SDK 触发 [rtcEngine\:localVideoStateChangedOfState\:reason\:sourceType:](/zh-CN/api-reference/rtc/ios/video/video-basic#callback_irtcengineeventhandler_onlocalvideostatechanged) 回调并返回本地视频状态为 `AgoraVideoLocalStateCapturing`（1）后调用该方法。

<a id="api_irtcengine_iscamerazoomsupported__return_values"></a>

### 返回值 [#返回值-8]

- YES：设备支持摄像头变焦。
- NO：设备不支持摄像头变焦。

### 所属接口类 [#所属接口类-8]

- [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/ios/rtc-interface-class#class_irtcengine)

<a id="api_irtcengine_querycamerafocallengthcapability"></a>

<a id="ariaid-title11"></a>

## queryCameraFocalLengthCapability [#querycamerafocallengthcapability]

查询摄像头支持的焦距能力。

<a id="api_irtcengine_querycamerafocallengthcapability__prototype"></a>

```objc
- (NSArray<AgoraFocalLengthInfo *>* _Nullable)queryCameraFocalLengthCapability NS_SWIFT_NAME(queryCameraFocalLengthCapability());
```

<a id="api_irtcengine_querycamerafocallengthcapability__detailed_desc"></a>

如果你希望在视频采集中启用广角或超广角模式，建议你首先调用 [queryCameraFocalLengthCapability](/zh-CN/api-reference/rtc/ios/device-management/video-device#api_irtcengine_querycamerafocallengthcapability) 方法检查设备是否支持所需的焦距能力。然后，根据查询结果调用 [setCameraCapturerConfiguration:](/zh-CN/api-reference/rtc/ios/device-management/video-device#api_irtcengine_setcameracapturerconfiguration) 方法调整摄像头的焦距配置，以确保最佳的视频采集性能。

<a id="api_irtcengine_querycamerafocallengthcapability__return_values"></a>

### 返回值 [#返回值-9]

- 方法调用成功，返回一个 [AgoraFocalLengthInfo](/zh-CN/api-reference/rtc/ios/class-focallengthinfo) 对象数组，包含摄像头的方向和焦距类型，详见 [AgoraFocalLengthInfo](/zh-CN/api-reference/rtc/ios/class-focallengthinfo)。
- 方法调用失败，返回 nil。

### 所属接口类 [#所属接口类-9]

- [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/ios/rtc-interface-class#class_irtcengine)

<a id="api_irtcengine_querycodeccapability"></a>

<a id="ariaid-title12"></a>

## queryCodecCapability [#querycodeccapability]

查询设备支持的视频编解码能力。

<a id="api_irtcengine_querycodeccapability__prototype"></a>

```objc
- (NSArray <AgoraVideoCodecCapInfo *> *_Nullable)queryCodecCapability;
```

<a id="api_irtcengine_querycodeccapability__detailed_desc"></a>

<a id="api_irtcengine_querycodeccapability__return_values"></a>

### 返回值 [#返回值-10]

- 方法调用成功时，返回一个 [AgoraVideoCodecCapInfo](/zh-CN/api-reference/rtc/ios/class-codeccapinfo) 数组，表示设备的视频编码能力，详见 [AgoraVideoCodecCapInfo](/zh-CN/api-reference/rtc/ios/class-codeccapinfo)。
- 方法调用失败时，返回 nil。如果调用超时，请调整调用逻辑，避免在主线程中调用该方法。

### 所属接口类 [#所属接口类-10]

- [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/ios/rtc-interface-class#class_irtcengine)

<a id="api_irtcengine_setcameraautoexposurefacemodeenabled"></a>

<a id="ariaid-title13"></a>

## setCameraAutoExposureFaceModeEnabled: [#setcameraautoexposurefacemodeenabled]

设置是否启用自动曝光。

<a id="api_irtcengine_setcameraautoexposurefacemodeenabled__prototype"></a>

```objc
- (BOOL)setCameraAutoExposureFaceModeEnabled:(BOOL)enable NS_SWIFT_NAME(setCameraAutoExposureFaceModeEnabled(_:));
```

<a id="api_irtcengine_setcameraautoexposurefacemodeenabled__detailed_desc"></a>

:::note
注： 你必须在调用 [enableVideo](/zh-CN/api-reference/rtc/ios/video/video-basic#api_irtcengine_enablevideo) 方法之后再调用此方法。设置结果将在摄像头成功开启后生效，即 SDK 触发 [rtcEngine\:localVideoStateChangedOfState\:reason\:sourceType:](/zh-CN/api-reference/rtc/ios/video/video-basic#callback_irtcengineeventhandler_onlocalvideostatechanged) 回调并返回本地视频状态为 `AgoraVideoLocalStateCapturing`（1）之后。
:::

<a id="api_irtcengine_setcameraautoexposurefacemodeenabled__parameters"></a>

### 参数 [#参数-1]

<ParameterList>
<a id="enable"></a>
<Parameter name="enable">

是否启用自动曝光：

- YES：启用自动曝光。
- NO：关闭自动曝光。

</Parameter>
</ParameterList>

<a id="api_irtcengine_setcameraautoexposurefacemodeenabled__return_values"></a>

### 返回值 [#返回值-11]

- YES：设置成功。
- NO：设置失败。

### 所属接口类 [#所属接口类-11]

- [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/ios/rtc-interface-class#class_irtcengine)

<a id="api_irtcengine_setcameraautofocusfacemodeenabled"></a>

<a id="ariaid-title14"></a>

## setCameraAutoFocusFaceModeEnabled: [#setcameraautofocusfacemodeenabled]

启用或关闭摄像头人像自动对焦功能。

<a id="api_irtcengine_setcameraautofocusfacemodeenabled__prototype"></a>

```objc
- (BOOL)setCameraAutoFocusFaceModeEnabled:(BOOL)enable NS_SWIFT_NAME(setCameraAutoFocusFaceModeEnabled(_:));
```

<a id="api_irtcengine_setcameraautofocusfacemodeenabled__detailed_desc"></a>

你可以通过调用该方法关闭人像自动对焦功能。SDK 默认启用该功能。

<a id="api_irtcengine_setcameraautofocusfacemodeenabled__timing"></a>

### 调用时机 [#调用时机-1]

必须在 SDK 触发 [rtcEngine\:localVideoStateChangedOfState\:reason\:sourceType:](/zh-CN/api-reference/rtc/ios/video/video-basic#callback_irtcengineeventhandler_onlocalvideostatechanged) 回调并返回本地视频状态为 `AgoraVideoLocalStateCapturing`（1）后调用。

<a id="api_irtcengine_setcameraautofocusfacemodeenabled__parameters"></a>

### 参数 [#参数-2]

<ParameterList>
<a id="enable-1"></a>
<Parameter name="enable">

是否启用摄像头人像自动对焦功能：

- YES：启用摄像头人像自动对焦功能。
- NO：关闭人像自动对焦功能。

</Parameter>
</ParameterList>

<a id="api_irtcengine_setcameraautofocusfacemodeenabled__return_values"></a>

### 返回值 [#返回值-12]

- YES：设置成功。
- NO：设置失败。

### 所属接口类 [#所属接口类-12]

- [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/ios/rtc-interface-class#class_irtcengine)

<a id="api_irtcengine_setcameracapturerconfiguration"></a>

<a id="ariaid-title15"></a>

## setCameraCapturerConfiguration: [#setcameracapturerconfiguration]

设置视频采集配置。

<a id="api_irtcengine_setcameracapturerconfiguration__prototype"></a>

```objc
- (int)setCameraCapturerConfiguration:(AgoraCameraCapturerConfiguration * _Nullable)config NS_SWIFT_NAME(setCameraCapturerConfiguration(_:));
```

<a id="api_irtcengine_setcameracapturerconfiguration__detailed_desc"></a>

在启用本地摄像头采集前调用此方法，例如在调用 [startPreview:](/zh-CN/api-reference/rtc/ios/video/video-basic#api_irtcengine_startpreview2) 和 `joinChannelByToken` 之前。

:::note
注： 如需调整摄像头焦距配置，建议先调用 [queryCameraFocalLengthCapability](/zh-CN/api-reference/rtc/ios/device-management/video-device#api_irtcengine_querycamerafocallengthcapability) 查询设备的焦距能力，并根据查询结果进行配置。
:::

<a id="api_irtcengine_setcameracapturerconfiguration__timing"></a>

### 调用时机 [#调用时机-2]

在启用本地摄像头采集前调用，例如在调用 [startPreview:](/zh-CN/api-reference/rtc/ios/video/video-basic#api_irtcengine_startpreview2) 和 `joinChannelByToken` 之前。

<a id="api_irtcengine_setcameracapturerconfiguration__parameters"></a>

### 参数 [#参数-3]

<ParameterList>
<a id="config-1"></a>
<Parameter name="config">

摄像头采集配置。详见 [AgoraCameraCapturerConfiguration](/zh-CN/api-reference/rtc/ios/class-cameracapturerconfiguration)。

:::note
注： 在此方法中，无需设置 `deviceId` 参数。
:::

</Parameter>
</ParameterList>

<a id="api_irtcengine_setcameracapturerconfiguration__return_values"></a>

### 返回值 [#返回值-13]

- 0：方法调用成功。
- &lt; 0：方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。

### 所属接口类 [#所属接口类-13]

- [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/ios/rtc-interface-class#class_irtcengine)

<a id="api_irtcengine_setcameraexposurefactor"></a>

<a id="ariaid-title16"></a>

## setCameraExposureFactor: [#setcameraexposurefactor]

设置摄像头曝光值。

<a id="api_irtcengine_setcameraexposurefactor__prototype"></a>

```objc
- (CGFloat)setCameraExposureFactor:(CGFloat)exposureFactor NS_SWIFT_NAME(setCameraExposureFactor(_:));
```

<a id="api_irtcengine_setcameraexposurefactor__detailed_desc"></a>

:::info[自从]
自 v4.2.2 版本新增。
:::

你可以通过此方法调整摄像头的曝光值，以获得最佳的视频质量。

:::note
注：

- 你必须在调用 [enableVideo](/zh-CN/api-reference/rtc/ios/video/video-basic#api_irtcengine_enablevideo) 方法之后再调用此方法。设置结果在摄像头成功开启后生效，即 SDK 触发 [rtcEngine\:localVideoStateChangedOfState\:reason\:sourceType:](/zh-CN/api-reference/rtc/ios/video/video-basic#callback_irtcengineeventhandler_onlocalvideostatechanged) 回调并返回本地视频状态为 `AgoraVideoLocalStateCapturing`（1）后。
- 在调用此方法前，建议你调用 [isCameraExposureSupported](/zh-CN/api-reference/rtc/ios/device-management/video-device#api_irtcengine_iscameraexposuresupported) 方法检查当前摄像头是否支持调整曝光值。
- 该方法调整的是当前正在使用的摄像头的曝光值，即调用 [setCameraCapturerConfiguration:](/zh-CN/api-reference/rtc/ios/device-management/video-device#api_irtcengine_setcameracapturerconfiguration) 方法时指定的摄像头。
:::

<a id="api_irtcengine_setcameraexposurefactor__parameters"></a>

### 参数 [#参数-4]

<ParameterList>
<a id="exposurefactor"></a>
<Parameter name="exposureFactor">

摄像头曝光值（默认值为 0）。值越大，曝光越强。当视频图像过曝时，可以降低曝光值；当视频图像曝光不足且暗部细节丢失时，可以提高曝光值。如果设置的曝光值超出设备支持的范围，SDK 会自动将其调整为设备实际支持的范围。取值范围为 [-8.0, 8.0]。

</Parameter>
</ParameterList>

<a id="api_irtcengine_setcameraexposurefactor__return_values"></a>

### 返回值 [#返回值-14]

无实际意义。

### 所属接口类 [#所属接口类-14]

- [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/ios/rtc-interface-class#class_irtcengine)

<a id="api_irtcengine_setcameraexposureposition"></a>

<a id="ariaid-title17"></a>

## setCameraExposurePosition: [#setcameraexposureposition]

设置摄像头曝光位置。

<a id="api_irtcengine_setcameraexposureposition__prototype"></a>

```objc
- (BOOL)setCameraExposurePosition:(CGPoint)positionInView NS_SWIFT_NAME(setCameraExposurePosition(_:));
```

<a id="api_irtcengine_setcameraexposureposition__detailed_desc"></a>

:::note
注： 你必须在调用 [enableVideo](/zh-CN/api-reference/rtc/ios/video/video-basic#api_irtcengine_enablevideo) 方法之后再调用该方法。设置结果会在摄像头成功开启后生效，即 SDK 触发 [rtcEngine\:localVideoStateChangedOfState\:reason\:sourceType:](/zh-CN/api-reference/rtc/ios/video/video-basic#callback_irtcengineeventhandler_onlocalvideostatechanged) 回调并返回本地视频状态为 `AgoraVideoLocalStateCapturing`（1）后生效。成功调用该方法后，SDK 会触发 [rtcEngine\:cameraExposureDidChangedToRect:](/zh-CN/api-reference/rtc/ios/device-management/video-device#callback_irtcengineeventhandler_oncameraexposureareachanged) 回调。
:::

<a id="api_irtcengine_setcameraexposureposition__parameters"></a>

### 参数 [#参数-5]

<ParameterList>
<a id="positioninview"></a>
<Parameter name="positionInView">

视图中触摸点的横坐标。

</Parameter>
</ParameterList>

<a id="api_irtcengine_setcameraexposureposition__return_values"></a>

### 返回值 [#返回值-15]

- YES：设置成功。
- NO：设置失败。

### 所属接口类 [#所属接口类-15]

- [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/ios/rtc-interface-class#class_irtcengine)

<a id="api_irtcengine_setcamerafocuspositioninpreview"></a>

<a id="ariaid-title18"></a>

## setCameraFocusPositionInPreview: [#setcamerafocuspositioninpreview]

设置摄像头的手动对焦位置。

<a id="api_irtcengine_setcamerafocuspositioninpreview__prototype"></a>

```objc
- (BOOL)setCameraFocusPositionInPreview:(CGPoint)position NS_SWIFT_NAME(setCameraFocusPositionInPreview(_:));
```

<a id="api_irtcengine_setcamerafocuspositioninpreview__detailed_desc"></a>

:::note
注： 你必须在调用 [enableVideo](/zh-CN/api-reference/rtc/ios/video/video-basic#api_irtcengine_enablevideo) 方法之后再调用本方法。设置结果会在摄像头成功开启后生效，即 SDK 触发 [rtcEngine\:localVideoStateChangedOfState\:reason\:sourceType:](/zh-CN/api-reference/rtc/ios/video/video-basic#callback_irtcengineeventhandler_onlocalvideostatechanged) 回调并返回本地视频状态为 `AgoraVideoLocalStateCapturing`（1）后生效。成功调用该方法后，SDK 会触发 [rtcEngine\:cameraFocusDidChangedToRect:](/zh-CN/api-reference/rtc/ios/device-management/video-device#callback_irtcengineeventhandler_oncamerafocusareachanged) 回调。
:::

<a id="api_irtcengine_setcamerafocuspositioninpreview__parameters"></a>

### 参数 [#参数-6]

<ParameterList>
<a id="position"></a>
<Parameter name="position">

视图中触摸点的坐标。

</Parameter>
</ParameterList>

<a id="api_irtcengine_setcamerafocuspositioninpreview__return_values"></a>

### 返回值 [#返回值-16]

- YES：设置成功。
- NO：设置失败。

### 所属接口类 [#所属接口类-16]

- [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/ios/rtc-interface-class#class_irtcengine)

<a id="api_irtcengine_setcameratorchon"></a>

<a id="ariaid-title19"></a>

## setCameraTorchOn: [#setcameratorchon]

启用摄像头闪光灯。

<a id="api_irtcengine_setcameratorchon__prototype"></a>

```objc
- (BOOL)setCameraTorchOn:(BOOL)isOn  NS_SWIFT_NAME(setCameraTorchOn(_:));
```

<a id="api_irtcengine_setcameratorchon__detailed_desc"></a>

:::note
注： 你必须在调用 [enableVideo](/zh-CN/api-reference/rtc/ios/video/video-basic#api_irtcengine_enablevideo) 后再调用此方法。设置结果将在摄像头成功开启后生效，即 SDK 触发 [rtcEngine\:localVideoStateChangedOfState\:reason\:sourceType:](/zh-CN/api-reference/rtc/ios/video/video-basic#callback_irtcengineeventhandler_onlocalvideostatechanged) 回调并返回本地视频状态为 `AgoraVideoLocalStateCapturing`（1）后。
:::

<a id="api_irtcengine_setcameratorchon__parameters"></a>

### 参数 [#参数-7]

<ParameterList>
<a id="ison"></a>
<Parameter name="isOn">

是否打开摄像头闪光灯：

- YES：打开闪光灯。
- NO：（默认）关闭闪光灯。

</Parameter>
</ParameterList>

<a id="api_irtcengine_setcameratorchon__return_values"></a>

### 返回值 [#返回值-17]

- YES：设置成功。
- NO：设置失败。

### 所属接口类 [#所属接口类-17]

- [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/ios/rtc-interface-class#class_irtcengine)

<a id="api_irtcengine_setcamerazoomfactor"></a>

<a id="ariaid-title20"></a>

## setCameraZoomFactor: [#setcamerazoomfactor]

设置摄像头的缩放因子。

<a id="api_irtcengine_setcamerazoomfactor__prototype"></a>

```objc
- (CGFloat)setCameraZoomFactor:(CGFloat)zoomFactor NS_SWIFT_NAME(setCameraZoomFactor(_:));
```

<a id="api_irtcengine_setcamerazoomfactor__detailed_desc"></a>

你可以调用 [setCameraCapturerConfiguration:](/zh-CN/api-reference/rtc/ios/device-management/video-device#api_irtcengine_setcameracapturerconfiguration) 方法，将 `cameraFocalLengthType` 设置为 `AgoraFocalLengthDefault`（0），然后将摄像头缩放因子设置为小于 1.0 的值，以实现超广角视角的视频采集。该方法适用于配备多镜头后置摄像头的 iOS 设备，例如配有广角、超广角和长焦镜头的设备。

:::note
注： 你必须在调用 [enableVideo](/zh-CN/api-reference/rtc/ios/video/video-basic#api_irtcengine_enablevideo) 之后再调用此方法。设置结果将在摄像头成功开启后生效，即 SDK 触发 [rtcEngine\:localVideoStateChangedOfState\:reason\:sourceType:](/zh-CN/api-reference/rtc/ios/video/video-basic#callback_irtcengineeventhandler_onlocalvideostatechanged) 回调并返回本地视频状态为 `AgoraVideoLocalStateCapturing`（1）之后。
:::

<a id="api_irtcengine_setcamerazoomfactor__parameters"></a>

### 参数 [#参数-8]

<ParameterList>
<a id="zoomfactor"></a>
<Parameter name="zoomFactor">

摄像头缩放因子。对于不支持超广角的设备，该值范围为 1.0 到最大缩放因子；对于支持超广角的设备，该值范围为 0.5 到最大缩放因子。你可以通过调用 [cameraMaxZoomFactor](/zh-CN/api-reference/rtc/ios/device-management/video-device#api_irtcengine_getcameramaxzoomfactor) 方法获取设备支持的最大缩放因子。

</Parameter>
</ParameterList>

<a id="api_irtcengine_setcamerazoomfactor__return_values"></a>

### 返回值 [#返回值-18]

- 0：方法调用成功。
- &lt; 0：方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。

### 所属接口类 [#所属接口类-18]

- [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/ios/rtc-interface-class#class_irtcengine)

<a id="api_irtcengine_switchcamera"></a>

<a id="ariaid-title21"></a>

## switchCamera [#switchcamera]

切换前后摄像头。

<a id="api_irtcengine_switchcamera__prototype"></a>

```objc
- (int)switchCamera NS_SWIFT_NAME(switchCamera());
```

<a id="api_irtcengine_switchcamera__detailed_desc"></a>

你可以调用此方法，根据应用运行时实际可用的摄像头动态切换前后摄像头，无需重新启动视频流或重新配置视频源。

:::note
注： 此方法仅切换由第一个摄像头采集的视频流的摄像头，即调用 [startCameraCapture\:config:](/zh-CN/api-reference/rtc/ios/video/camera-capture#api_irtcengine_startcameracapture) 时视频源设置为 `AgoraVideoSourceTypeCamera`（0）的视频流。
:::

<a id="api_irtcengine_switchcamera__timing"></a>

### 调用时机 [#调用时机-3]

必须在摄像头成功启用后调用，即 SDK 触发 [rtcEngine\:localVideoStateChangedOfState\:reason\:sourceType:](/zh-CN/api-reference/rtc/ios/video/video-basic#callback_irtcengineeventhandler_onlocalvideostatechanged) 回调并返回本地视频状态为 `AgoraVideoLocalStateCapturing`（1）之后。

<a id="api_irtcengine_switchcamera__return_values"></a>

### 返回值 [#返回值-19]

- 0：方法调用成功。
- &lt; 0：方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。

### 所属接口类 [#所属接口类-19]

- [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/ios/rtc-interface-class#class_irtcengine)

<a id="callback_irtcengineeventhandler_oncameraexposureareachanged"></a>

<a id="ariaid-title22"></a>

## rtcEngine\:cameraExposureDidChangedToRect: [#rtcenginecameraexposuredidchangedtorect]

摄像头曝光区域发生变化回调。

<a id="callback_irtcengineeventhandler_oncameraexposureareachanged__prototype"></a>

```objc
- (void)rtcEngine:(AgoraRtcEngineKit* _Nonnull)engine cameraExposureDidChangedToRect:(CGRect)rect NS_SWIFT_NAME(rtcEngine(_:cameraExposureDidChangedTo:));
```

<a id="callback_irtcengineeventhandler_oncameraexposureareachanged__detailed_desc"></a>

当你调用 [setCameraExposurePosition:](/zh-CN/api-reference/rtc/ios/device-management/video-device#api_irtcengine_setcameraexposureposition) 方法更改摄像头曝光位置时，SDK 会触发该回调。

<a id="callback_irtcengineeventhandler_oncameraexposureareachanged__timing"></a>

### 触发时机 [#触发时机]

该回调在你调用 [setCameraExposurePosition:](/zh-CN/api-reference/rtc/ios/device-management/video-device#api_irtcengine_setcameraexposureposition) 更改摄像头曝光位置时被触发。

<a id="callback_irtcengineeventhandler_oncameraexposureareachanged__parameters"></a>

### 参数 [#参数-9]

<ParameterList>
<a id="engine"></a>
<Parameter name="engine">

[AgoraRtcEngineKit](/zh-CN/api-reference/rtc/ios/rtc-interface-class#class_irtcengine) 对象，详见 [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/ios/rtc-interface-class#class_irtcengine)。

</Parameter>
<a id="rect"></a>
<Parameter name="rect">

本地预览中的曝光矩形区域。

</Parameter>
</ParameterList>

### 所属接口类 [#所属接口类-20]

- [AgoraRtcEngineDelegate](/zh-CN/api-reference/rtc/ios/rtc-interface-class#class_irtcengineeventhandler)

<a id="callback_irtcengineeventhandler_oncamerafocusareachanged"></a>

<a id="ariaid-title23"></a>

## rtcEngine\:cameraFocusDidChangedToRect: [#rtcenginecamerafocusdidchangedtorect]

摄像头对焦区域发生变化时的回调。

<a id="callback_irtcengineeventhandler_oncamerafocusareachanged__prototype"></a>

```objc
- (void)rtcEngine:(AgoraRtcEngineKit * _Nonnull)engine cameraFocusDidChangedToRect:(CGRect)rect NS_SWIFT_NAME(rtcEngine(_:cameraFocusDidChangedTo:));
```

<a id="callback_irtcengineeventhandler_oncamerafocusareachanged__detailed_desc"></a>

调用 [setCameraFocusPositionInPreview:](/zh-CN/api-reference/rtc/ios/device-management/video-device#api_irtcengine_setcamerafocuspositioninpreview) 方法更改摄像头对焦位置时，SDK 会触发该回调。

<a id="callback_irtcengineeventhandler_oncamerafocusareachanged__timing"></a>

### 触发时机 [#触发时机-1]

该回调在你调用 [setCameraFocusPositionInPreview:](/zh-CN/api-reference/rtc/ios/device-management/video-device#api_irtcengine_setcamerafocuspositioninpreview) 更改摄像头对焦位置时被触发。

<a id="callback_irtcengineeventhandler_oncamerafocusareachanged__parameters"></a>

### 参数 [#参数-10]

<ParameterList>
<a id="rect-1"></a>
<Parameter name="rect">

本地预览画面中的对焦矩形区域。

</Parameter>
<a id="engine-1"></a>
<Parameter name="engine">

[AgoraRtcEngineKit](/zh-CN/api-reference/rtc/ios/rtc-interface-class#class_irtcengine) 对象，详见 [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/ios/rtc-interface-class#class_irtcengine)。

</Parameter>
</ParameterList>

### 所属接口类 [#所属接口类-21]

- [AgoraRtcEngineDelegate](/zh-CN/api-reference/rtc/ios/rtc-interface-class#class_irtcengineeventhandler)

<a id="callback_irtcengineeventhandler_oncameraready"></a>

<a id="ariaid-title24"></a>

## rtcEngineCameraDidReady: [#rtcenginecameradidready]

摄像头准备就绪回调。

<a id="callback_irtcengineeventhandler_oncameraready__prototype"></a>

```objc
- (void)rtcEngineCameraDidReady:(AgoraRtcEngineKit * _Nonnull)engine NS_SWIFT_NAME(rtcEngineCameraDidReady(_:)) __deprecated_msg("Use rtcEngine:localVideoStateChangedOfState:reason:sourceType: instead");
```

<a id="callback_irtcengineeventhandler_oncameraready__detailed_desc"></a>

<a id="废弃"></a>

:::error[废弃]
该方法已废弃，请改用 [rtcEngine\:localVideoStateChangedOfState\:reason\:sourceType:](/zh-CN/api-reference/rtc/ios/video/video-basic#callback_irtcengineeventhandler_onlocalvideostatechanged)。
:::

<a id="callback_irtcengineeventhandler_oncameraready__timing"></a>

### 触发时机 [#触发时机-2]

该回调在摄像头成功打开并准备好采集视频时触发。

<a id="callback_irtcengineeventhandler_oncameraready__parameters"></a>

### 参数 [#参数-11]

<ParameterList>
<a id="engine-2"></a>
<Parameter name="engine">

[AgoraRtcEngineKit](/zh-CN/api-reference/rtc/ios/rtc-interface-class#class_irtcengine) 对象。详见 [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/ios/rtc-interface-class#class_irtcengine)。

</Parameter>
</ParameterList>

### 所属接口类 [#所属接口类-22]

- [AgoraRtcEngineDelegate](/zh-CN/api-reference/rtc/ios/rtc-interface-class#class_irtcengineeventhandler)