# 明暗校正 (/zh-CN/solutions/art-class/build/brightness-correction)

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

<_PlatformTabsGroup>
<_PlatformProcessedMarker groupMode="structured" canonicalPlatform="android" platform="android" />
美术教学场景下，明暗校正可以在不改变摄像头的前提下明显改善不同光照效果下的视觉观感，提升对于真实画面的还原度。本文介绍如何使用声网提供的 API 在项目中实现明暗校正功能。

## 前提条件 [#前提条件]

开始前请确保你的项目满足如下条件：

- 你已经集成了声网 RTC 教育特殊版 SDK 并实现了基本的音视频功能。详见[快速开始](/zh-CN/realtime-media/rtc/get-started/quick-start)。
- 在调用 `enableVideo` 之前，调用 `addExtension` 和 `enableExtension` 开启美颜功能。你必须完成此步骤才能开启本地画面明暗校正或接受远程开启明暗校正请求。

  ```java
  RtcEngineConfig config = new RtcEngineConfig();
  config.addExtension("agora_video_process");

  ...

  mRtcEngine = RtcEngine.create(config);
  mRtcEngine.enableExtension("agora", "beauty", true);
  ```

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

### 教师帮助学生进行明暗校正 [#教师帮助学生进行明暗校正]

对于教师帮助学生进行明暗校正的场景，调用 `applyBrightnessCorrectionToRemote` 或 `applyBrightnessCorrectionToRemoteEx` 开启远端画面明暗校正。远端的用户需要在 `enableVideo` 前调用 `addExtension` 和 `enableExtension` 才能成功接收远程开启明暗校正请求。开启后，本地、此远端用户的本地预览、频道内的其他远端用户都能看到此远端用户明暗校正后的画面。

```java
// 开启远端画面明暗校正并设置为自动模式
mRtcEngine.applyBrightnessCorrectionToRemote(uid, true, 0);
```

如果不再需要明暗校正功能，可调用 `applyBrightnessCorrectionToRemote` 或 `applyBrightnessCorrectionToRemoteEx` 关闭远端画面明暗校正。

```java
// 关闭远端画面明暗校正
mRtcEngine.applyBrightnessCorrectionToRemote(uid, false);
```

### 学生自行进行明暗校正 [#学生自行进行明暗校正]

对于学生自行进行明暗校正的场景，调用 `enableBrightnessCorrection` 开启本地画面明暗校正。开启后，本地预览和远端都能看到本地明暗校正后的画面。

```java
// 开启本地画面明暗校正并设置为自动模式
mRtcEngine.enableBrightnessCorrection(true);
```

如果不再需要明暗校正功能，可调用 `enableBrightnessCorrection` 关闭本地画面明暗校正。

```java
// 关闭本地画面明暗校正
mRtcEngine.enableBrightnessCorrection(false);
```

## API 参考 [#api-参考]

你可以参考[在线美术教学 API 参考](/zh-CN/api-reference/online-art-teaching)了解更多 API 使用信息。
<_PlatformProcessedMarker close="true" />

<_PlatformProcessedMarker groupMode="structured" canonicalPlatform="android" platform="ios" />
美术教学场景下，明暗校正可以在不改变摄像头的前提下明显改善不同光照效果下的视觉观感，提升对于真实画面的还原度。

本文介绍如何使用声网提供的 API 在项目中实现明暗校正功能。

## 前提条件 [#前提条件-1]

开始前请确保你的项目满足如下条件：

- 你已经集成了声网 RTC 教育特殊版 SDK 并实现了基本的音视频功能。详见[快速开始](/zh-CN/realtime-media/rtc/get-started/quick-start)。
- 在调用 `enableVideo` 之前，调用 `addExtension` 和 `enableExtensionWithVendor` 开启美颜功能。你必须完成此步骤才能开启本地画面明暗校正或接受远程开启明暗校正请求。

  ```swift
  agoraKit.enableExtension(withVendor:"agora", "beauty", enabled: true)
  ```

