视频增强
setBeautyEffectOptions:options:
设置美颜效果选项。
Objective-C
- (int)setBeautyEffectOptions:(BOOL)enable options:(AgoraBeautyOptions* _Nullable)options;
开启本地美颜功能，并设置美颜效果选项。
调用时机
请在 enableVideo 或 startPreview: 之后调用该方法。
调用限制
- 该方法依赖于视频增强动态库
AgoraClearVisionExtension.xcframework，如果删除该动态库会导致无法正常开启该功能。 - 该功能对设备性能要求较高，调用该方法时 SDK 会自动对当前设备能力进行检查。
参数
- enable
- 是否开启美颜功能：
YES: 开启美颜功能。NO:（默认）关闭美颜功能。
- options
- 美颜选项，详细定义见 AgoraBeautyOptions。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。详见错误码了解详情和解决建议。
- -4：当前设备不支持该功能，可能的原因有：
- 当前设备能力不满足美颜的使用要求，建议更换性能更高的设备。
- -4：当前设备不支持该功能，可能的原因有：
setBeautyEffectOptions:options:sourceType:
设置美颜效果选项并指定媒体源。
Objective-C
- (int)setBeautyEffectOptions:(BOOL)enable options:(AgoraBeautyOptions* _Nullable)options sourceType:(AgoraMediaSourceType)sourceType NS_SWIFT_NAME(setBeautyEffectOptions(_:options:sourceType:));
开启本地美颜功能，并设置美颜效果选项和效果应用的媒体源。
该方法和 setBeautyEffectOptions:options: 均可用于设置美颜效果选项，区别在于该方法支持在设置美颜效果选项时指定应用美颜的媒体源。
调用时机
请在 enableVideo 或 startPreview: 之后调用该方法。
参数
- enable
- 是否开启美颜功能：
YES: 开启美颜功能。NO:（默认）关闭美颜功能。
- options
- 美颜选项，详细定义见 AgoraBeautyOptions。
- sourceType
- 应用效果的媒体源。详见 AgoraMediaSourceType。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。详见错误码了解详情和解决建议。
- -4：当前设备不支持该功能，可能的原因有：
- 当前设备能力不满足美颜的使用要求，建议更换性能更高的设备。
- -4：当前设备不支持该功能，可能的原因有：
setColorEnhanceOptions:options:
设置色彩增强功能。
Objective-C
- (int)setColorEnhanceOptions:(BOOL)enable options:(AgoraColorEnhanceOptions* _Nullable)options NS_SWIFT_NAME(setColorEnhanceOptions(_:options:));
详情
摄像头采集到的视频画面可能存在色彩失真的现象。色彩增强功能可以通过智能调节饱和度和对比度等视频特性，提升视频色彩丰富度和色彩还原度，最终使视频画面更生动。
你可以调用该方法开启色彩增强功能并设置色彩增强的效果。
注意
- 请在 enableVideo 后调用该方法。
- 色彩增强对设备性能有一定要求。开启色彩增强后，如果设备出现严重发烫等问题，建议你将色彩增强等级修改为消耗性能较少的等级或关闭色彩增强功能。
- 该方法和 setExtensionPropertyWithVendor:extension:key:value: 均可开启色彩增强功能：
- 当你使用 SDK 采集视频时，建议使用该方法（该方法只可对 SDK 采集的视频起作用）。
- 当你使用外部的视频源实现自定义视频采集，或者将外部视频源发送给 SDK 时，建议使用 setExtensionPropertyWithVendor:extension:key:value: 方法。
- 该方法依赖于视频增强动态库
AgoraClearVisionExtension.xcframework，如果删除该动态库会导致无法正常开启该功能。
参数
- enable
- 是否开启色彩增强功能：
YES：开启色彩增强功能。NO：（默认）关闭色彩增强功能。
- options
- 色彩增强选项，用于设置色彩增强的效果。详见 AgoraColorEnhanceOptions。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。详见错误码了解详情和解决建议。
setColorEnhanceOptions:options:sourceType:
设置色彩增强功能并指定媒体源。
Objective-C
- (int)setColorEnhanceOptions:(BOOL)enable options:(AgoraColorEnhanceOptions* _Nullable)options sourceType:(AgoraMediaSourceType)sourceType NS_SWIFT_NAME(setColorEnhanceOptions(_:options:sourceType:));
详情
摄像头采集到的视频画面可能存在色彩失真的现象。色彩增强功能可以通过智能调节饱和度和对比度等视频特性，提升视频色彩丰富度和色彩还原度，最终使视频画面更生动。
该方法和 setColorEnhanceOptions:options: 均可用于设置色彩增强功功能，区别在于该方法支持在设色彩增强功能时指定应用色彩增强的媒体源。
注意
- 请在 enableVideo 后调用该方法。
- 色彩增强对设备性能有一定要求。开启色彩增强后，如果设备出现严重发烫等问题，建议你将色彩增强等级修改为消耗性能较少的等级或关闭色彩增强功能。
- 该方法和 setExtensionPropertyWithVendor:extension:key:value: 均可开启色彩增强功能：
- 当你使用 SDK 采集视频时，建议使用该方法（该方法只可对 SDK 采集的视频起作用）。
- 当你使用外部的视频源实现自定义视频采集，或者将外部视频源发送给 SDK 时，建议使用 setExtensionPropertyWithVendor:extension:key:value: 方法。
- 该方法依赖于视频增强动态库
AgoraClearVisionExtension.xcframework，如果删除该动态库会导致无法正常开启该功能。
参数
- enable
- 是否开启色彩增强功能：
YES：开启色彩增强功能。NO：（默认）关闭色彩增强功能。
- options
- 色彩增强选项，用于设置色彩增强的效果。详见 AgoraColorEnhanceOptions。
- sourceType
- 应用效果的媒体源。详见 AgoraMediaSourceType。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。详见错误码了解详情和解决建议。
setLowlightEnhanceOptions:options:
设置暗光增强功能。
Objective-C
- (int)setLowlightEnhanceOptions:(BOOL)enable options:(AgoraLowlightEnhanceOptions* _Nullable)options NS_SWIFT_NAME(setLowlightEnhanceOptions(_:options:));
详情
暗光增强功能可以在光线亮度偏低（如背光、阴天、暗场景）和亮度不均匀的环境下自适应调整视频画面的亮度值，恢复或凸显图像的细节信息，最终提升视频图像的整体视觉效果。
你可以调用该方法开启暗光增强功能并设置暗光增强的效果。
注意
- 请在 enableVideo 后调用该方法。
- 暗光增强对设备性能有一定要求。开启暗光增强后，如果设备出现严重发烫等问题，建议你将暗光增强等级修改为消耗性能较少的等级或关闭暗光增强功能。
- 该方法和 setExtensionPropertyWithVendor:extension:key:value: 均可开启暗光增强功能：
- 当你使用 SDK 采集视频时，建议使用该方法（该方法只可对 SDK 采集的视频起作用）。
- 当你使用外部的视频源实现自定义视频采集，或者将外部视频源发送给 SDK 时，建议使用 setExtensionPropertyWithVendor:extension:key:value: 方法。
- 该方法依赖于视频增强动态库
AgoraClearVisionExtension.xcframework，如果删除该动态库会导致无法正常开启该功能。
参数
- enable
- 是否开启暗光增强功能：
YES: 开启暗光增强功能。NO:（默认）关闭暗光增强功能。
- options
- 暗光增强选项，用于设置暗光增强的效果。详见 AgoraLowlightEnhanceOptions。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。详见错误码了解详情和解决建议。
setLowlightEnhanceOptions:options:sourceType:
设置暗光增强功能并指定媒体源。
Objective-C
- (int)setLowlightEnhanceOptions:(BOOL)enable options:(AgoraLowlightEnhanceOptions* _Nullable)options sourceType:(AgoraMediaSourceType)sourceType NS_SWIFT_NAME(setLowlightEnhanceOptions(_:options:sourceType:));
详情
暗光增强功能可以在光线亮度偏低（如背光、阴天、暗场景）和亮度不均匀的环境下自适应调整视频画面的亮度值，恢复或凸显图像的细节信息，最终提升视频图像的整体视觉效果。
该方法和 setLowlightEnhanceOptions:options: 均可用于设置暗光增强功能，区别在于该方法支持在设置暗光增强功能时指定应用暗光增强的媒体源。
注意
- 请在 enableVideo 后调用该方法。
- 暗光增强对设备性能有一定要求。开启暗光增强后，如果设备出现严重发烫等问题，建议你将暗光增强等级修改为消耗性能较少的等级或关闭暗光增强功能。
- 该方法和 setExtensionPropertyWithVendor:extension:key:value: 均可开启暗光增强功能：
- 当你使用 SDK 采集视频时，建议使用该方法（该方法只可对 SDK 采集的视频起作用）。
- 当你使用外部的视频源实现自定义视频采集，或者将外部视频源发送给 SDK 时，建议使用 setExtensionPropertyWithVendor:extension:key:value: 方法。
- 该方法依赖于视频增强动态库
AgoraClearVisionExtension.xcframework，如果删除该动态库会导致无法正常开启该功能。
参数
- enable
- 是否开启暗光增强功能：
YES: 开启暗光增强功能。NO:（默认）关闭暗光增强功能。
- options
- 暗光增强选项，用于设置暗光增强的效果。详见 AgoraLowlightEnhanceOptions。
- sourceType
- 应用效果的媒体源。详见 AgoraMediaSourceType。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。详见错误码了解详情和解决建议。
setVideoDenoiserOptions:options:
设置视频降噪功能。
Objective-C
- (int)setVideoDenoiserOptions:(BOOL)enable options:(AgoraVideoDenoiserOptions* _Nullable)options NS_SWIFT_NAME(setVideoDenoiserOptions(_:options:));
详情
采光不足的环境和低端视频采集设备会使视频图像含有明显的噪声，影响视频画质。在实时互动场景下，视频噪声还会在编码过程中占用码流资源并降低编码效率。
你可以调用该方法开启视频降噪功能并设置视频降噪的效果。
注意
- 请在 enableVideo 后调用该方法。
- 视频降噪对设备性能有一定要求。开启视频降噪后，如果设备出现严重发烫等问题，建议你将视频降噪等级修改为消耗性能较少的等级或关闭视频降噪功能。
- 该方法和 setExtensionPropertyWithVendor:extension:key:value: 均可开启视频降噪功能：
- 当你使用 SDK 采集视频时，建议使用该方法（该方法只可对 SDK 采集的视频起作用）。
- 当你使用外部的视频源实现自定义视频采集，或者将外部视频源发送给 SDK 时，建议使用 setExtensionPropertyWithVendor:extension:key:value: 方法。
- 该方法依赖于视频增强动态库
AgoraClearVisionExtension.xcframework，如果删除该动态库会导致无法正常开启该功能。
参数
- enable
- 是否开启视频降噪功能：
YES: 开启视频降噪功能。NO:（默认）关闭视频降噪功能。
- options
- 视频降噪选项，用于设置视频降噪的效果。详见 AgoraVideoDenoiserOptions。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。详见错误码了解详情和解决建议。
setVideoDenoiserOptions:options:sourceType:
设置视频降噪功能并指定媒体源。
Objective-C
- (int)setVideoDenoiserOptions:(BOOL)enable options:(AgoraVideoDenoiserOptions* _Nullable)options sourceType:(AgoraMediaSourceType)sourceType NS_SWIFT_NAME(setVideoDenoiserOptions(_:options:sourceType:));
详情
采光不足的环境和低端视频采集设备会使视频图像含有明显的噪声，影响视频画质。在实时互动场景下，视频噪声还会在编码过程中占用码流资源并降低编码效率。
该方法和 setVideoDenoiserOptions:options: 均可用于设置视频降噪功能，区别在于该方法支持在设置视频降噪功能时指定应用视频降噪功能的媒体源。
注意
- 请在 enableVideo 后调用该方法。
- 视频降噪对设备性能有一定要求。开启视频降噪后，如果设备出现严重发烫等问题，建议你将视频降噪等级修改为消耗性能较少的等级或关闭视频降噪功能。
- 该方法和 setExtensionPropertyWithVendor:extension:key:value: 均可开启视频降噪功能：
- 当你使用 SDK 采集视频时，建议使用该方法（该方法只可对 SDK 采集的视频起作用）。
- 当你使用外部的视频源实现自定义视频采集，或者将外部视频源发送给 SDK 时，建议使用 setExtensionPropertyWithVendor:extension:key:value: 方法。
- 该方法依赖于视频增强动态库
AgoraClearVisionExtension.xcframework，如果删除该动态库会导致无法正常开启该功能。
参数
- enable
- 是否开启视频降噪功能：
YES: 开启视频降噪功能。NO:（默认）关闭视频降噪功能。
- options
- 视频降噪选项，用于设置视频降噪的效果。详见 AgoraVideoDenoiserOptions。
- sourceType
- 应用效果的媒体源。详见 AgoraMediaSourceType。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。详见错误码了解详情和解决建议。