# 如何实现摄像头曝光和对焦？ (/zh-CN/reference/faq/integration/camera_exposure_focus)

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

视频场景中，经常会使用到摄像头曝光和对焦的功能，帮助被拍摄物成像清晰、亮度适宜。

声网 RTC SDK 在移动平台提供整套的摄像头管理方法，方便用户切换前后摄像头，并对摄像头的缩放、对焦和曝光进行设置。

- 曝光：支持手动选择曝光区域，摄像头自动曝光。
- 对焦：支持人脸自动对焦和手动对焦。

## 实现方法 [#实现方法]

:::warning[注意]
在实现摄像头曝光和对焦功能前，请确保已在你的项目中实现基本的实时音视频功能。
:::

参考如下步骤，在你的项目中实现摄像头曝光和对焦功能。

- **实现曝光功能**

  调用 `isCameraExposurePositionSupported` 方法检测设备是否支持曝光，如果支持则调用 `setCameraExposurePosition` 方法设置手动曝光位置。

  如果你想获取摄像头曝光位置，可以在 `onCameraExposureAreaChanged` 回调中实现。

- **实现人脸自动对焦功能**

  调用 `isCameraAutoFocusFaceModeSupported` 方法检测设备是否支持人脸对焦功能，如果支持则调用 `setCameraAutoFocusModeEnabled` 方法设置开启该功能。

- **实现手动对焦功能**

  调用 `isCameraFocusSupported` 方法检测设备是否支持手动对焦功能，如果支持则调用 `setCameraFocusPositionInPreview` 方法设置手动对焦位置并触发对焦。

  如果你想获取摄像头对焦位置，可以在 `onCameraFocusAreaChanged` 回调中实现。

### 示例代码 [#示例代码]

```java tab="Java" tabGroup="sample-code"
// 测当前设备是否支持曝光并手动设置曝光区域。
boolean shouldSetExposure = rtcEngine.isCameraExposurePositionSupported();
if (shouldSetExposure) {
    // 假设在屏幕(50，100)的位置曝光。
    float positionX = 50.0f;
    float positionY = 100.0f;
    rtcEngine.setCameraExposurePosition(positionX, positionY);
}

// 检测当前设备是否支持人脸自动对焦并设置。
boolean shouldSetFaceMode = rtcEngine.isCameraAutoFocusFaceModeSupported();
rtcEngine.setCameraAutoFocusFaceModeEnabled(shouldSetFaceMode);

// 检测当前设备是否支持手动对焦并设置。
boolean shouldManualFocus = rtcEngine.isCameraFocusSupported();
if (shouldManualFocus) {
    // 假设在屏幕(50，100)的位置对焦。
    float positionX = 50.0f;
    float positionY = 100.0f;
    rtcEngine.setCameraFocusPositionInPreview(positionX, positionY);
}

// 曝光区域更新。你可以在这里监听到曝光更新事件，并进行自己的逻辑处理。
public void onCameraExposureAreaChanged(rect) {
}

// 对焦区域更新。你可以在这里监听到焦点更新事件，并进行自己的逻辑处理。
public void onCameraFocusAreaChanged(rect) {
}
```

```swift tab="Swift" tabGroup="sample-code"
// 测当前设备是否支持曝光并手动设置曝光区域
let isSupported = agoraKit.isCameraExposurePositionSupported()

if isSupported {
    // 假设在屏幕(50，100)的位置曝光
    let point = CGPoint(x: 50, y: 100)
    agoraKit.setCameraExposurePosition(point)
}

// 检测当前设备是否支持人脸自动对焦并设置
let isSupported = agoraKit.isCameraAutoFocusFaceModeSupported()
agoraKit.setCameraAutoFocusFaceModeEnabled(isSupported)

// 检测当前设备是否支持手动对焦功能并设置
let isSupported = agoraKit.isCameraFocusPositionInPreviewSupported()

if isSupported {
    // 假设在屏幕（50，100）的位置对焦
    let point = CGPoint(x: 50, y: 100)
    agoraKit.setCameraFocusPositionInPreview(point)
}

// 曝光区域更新。你可以在这里监听到曝光更新事件，并进行自己的逻辑处理
func rtcEngine(_ engine: AgoraRtcEngineKit, cameraExposureDidChangedToRect: CGRect) {
}

// 对焦区域更新。你可以在这里监听到焦点更新事件，并进行自己的逻辑处理
func rtcEngine(_ engine: AgoraRtcEngineKit, cameraFocusDidChangedToRect: CGRect) {
}
```

```objc tab="Objective-C" tabGroup="sample-code"
// 检测当前设备是否支持曝光并手动设置曝光区域
BOOL isSupported = [agoraKit isCameraExposurePositionSupported];

if (isSupported) {
    // 假设在屏幕(50，100)的位置曝光
    CGPoint point = CGPointMake(50, 100);
    [agoraKit setCameraExposurePosition:point];
}

// 检测当前设备是否支持人脸自动对焦并设置
isSupported = [agoraKit isCameraAutoFocusFaceModeSupported];
[agoraKit setCameraAutoFocusFaceModeEnabled:isSupported];

// 检测当前设备是否支持手动对焦功能并设置
isSupported = [agoraKit isCameraFocusPositionInPreviewSupported];

if (isSupported) {
    // 假设在屏幕（50，100）的位置对焦
    CGPoint point = CGPointMake(50, 100);
    [agoraKit setCameraFocusPositionInPreview:point];
}

// 曝光区域更新。你可以在这里监听到曝光更新事件，并进行自己的逻辑处理
- (void)rtcEngine:(AgoraRtcEngineKit *)engine cameraExposureDidChangedToRect:(CGRect)rect {
    // 在这里处理曝光更新
}

// 对焦区域更新。你可以在这里监听到焦点更新事件，并进行自己的逻辑处理
- (void)rtcEngine:(AgoraRtcEngineKit *)engine cameraFocusDidChangedToRect:(CGRect)rect {
    // 在这里处理对焦更新
}
```