## 实现方法 [#实现方法-1]

### 教师帮助学生进行明暗校正 [#教师帮助学生进行明暗校正-1]

对于教师帮助学生进行明暗校正的场景，调用 `applyBrightnessCorrectionToRemote` 或 `applyBrightnessCorrectionToRemoteEx` 开启远端画面明暗校正。远端用户需要在 `enableVideo` 前调用 `enableExtensionWithVendor`，才能成功接收远程开启明暗校正请求。开启后，本地、该远端用户的本地预览和频道内的其他远端用户都能看到该远端用户明暗校正后的画面。

```swift
// 开启远端画面明暗校正并设置为自动模式
agoraKit.applyBrightnessCorrectionToRemote(uid, true, 0)
```

如果不再需要明暗校正功能，可调用 `applyBrightnessCorrectionToRemote` 或 `applyBrightnessCorrectionToRemoteEx` 关闭远端画面明暗校正。

```swift
// 关闭远端画面明暗校正
agoraKit.applyBrightnessCorrectionToRemote(uid, false)
```

### 学生自行进行明暗校正 [#学生自行进行明暗校正-1]

对于学生自行进行明暗校正的场景，调用 `enableBrightnessCorrection` 开启本地画面明暗校正。开启后，本地预览和远端都能看到本地明暗校正后的画面。

```swift
// 开启本地画面明暗校正并设置为自动模式
agoraKit.enableBrightnessCorrection(true)
```

如果不再需要明暗校正功能，可调用 `enableBrightnessCorrection` 关闭本地画面明暗校正。

```swift
// 关闭本地画面明暗校正
agoraKit.enableBrightnessCorrection(false)
```

## API 参考 [#api-参考-1]

你可以参考[在线美术教学 API 参考](/zh-CN/api-reference/online-art-teaching)了解更多 API 使用信息。
<_PlatformProcessedMarker close="true" />

<_PlatformProcessedMarker groupMode="structured" canonicalPlatform="android" platform="macos" />
美术教学场景下，明暗校正可以在不改变摄像头的前提下明显改善不同光照效果下的视觉观感，提升对于真实画面的还原度。

本文介绍如何使用声网提供的 API 在项目中实现明暗校正功能。

## 前提条件 [#前提条件-2]

开始前请确保你的项目满足如下条件：

- 你已经集成了声网 RTC 教育特殊版 SDK 并实现了基本的音视频功能。详见[快速开始](/zh-CN/realtime-media/rtc/get-started/quick-start)。
- 在调用 `enableVideo` 之前，调用 `addExtension` 和 `enableExtensionWithVendor` 开启美颜功能。你必须完成此步骤才能开启本地画面明暗校正或接受远程开启明暗校正请求。

  ```swift
  agoraKit.enableExtension(withVendor:"agora", "beauty", enabled: true)
  ```

## 实现方法 [#实现方法-2]

### 教师帮助学生进行明暗校正 [#教师帮助学生进行明暗校正-2]

对于教师帮助学生进行明暗校正的场景，调用 `applyBrightnessCorrectionToRemote` 或 `applyBrightnessCorrectionToRemoteEx` 开启远端画面明暗校正。远端用户需要在 `enableVideo` 前调用 `enableExtensionWithVendor`，才能成功接收远程开启明暗校正请求。开启后，本地、该远端用户的本地预览和频道内的其他远端用户都能看到该远端用户明暗校正后的画面。

```swift
// 开启远端画面明暗校正并设置为自动模式
agoraKit.applyBrightnessCorrectionToRemote(uid, true, 0)
```

如果不再需要明暗校正功能，可调用 `applyBrightnessCorrectionToRemote` 或 `applyBrightnessCorrectionToRemoteEx` 关闭远端画面明暗校正。

