声网提供明暗校正 API,在不改变摄像头的前提下明显改善不同光照效果下的视觉观感,提升对于真实画面的还原度。
你已经集成了声网 RTC v4.0.0 教育特殊版 SDK 并实现了基本的音视频功能。详见快速开始。
在调用 enableVideo
之前,调用 loadExtensionProvider
和 enableExtension
开启美颜功能。你必须完成此步骤才能开启本地画面明暗校正或接受远程开启明暗校正请求。
m_lpAgoraEngine->loadExtensionProvider("libagora_video_process.dll");
m_lpAgoraEngine->enableExtension("agora", "beauty", true);
对于教师帮助学生进行明暗校正的场景,调用 applyBrightnessCorrectionToRemote
或 applyBrightnessCorrectionToRemoteEx
开启远端画面明暗校正。远端的 uid 需要在 enableVideo
前调用 loadExtensionProvider
和 enableExtension
才能成功接收远程开启明暗校正请求。开启后,本地、此远端 uid 的本地预览、频道内的其他远端 uid 都能看到此远端 uid 明暗校正后的画面。
// 开启远端画面明暗校正并设置为自动模式
m_lpAgoraEngine->applyBrightnessCorrectionToRemote(uid, true, 0);
如果不再需要明暗校正功能,可调用 applyBrightnessCorrectionToRemote
或 applyBrightnessCorrectionToRemoteEx
关闭远端画面明暗校正。
// 关闭远端画面明暗校正
m_lpAgoraEngine->applyBrightnessCorrectionToRemote(uid, false);
对于学生自行进行明暗校正的场景,调用 enableBrightnessCorrection
开启本地画面明暗校正。开启后,本地预览和远端都能看到本地明暗校正后的画面。
// 开启本地画面明暗校正并设置为自动模式
m_lpAgoraEngine->enableBrightnessCorrection(true);
如果不再需要明暗校正功能,可调用 enableBrightnessCorrection
关闭本地画面明暗校正。
// 关闭本地画面明暗校正
m_lpAgoraEngine->enableBrightnessCorrection(false);
virtual int enableBrightnessCorrection(bool enabled, BRIGHTNESS_CORRECTION_MODE mode, VIDEO_SOURCE_TYPE sourceType = VIDEO_SOURCE_CAMERA_PRIMARY) = 0;
开启或关闭本地画面明暗校正。
参数 | 说明 |
---|---|
enabled | 是否开启本地明暗校正。
|
mode | 设置明暗校正模式。
|
sourceType | 视频源类型。
|
virtual int applyBrightnessCorrectionToRemote(uid_t uid, bool enabled, BRIGHTNESS_CORRECTION_MODE mode) = 0;
开启远端 uid 画面的明暗校正。远端的 uid 需要在 enableVideo
前先调用 loadExtensionProvider
和 enableExtension
才能成功接收远程开启明暗校正请求。
参数 | 说明 |
---|---|
uid | 需要开启明暗校正的远端 uid。 |
enabled | 是否开启本地明暗校正。
|
mode | 设置明暗校正模式。
|
virtual int applyBrightnessCorrectionToRemoteEx(uid_t uid, bool enabled, BRIGHTNESS_CORRECTION_MODE mode, const RtcConnection& connection) = 0;
(适用于多频道)开启对应 connection 的远端 uid 画面的明暗校正。远端的 uid 需要在 enableVideo
前先调用 loadExtensionProvider
和 enableExtension
才能成功接收远程开启明暗校正请求。
参数 | 说明 |
---|---|
uid | 需要开启明暗校正的远端 uid。 |
enabled | 是否开启本地明暗校正。
|
mode | 设置明暗校正模式。
|
connection | Connection 信息。详见 RtcConnection。 |