明暗校正

美术教学场景下，明暗校正可以在不改变摄像头的前提下明显改善不同光照效果下的视觉观感，提升对于真实画面的还原度。

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

前提条件

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

• 你已经集成了声网 RTC 教育特殊版 SDK 并实现了基本的音视频功能。详见快速开始。

• 在调用 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 使用信息。