```swift
// 关闭远端画面明暗校正
agoraKit.applyBrightnessCorrectionToRemote(uid, false)
```

### 学生自行进行明暗校正 [#学生自行进行明暗校正-2]

对于学生自行进行明暗校正的场景，调用 `enableBrightnessCorrection` 开启本地画面明暗校正。开启后，本地预览和远端都能看到本地明暗校正后的画面。

```swift
// 开启本地画面明暗校正并设置为自动模式
agoraKit.enableBrightnessCorrection(true)
```

如果不再需要明暗校正功能，可调用 `enableBrightnessCorrection` 关闭本地画面明暗校正。

```swift
// 关闭本地画面明暗校正
agoraKit.enableBrightnessCorrection(false)
```

## API 参考 [#api-参考-2]

你可以参考[在线美术教学 API 参考](/zh-CN/api-reference/online-art-teaching)了解更多 API 使用信息。
<_PlatformProcessedMarker close="true" />

<_PlatformProcessedMarker groupMode="structured" canonicalPlatform="android" platform="windows" />
美术教学场景下，明暗校正可以在不改变摄像头的前提下明显改善不同光照效果下的视觉观感，提升对于真实画面的还原度。

本文介绍如何使用声网提供的 API 在项目中实现明暗校正功能。

## 前提条件 [#前提条件-3]

开始前请确保你的项目满足如下条件：

- 你已经集成了声网 RTC 教育特殊版 SDK 并实现了基本的音视频功能。详见[快速开始](/zh-CN/realtime-media/rtc/get-started/quick-start)。
- 在调用 `enableVideo` 之前，调用 `addExtension` 和 `enableExtension` 开启美颜功能。你必须完成此步骤才能开启本地画面明暗校正或接受远程开启明暗校正请求。

  ```cpp
  m_lpAgoraEngine->loadExtensionProvider("libagora_video_process.dll");
  m_lpAgoraEngine->enableExtension("agora", "beauty", true);
  ```

## 实现方法 [#实现方法-3]

### 教师帮助学生进行明暗校正 [#教师帮助学生进行明暗校正-3]

对于教师帮助学生进行明暗校正的场景，调用 `applyBrightnessCorrectionToRemote` 或 `applyBrightnessCorrectionToRemoteEx` 开启远端画面明暗校正。远端的用户需要在 `enableVideo` 前调用 `addExtension` 和 `enableExtension` 才能成功接收远程开启明暗校正请求。开启后，本地、此远端用户的本地预览、频道内的其他远端用户都能看到此远端用户明暗校正后的画面。

```cpp
// 开启远端画面明暗校正并设置为自动模式
m_lpAgoraEngine->applyBrightnessCorrectionToRemote(uid, true, 0);
```

如果不再需要明暗校正功能，可调用 `applyBrightnessCorrectionToRemote` 或 `applyBrightnessCorrectionToRemoteEx` 关闭远端画面明暗校正。

```cpp
// 关闭远端画面明暗校正
m_lpAgoraEngine->applyBrightnessCorrectionToRemote(uid, false);
```

### 学生自行进行明暗校正 [#学生自行进行明暗校正-3]

对于学生自行进行明暗校正的场景，调用 `enableBrightnessCorrection` 开启本地画面明暗校正。开启后，本地预览和远端都能看到本地明暗校正后的画面。

```cpp
// 开启本地画面明暗校正并设置为自动模式
m_lpAgoraEngine->enableBrightnessCorrection(true);
```

如果不再需要明暗校正功能，可调用 `enableBrightnessCorrection` 关闭本地画面明暗校正。

```cpp
// 关闭本地画面明暗校正
m_lpAgoraEngine->enableBrightnessCorrection(false);
```

## API 参考 [#api-参考-3]

你可以参考[在线美术教学 API 参考](/zh-CN/api-reference/online-art-teaching)了解更多 API 使用信息。
<_PlatformProcessedMarker close="true" />
</_PlatformTabsGroup>