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