视频增强

setBeautyEffectOptions

设置美颜效果选项。

Objective-C

- (int)setBeautyEffectOptions:(BOOL)enable options:(AgoraBeautyOptions* _Nullable)options;

开启本地美颜功能，并设置美颜效果选项。

注：

• 请在 enableVideo 或 startPreview [2/2] 之后调用该方法。

• 该方法依赖于视频增强动态库 AgoraClearVisionExtension.xcframework，如果删除该动态库会导致无法正常开启该功能。

参数

参数名	描述
enable	是否开启美颜功能： YES: 开启美颜功能。 NO:（默认）关闭美颜功能。
options	美颜选项，详细定义见 AgoraBeautyOptions。

返回值

• 0: 方法调用成功。

• < 0: 方法调用失败。

所属接口类

• AgoraRtcEngineKit

setColorEnhanceOptions

设置色彩增强功能。

Objective-C

- (int)setColorEnhanceOptions:(BOOL)enable options:(AgoraColorEnhanceOptions* _Nullable)options NS_SWIFT_NAME(setColorEnhanceOptions(_:options:));

摄像头采集到的视频画面可能存在色彩失真的现象。色彩增强功能可以通过智能调节饱和度和对比度等视频特性，提升视频色彩丰富度和色彩还原度，最终使视频画面更生动。

你可以调用该方法开启色彩增强功能并设置色彩增强的效果。

注意：

• 请在 enableVideo 后调用该方法。

• 色彩增强对设备性能有一定要求。开启色彩增强后，如果设备出现严重发烫等问题，建议你将色彩增强等级修改为消耗性能较少的等级或关闭色彩增强功能。

• 该方法和 setExtensionPropertyWithVendor 均可开启色彩增强功能：

  • 当你使用 SDK 采集视频时，建议使用该方法（该方法只可对 SDK 采集的视频起作用）。

  • 当你使用外部的视频源实现自定义视频采集，或者将外部视频源发送给 SDK 时，建议使用 setExtensionPropertyWithVendor 方法。

• 该方法依赖于视频增强动态库 AgoraClearVisionExtension.xcframework，如果删除该动态库会导致无法正常开启该功能。

参数

参数名	描述
enable	是否开启色彩增强功能： YES：开启色彩增强功能。 NO：（默认）关闭色彩增强功能。
options	色彩增强选项，用于设置色彩增强的效果。详见 AgoraColorEnhanceOptions。

返回值

• 0: 方法调用成功。

• < 0: 方法调用失败。详见错误码了解详情和解决建议。

所属接口类

• AgoraRtcEngineKit

setLowlightEnhanceOptions

设置暗光增强功能。

Objective-C

- (int)setLowlightEnhanceOptions:(BOOL)enable options:(AgoraLowlightEnhanceOptions* _Nullable)options NS_SWIFT_NAME(setLowlightEnhanceOptions(_:options:));

暗光增强功能可以在光线亮度偏低（如背光、阴天、暗场景）和亮度不均匀的环境下自适应调整视频画面的亮度值，恢复或凸显图像的细节信息，最终提升视频图像的整体视觉效果。

你可以调用该方法开启暗光增强功能并设置暗光增强的效果。

注意：

• 请在 enableVideo 后调用该方法。

• 暗光增强对设备性能有一定要求。开启暗光增强后，如果设备出现严重发烫等问题，建议你将暗光增强等级修改为消耗性能较少的等级或关闭暗光增强功能。

• 该方法和 setExtensionPropertyWithVendor 均可开启暗光增强功能：

  • 当你使用 SDK 采集视频时，建议使用该方法（该方法只可对 SDK 采集的视频起作用）。

  • 当你使用外部的视频源实现自定义视频采集，或者将外部视频源发送给 SDK 时，建议使用 setExtensionPropertyWithVendor 方法。

• 该方法依赖于视频增强动态库 AgoraClearVisionExtension.xcframework，如果删除该动态库会导致无法正常开启该功能。

参数

参数名	描述
enable	是否开启暗光增强功能： YES: 开启暗光增强功能。 NO:（默认）关闭暗光增强功能。
options	暗光增强选项，用于设置暗光增强的效果。详见 AgoraLowlightEnhanceOptions。

返回值

• 0: 方法调用成功。

• < 0: 方法调用失败。详见错误码了解详情和解决建议。

所属接口类

• AgoraRtcEngineKit

setVideoDenoiserOptions

设置视频降噪功能。

Objective-C

- (int)setVideoDenoiserOptions:(BOOL)enable options:(AgoraVideoDenoiserOptions* _Nullable)options NS_SWIFT_NAME(setVideoDenoiserOptions(_:options:));

采光不足的环境和低端视频采集设备会使视频图像含有明显的噪声，影响视频画质。在实时互动场景下，视频噪声还会在编码过程中占用码流资源并降低编码效率。

你可以调用该方法开启视频降噪功能并设置视频降噪的效果。

注意：

• 请在 enableVideo 后调用该方法。

• 视频降噪对设备性能有一定要求。开启视频降噪后，如果设备出现严重发烫等问题，建议你将视频降噪等级修改为消耗性能较少的等级或关闭视频降噪功能。

• 该方法和 setExtensionPropertyWithVendor 均可开启视频降噪功能：

  • 当你使用 SDK 采集视频时，建议使用该方法（该方法只可对 SDK 采集的视频起作用）。

  • 当你使用外部的视频源实现自定义视频采集，或者将外部视频源发送给 SDK 时，建议使用 setExtensionPropertyWithVendor 方法。

• 该方法依赖于视频增强动态库 AgoraClearVisionExtension.xcframework，如果删除该动态库会导致无法正常开启该功能。

参数

参数名	描述
enable	是否开启视频降噪功能： YES: 开启视频降噪功能。 NO:（默认）关闭视频降噪功能。
options	视频降噪选项，用于设置视频降噪的效果。详见 AgoraVideoDenoiserOptions。

返回值

• 0: 方法调用成功。

• < 0: 方法调用失败。详见错误码了解详情和解决建议。

所属接口类

• AgoraRtcEngineKit