视频增强
getFaceShapeAreaOptions [1/2]
获取美型部位选项。
Java
public abstract FaceShapeAreaOptions getFaceShapeAreaOptions(
int shapeArea, Constants.MediaSourceType sourceType);
自从
v4.5.0
调用该方法可以获取美型部位当前设置的参数信息。
适用场景
用户在 App 中打开美型部位和修饰力度菜单时，你可以调用该方法获取当前的美型部位选项，然后根据结果刷新用户界面中的菜单，并更新 UI。
调用时机
请在 enableVideo 之后调用该方法。
调用限制
无。
参数
- shapeArea
- 美型部位：
- FACE_SHAPE_AREA_NONE (-1)：（默认）无效部位，美型不生效。
- FACE_SHAPE_AREA_HEADSCALE (0)：头部，用于实现小头效果。对应修饰力度范围为 [0,100]，值越大头越小，预设值为 100。
- FACE_SHAPE_AREA_FOREHEAD (1)：额头，修饰发际线高度。对应修饰力度范围为 [-100,100]，正值为调高，负值为调低，绝对值越大修饰效果越强，预设值为 50。
- FACE_SHAPE_AREA_FACECONTOUR (2)：脸部轮廓，用于实现瘦脸效果。对应修饰力度范围为 [0,100]，值越大瘦脸效果越强，预设值为 10。
- FACE_SHAPE_AREA_FACELENGTH (3)：脸部长度，用于实现长脸效果。对应修饰力度范围为 [-100,100]，正值为拉长，负值为变短，绝对值越大修饰效果越强，预设值为 0。
- FACE_SHAPE_AREA_FACEWIDTH (4)：脸部宽度，用于实现窄脸效果。对应修饰力度范围为 [0,100]，值越大窄脸效果越强，预设值为 10。
- FACE_SHAPE_AREA_CHEEKBONE (5)：颧骨，修饰颧骨宽度。对应修饰力度范围为 [0,100]，值越大颧骨越窄，预设值为 43。
- FACE_SHAPE_AREA_CHEEK (6)：脸颊，修饰脸颊宽度。对应修饰力度范围为 [0,100]，值越大脸颊越窄，预设值为 50。
- FACE_SHAPE_AREA_CHIN (7)：下巴，修饰下巴长度。对应修饰力度范围为 [-100,100]，正值为拉长，负值为变短，绝对值越大修饰效果越强，预设值为 -20。
- FACE_SHAPE_AREA_EYESCALE (8)：眼睛，用于实现大眼效果。对应修饰力度范围为 [0,100]，值越大，眼睛越大，预设值为 53。
- FACE_SHAPE_AREA_NOSELENGTH (9)：鼻子长度，用于实现长鼻效果。对应修饰力度范围为 [-100,100]，正值为拉长，负值为变短，绝对值越大修饰效果越强，预设值为 -10。
- FACE_SHAPE_AREA_NOSEWIDTH (10)：鼻子宽度，用于实现瘦鼻效果。对应修饰力度范围为 [-100,100]，正值为变宽，负值为变窄，绝对值越大修饰效果越强，预设值为 72。
- FACE_SHAPE_AREA_MOUTHSCALE (11)：嘴巴，修饰嘴巴大小。对应修饰力度范围为 [-100,100]，正值为变大，负值为变小，绝对值越大修饰效果越强，预设值为 20。
- sourceType
- 效果应用的媒体源类型。详见 MediaSourceType。注意在该方法中，该参数仅支持以下两种设置：
- 使用摄像头采集本地视频时，请保持默认值 PRIMARY_CAMERA_SOURCE。
- 如果要使用自定义采集的视频，将该参数设置为 CUSTOM_VIDEO_SOURCE。
返回值
- 方法调用成功，返回 FaceShapeAreaOptions 对象。
- 方法调用失败，返回 NULL。
getFaceShapeAreaOptions [2/2]
获取美型部位选项。
Java
public abstract FaceShapeAreaOptions getFaceShapeAreaOptions(int shapeArea);
自从
v4.5.0
调用该方法可以获取美型部位当前设置的参数信息。
适用场景
用户在 App 中打开美型部位和修饰力度菜单时，你可以调用该方法获取当前的美型部位选项，然后根据结果刷新用户界面中的菜单，并更新 UI。
调用时机
请在 enableVideo 之后调用该方法。
调用限制
无。
参数
- shapeArea
- 美型部位：
- FACE_SHAPE_AREA_NONE (-1)：（默认）无效部位，美型不生效。
- FACE_SHAPE_AREA_HEADSCALE (0)：头部，用于实现小头效果。对应修饰力度范围为 [0,100]，值越大头越小，预设值为 100。
- FACE_SHAPE_AREA_FOREHEAD (1)：额头，修饰发际线高度。对应修饰力度范围为 [-100,100]，正值为调高，负值为调低，绝对值越大修饰效果越强，预设值为 50。
- FACE_SHAPE_AREA_FACECONTOUR (2)：脸部轮廓，用于实现瘦脸效果。对应修饰力度范围为 [0,100]，值越大瘦脸效果越强，预设值为 10。
- FACE_SHAPE_AREA_FACELENGTH (3)：脸部长度，用于实现长脸效果。对应修饰力度范围为 [-100,100]，正值为拉长，负值为变短，绝对值越大修饰效果越强，预设值为 0。
- FACE_SHAPE_AREA_FACEWIDTH (4)：脸部宽度，用于实现窄脸效果。对应修饰力度范围为 [0,100]，值越大窄脸效果越强，预设值为 10。
- FACE_SHAPE_AREA_CHEEKBONE (5)：颧骨，修饰颧骨宽度。对应修饰力度范围为 [0,100]，值越大颧骨越窄，预设值为 43。
- FACE_SHAPE_AREA_CHEEK (6)：脸颊，修饰脸颊宽度。对应修饰力度范围为 [0,100]，值越大脸颊越窄，预设值为 50。
- FACE_SHAPE_AREA_CHIN (7)：下巴，修饰下巴长度。对应修饰力度范围为 [-100,100]，正值为拉长，负值为变短，绝对值越大修饰效果越强，预设值为 -20。
- FACE_SHAPE_AREA_EYESCALE (8)：眼睛，用于实现大眼效果。对应修饰力度范围为 [0,100]，值越大，眼睛越大，预设值为 53。
- FACE_SHAPE_AREA_NOSELENGTH (9)：鼻子长度，用于实现长鼻效果。对应修饰力度范围为 [-100,100]，正值为拉长，负值为变短，绝对值越大修饰效果越强，预设值为 -10。
- FACE_SHAPE_AREA_NOSEWIDTH (10)：鼻子宽度，用于实现瘦鼻效果。对应修饰力度范围为 [-100,100]，正值为变宽，负值为变窄，绝对值越大修饰效果越强，预设值为 72。
- FACE_SHAPE_AREA_MOUTHSCALE (11)：嘴巴，修饰嘴巴大小。对应修饰力度范围为 [-100,100]，正值为变大，负值为变小，绝对值越大修饰效果越强，预设值为 20。
返回值
- 方法调用成功，返回 FaceShapeAreaOptions 对象。
- 方法调用失败，返回 NULL。
getFaceShapeBeautyOptions [1/2]
获取美型效果选项。
Java
public abstract FaceShapeBeautyOptions getFaceShapeBeautyOptions(
Constants.MediaSourceType sourceType);
自从
v4.5.0
调用该方法可以获取美型效果当前设置的参数信息。
适用场景
用户在 App 中打开美型风格和风格强度菜单时，你可以调用该方法获取当前的美型效果选项，然后根据结果刷新用户界面中的菜单，并更新 UI。
调用时机
请在 enableVideo 之后调用该方法。
调用限制
无。
参数
- sourceType
- 效果应用的媒体源类型。详见 MediaSourceType。注意在该方法中，该参数仅支持以下两种设置：
- 使用摄像头采集本地视频时，请保持默认值 PRIMARY_CAMERA_SOURCE。
- 如果要使用自定义采集的视频，将该参数设置为 CUSTOM_VIDEO_SOURCE。
返回值
- 方法调用成功，返回 FaceShapeBeautyOptions 对象。
- 方法调用失败，返回 NULL。
getFaceShapeBeautyOptions [2/2]
获取美型效果选项。
Java
public abstract FaceShapeBeautyOptions getFaceShapeBeautyOptions();
自从
v4.5.0
调用该方法可以获取美型效果当前设置的参数信息。
适用场景
用户在 App 中打开美型风格和风格强度菜单时，你可以调用该方法获取当前的美型效果选项，然后根据结果刷新用户界面中的菜单，并更新 UI。
调用时机
请在 enableVideo 之后调用该方法。
调用限制
无。
返回值
- 方法调用成功，返回 FaceShapeBeautyOptions 对象。
- 方法调用失败，返回 NULL。
setBeautyEffectOptions [1/2]
设置美颜效果选项。
Java
public abstract int setBeautyEffectOptions(boolean enabled, BeautyOptions options);
开启本地美颜功能，并设置美颜效果选项。
调用时机
请在 enableVideo 或 startPreview [2/2] 之后调用该方法。
调用限制
- 该方法仅适用于 Android 5.0 及以上版本。
- 该方法依赖于视频增强动态库
libagora_clear_vision_extension.so，如果删除该动态库会导致无法正常开启该功能。 - 该功能对设备性能要求较高，调用该方法时 SDK 会自动对当前设备能力进行检查。
参数
- enabled
- 是否开启美颜功能：
true: 开启美颜功能。false:（默认）关闭美颜功能。
- options
- 美颜选项，详细定义见 BeautyOptions。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。详见错误码了解详情和解决建议。
- -4：当前设备不支持该功能，可能的原因有：
- 当前设备能力不满足美颜的使用要求，建议更换性能更高的设备。
- 当前设备版本低于 Android 5.0，不支持该操作，建议更换设备或升级操作系统。
- -4：当前设备不支持该功能，可能的原因有：
setBeautyEffectOptions [2/2]
设置美颜效果选项并指定媒体源。
Java
public abstract int setBeautyEffectOptions(
boolean enabled, BeautyOptions options, Constants.MediaSourceType sourceType);
开启本地美颜功能，并设置美颜效果选项和效果应用的媒体源。
该方法和 setBeautyEffectOptions [1/2] 均可用于设置美颜效果选项，区别在于该方法支持在设置美颜效果选项时指定应用美颜的媒体源。
调用时机
请在 enableVideo 或 startPreview [2/2] 之后调用该方法。
参数
- enabled
- 是否开启美颜功能：
true: 开启美颜功能。false:（默认）关闭美颜功能。
- options
- 美颜选项，详细定义见 BeautyOptions。
- sourceType
- 效果应用的媒体源类型。详见 MediaSourceType。注意在该方法中，该参数仅支持以下两种设置：
- 默认值为 PRIMARY_CAMERA_SOURCE。
- 如果要使用自定义采集的视频，将该参数设置为 CUSTOM_VIDEO_SOURCE。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。详见错误码了解详情和解决建议。
- -4：当前设备不支持该功能，可能的原因有：
- 当前设备能力不满足美颜的使用要求，建议更换性能更高的设备。
- 当前设备版本低于 Android 5.0，不支持该操作，建议更换设备或升级操作系统。
- -4：当前设备不支持该功能，可能的原因有：
setColorEnhanceOptions [1/2]
设置色彩增强功能。
Java
public abstract int setColorEnhanceOptions(boolean enabled, ColorEnhanceOptions options);
详情
摄像头采集到的视频画面可能存在色彩失真的现象。色彩增强功能可以通过智能调节饱和度和对比度等视频特性，提升视频色彩丰富度和色彩还原度，最终使视频画面更生动。
你可以调用该方法开启色彩增强功能并设置色彩增强的效果。
注意
- 请在 enableVideo 后调用该方法。
- 色彩增强对设备性能有一定要求。开启色彩增强后，如果设备出现严重发烫等问题，建议你将色彩增强等级修改为消耗性能较少的等级或关闭色彩增强功能。
- 该方法依赖于视频增强动态库
libagora_clear_vision_extension.so，如果删除该动态库会导致无法正常开启该功能。
参数
- enabled
- 是否开启色彩增强功能：
true：开启色彩增强功能。false：（默认）关闭色彩增强功能。
- options
- 色彩增强选项，用于设置色彩增强的效果。详见 ColorEnhanceOptions。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。详见错误码了解详情和解决建议。
setColorEnhanceOptions [2/2]
设置色彩增强功能并指定媒体源。
Java
public abstract int setColorEnhanceOptions(
boolean enabled, ColorEnhanceOptions options, Constants.MediaSourceType sourceType);
详情
摄像头采集到的视频画面可能存在色彩失真的现象。色彩增强功能可以通过智能调节饱和度和对比度等视频特性，提升视频色彩丰富度和色彩还原度，最终使视频画面更生动。
该方法和 setColorEnhanceOptions [1/2] 均可用于设置色彩增强功功能，区别在于该方法支持在设色彩增强功能时指定应用色彩增强的媒体源。
注意
- 请在 enableVideo 后调用该方法。
- 色彩增强对设备性能有一定要求。开启色彩增强后，如果设备出现严重发烫等问题，建议你将色彩增强等级修改为消耗性能较少的等级或关闭色彩增强功能。
- 该方法依赖于视频增强动态库
libagora_clear_vision_extension.so，如果删除该动态库会导致无法正常开启该功能。
参数
- enabled
- 是否开启色彩增强功能：
true：开启色彩增强功能。false：（默认）关闭色彩增强功能。
- options
- 色彩增强选项，用于设置色彩增强的效果。详见 ColorEnhanceOptions。
- sourceType
- 效果应用的媒体源类型。详见 MediaSourceType。注意在该方法中，该参数仅支持以下两种设置：
- 默认值为 PRIMARY_CAMERA_SOURCE。
- 如果要使用自定义采集的视频，将该参数设置为 CUSTOM_VIDEO_SOURCE。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。详见错误码了解详情和解决建议。
setFaceShapeAreaOptions [1/2]
设置美型部位选项并指定媒体源。
Java
public abstract int setFaceShapeAreaOptions(
FaceShapeAreaOptions options, Constants.MediaSourceType sourceType);
自从
v4.5.0
如果在 setFaceShapeBeautyOptions [1/2] 方法中实现的预设美型效果达不到预期，你可以通过该方法设置美型部位选项，对人脸的各个部位单独微调，实现更加精细的美型效果。详见实现高级美颜。
该方法和 setFaceShapeAreaOptions [2/2] 均可用于设置美型部位选项，区别在于该方法支持指定应用美型效果的媒体源。
警告
美型属于增值服务，计费方式详见计费策略。
调用时机
请在 setFaceShapeBeautyOptions [1/2] 或 setFaceShapeBeautyOptions [2/2] 之后调用该方法。
调用限制
- 该方法仅适用于 Android 4.4 及以上版本。
- 该方法依赖于视频增强动态库
libagora_clear_vision_extension.so，如果删除该动态库会导致无法正常开启该功能。 - 该功能对设备性能要求较高，调用该方法时 SDK 会自动对当前设备能力进行检查。
参数
- options
- 美型部位选项，详见 FaceShapeAreaOptions。
- sourceType
- 效果应用的媒体源类型。详见 MediaSourceType。注意在该方法中，该参数仅支持以下两种设置：
- 使用摄像头采集本地视频时，请保持默认值 PRIMARY_CAMERA_SOURCE。
- 如果要使用自定义采集的视频，将该参数设置为 CUSTOM_VIDEO_SOURCE。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。详见错误码了解详情和解决建议。
- -4：当前设备不支持该功能，可能的原因有：
- 当前设备能力不满足美颜的使用要求，建议更换性能更高的设备。
- 当前设备版本低于 Android 4.4，不支持该操作，建议更换设备或升级操作系统。
- -4：当前设备不支持该功能，可能的原因有：
setFaceShapeAreaOptions [2/2]
设置美型部位选项。
Java
public abstract int setFaceShapeAreaOptions(FaceShapeAreaOptions options);
自从
v4.5.0
如果在 setFaceShapeBeautyOptions [1/2] 方法中实现的预设美型效果达不到预期，你可以通过该方法设置美型部位选项，对人脸的各个部位单独微调，实现更加精细的美型效果。详见实现高级美颜。
警告
美型属于增值服务，计费方式详见计费策略。
调用时机
请在调用 setFaceShapeBeautyOptions [1/2] 或 setFaceShapeBeautyOptions [1/2] 之后调用该方法。
调用限制
- 该方法仅适用于 Android 4.4 及以上版本。
- 该方法依赖于视频增强动态库
libagora_clear_vision_extension.so，如果删除该动态库会导致无法正常开启该功能。 - 该功能对设备性能要求较高，调用该方法时 SDK 会自动对当前设备能力进行检查。
参数
- options
- 美型部位选项，详见 FaceShapeAreaOptions。
- sourceType
- 效果应用的媒体源类型。详见 MediaSourceType。注意在该方法中，该参数仅支持以下两种设置：
- 使用摄像头采集本地视频时，请保持默认值 PRIMARY_CAMERA_SOURCE。
- 如果要使用自定义采集的视频，将该参数设置为 CUSTOM_VIDEO_SOURCE。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。详见错误码了解详情和解决建议。
- -4：当前设备不支持该功能，可能的原因有：
- 当前设备能力不满足美颜的使用要求，建议更换性能更高的设备。
- 当前设备版本低于 Android 4.4，不支持该操作，建议更换设备或升级操作系统。
- -4：当前设备不支持该功能，可能的原因有：
setFaceShapeBeautyOptions [1/2]
设置美型效果选项并指定媒体源。
Java
public abstract int setFaceShapeBeautyOptions(
boolean enabled, FaceShapeBeautyOptions options, Constants.MediaSourceType sourceType);
自从
v4.5.0
调用该方法可对人脸各部位进行修饰，使用预设的参数一次性实现瘦脸、大眼、瘦鼻等微整形效果，支持微调整体的修饰力度。详见实现高级美颜。
该方法和 setFaceShapeBeautyOptions [2/2] 均可用于设置美型效果选项，区别在于该方法支持指定应用美型效果的媒体源。
警告
美型属于增值服务，计费方式详见计费策略。
调用时机
请在 enableVideo 之后调用该方法。
调用限制
- 该方法仅适用于 Android 4.4 及以上版本。
- 该方法依赖于视频增强动态库
libagora_clear_vision_extension.so，如果删除该动态库会导致无法正常开启该功能。 - 该功能对设备性能要求较高，调用该方法时 SDK 会自动对当前设备能力进行检查。
参数
- enabled
- 是否开启美型效果：
true: 开启美型功能。false:（默认）关闭美型功能。
- options
- 美型风格选项，详见 FaceShapeBeautyOptions。
- sourceType
- 效果应用的媒体源类型。详见 MediaSourceType。注意在该方法中，该参数仅支持以下两种设置：
- 使用摄像头采集本地视频时，请保持默认值 PRIMARY_CAMERA_SOURCE。
- 如果要使用自定义采集的视频，将该参数设置为 CUSTOM_VIDEO_SOURCE。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。详见错误码了解详情和解决建议。
- -4：当前设备不支持该功能，可能的原因有：
- 当前设备能力不满足美颜的使用要求，建议更换性能更高的设备。
- 当前设备版本低于 Android 4.4，不支持该操作，建议更换设备或升级操作系统。
- -4：当前设备不支持该功能，可能的原因有：
setFaceShapeBeautyOptions [2/2]
设置美型效果选项。
Java
public abstract int setFaceShapeBeautyOptions(boolean enabled, FaceShapeBeautyOptions options);
调用时机
请在 enableVideo 之后调用该方法。
调用限制
- 该方法仅适用于 Android 4.4 及以上版本。
- 该方法依赖于视频增强动态库
libagora_clear_vision_extension.so，如果删除该动态库会导致无法正常开启该功能。 - 该功能对设备性能要求较高，调用该方法时 SDK 会自动对当前设备能力进行检查。
参数
- enabled
- 是否开启美型效果：
true: 开启美型功能。false:（默认）关闭美型功能。
- options
- 美型风格选项，详见 FaceShapeBeautyOptions。
- sourceType
- 效果应用的媒体源类型。详见 MediaSourceType。注意在该方法中，该参数仅支持以下两种设置：
- 使用摄像头采集本地视频时，请保持默认值 PRIMARY_CAMERA_SOURCE。
- 如果要使用自定义采集的视频，将该参数设置为 CUSTOM_VIDEO_SOURCE。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。详见错误码了解详情和解决建议。
- -4：当前设备不支持该功能，可能的原因有：
- 当前设备能力不满足美颜的使用要求，建议更换性能更高的设备。
- 当前设备版本低于 Android 4.4，不支持该操作，建议更换设备或升级操作系统。
- -4：当前设备不支持该功能，可能的原因有：
setFilterEffectOptions [1/2]
设置滤镜效果选项并指定媒体源。
Java
public abstract int setFilterEffectOptions(
boolean enabled, FilterEffectOptions options, Constants.MediaSourceType sourceType);
自从
v4.5.0
该方法和 setBeautyEffectOptions [2/2] 均可用于设置滤镜效果选项，区别在于该方法支持在设置滤镜效果选项时指定应用滤镜的媒体源。
调用时机
请在 enableVideo 之后调用该方法。
调用限制
- 该方法仅适用于 Android 5.0 及以上版本。
- 该方法依赖于视频增强动态库
libagora_clear_vision_extension.so，如果删除该动态库会导致无法正常开启该功能。 - 该功能对设备性能要求较高，调用该方法时 SDK 会自动对当前设备能力进行检查。
参数
- enabled
- 是否开启滤镜效果：
true: 开启滤镜功能。false:（默认）关闭滤镜功能。
- options
- 滤镜选项，详见 FilterEffectOptions。
- sourceType
- 效果应用的媒体源类型。详见 MediaSourceType。注意在该方法中，该参数仅支持以下两种设置：
- 使用摄像头采集本地视频时，请保持默认值 PRIMARY_CAMERA_SOURCE。
- 如果要使用自定义采集的视频，将该参数设置为 CUSTOM_VIDEO_SOURCE。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。详见错误码了解详情和解决建议。
setFilterEffectOptions [2/2]
设置滤镜效果选项。
Java
public abstract int setFilterEffectOptions(boolean enabled, FilterEffectOptions options);
自从
v4.5.0
调用时机
请在 enableVideo 之后调用该方法。
调用限制
- 该方法仅适用于 Android 5.0 及以上版本。
- 该方法依赖于视频增强动态库
libagora_clear_vision_extension.so，如果删除该动态库会导致无法正常开启该功能。 - 该功能对设备性能要求较高，调用该方法时 SDK 会自动对当前设备能力进行检查。
参数
- enabled
- 是否开启滤镜效果：
true: 开启滤镜功能。false:（默认）关闭滤镜功能。
- options
- 滤镜选项，详见 FilterEffectOptions。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。详见错误码了解详情和解决建议。
setLowlightEnhanceOptions [1/2]
设置暗光增强功能。
Java
public abstract int setLowlightEnhanceOptions(boolean enabled, LowLightEnhanceOptions options);
你可以调用该方法开启暗光增强功能并设置暗光增强的效果。
适用场景
暗光增强功能可以在光线亮度偏低（如背光、阴天、暗场景）和亮度不均匀的环境下自适应调整视频画面的亮度值，恢复或凸显图像的细节信息，最终提升视频图像的整体视觉效果。
调用时机
请在 enableVideo 后调用该方法。
调用限制
- 该方法依赖于视频增强动态库
libagora_clear_vision_extension.so，如果删除该动态库会导致无法正常开启该功能。 - 暗光增强对设备性能有一定要求。开启暗光增强后，如果设备出现严重发烫等问题，建议你将暗光增强等级修改为消耗性能较少的等级或关闭暗光增强功能。
- 如果要实现优先画质 (LOW_LIGHT_ENHANCE_LEVEL_HIGH_QUALITY) 的暗光增强，需要先调用 setVideoDenoiserOptions [1/2] 实现视频降噪，具体对应关系如下：
- 暗光增强为自动模式 (LOW_LIGHT_ENHANCE_AUTO) 时，视频降噪需设置为优先画质 (VIDEO_DENOISER_LEVEL_HIGH_QUALITY)、自动模式 (VIDEO_DENOISER_AUTO)。
- 暗光增强为手动模式 (LOW_LIGHT_ENHANCE_MANUAL) 时，视频降噪需设置为优先画质 (VIDEO_DENOISER_LEVEL_HIGH_QUALITY)、手动模式 (VIDEO_DENOISER_MANUAL)。
参数
- enabled
- 是否开启暗光增强功能：
true: 开启暗光增强功能。false:（默认）关闭暗光增强功能。
- options
- 暗光增强选项，用于设置暗光增强的效果。详见 LowlightEnhanceOptions。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。详见错误码了解详情和解决建议。
setLowlightEnhanceOptions [2/2]
设置暗光增强功能并指定媒体源。
Java
public abstract int setLowlightEnhanceOptions(
boolean enabled, LowLightEnhanceOptions options, Constants.MediaSourceType sourceType);
该方法和 setLowlightEnhanceOptions [1/2] 均可用于设置暗光增强功能，区别在于该方法支持在设置暗光增强功能时指定应用暗光增强的媒体源。
适用场景
采光不足的环境和低端视频采集设备会使视频图像含有明显的噪声，影响视频画质。在实时互动场景下，视频噪声还会在编码过程中占用码流资源并降低编码效率。
调用时机
请在 enableVideo 后调用该方法。
调用限制
- 该方法依赖于视频增强动态库
libagora_clear_vision_extension.so，如果删除该动态库会导致无法正常开启该功能。 - 视频降噪对设备性能有一定要求。开启视频降噪后，如果设备出现严重发烫等问题，建议你将视频降噪等级修改为消耗性能较少的等级或关闭视频降噪功能。
参数
- enabled
- 是否开启暗光增强功能：
true: 开启暗光增强功能。false:（默认）关闭暗光增强功能。
- options
- 暗光增强选项，用于设置暗光增强的效果。详见 LowlightEnhanceOptions。
- sourceType
- 效果应用的媒体源类型。详见 MediaSourceType。注意在该方法中，该参数仅支持以下两种设置：
- 默认值为 PRIMARY_CAMERA_SOURCE。
- 如果要使用自定义采集的视频，将该参数设置为 CUSTOM_VIDEO_SOURCE。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。详见错误码了解详情和解决建议。
setVideoDenoiserOptions [1/2]
设置视频降噪功能。
Java
public abstract int setVideoDenoiserOptions(boolean enabled, VideoDenoiserOptions options);
你可以调用该方法开启视频降噪功能并设置视频降噪的效果。
信息
如果该方法实现的降噪强度无法满足你的需求，声网推荐你调用 setBeautyEffectOptions [1/2] 方法启用美颜磨皮功能，以获得更好的视频降噪效果。强效降噪效果的 BeautyOptions 推荐设置如下：
- lighteningContrastLevel：LIGHTENING_CONTRAST_NORMAL
- lighteningLevel：0.0
- smoothnessLevel：0.5
- rednessLevel：0.0
- sharpnessLevel：0.1
适用场景
采光不足的环境和低端视频采集设备会使视频图像含有明显的噪声，影响视频画质。在实时互动场景下，视频噪声还会在编码过程中占用码流资源并降低编码效率。
调用时机
请在 enableVideo 后调用该方法。
调用限制
- 该方法依赖于视频增强动态库
libagora_clear_vision_extension.so，如果删除该动态库会导致无法正常开启该功能。 - 视频降噪对设备性能有一定要求。开启视频降噪后，如果设备出现严重发烫等问题，建议你将视频降噪等级修改为消耗性能较少的等级或关闭视频降噪功能。
参数
- enabled
- 是否开启视频降噪功能：
true: 开启视频降噪功能。false:（默认）关闭视频降噪功能。
- options
- 视频降噪选项，用于设置视频降噪的效果。详见 VideoDenoiserOptions。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。详见错误码了解详情和解决建议。
setVideoDenoiserOptions [2/2]
设置视频降噪功能并指定媒体源。
Java
public abstract int setVideoDenoiserOptions(
boolean enabled, VideoDenoiserOptions options, Constants.MediaSourceType sourceType);
你可以调用该方法开启视频降噪功能并设置视频降噪的效果。
该方法和 setVideoDenoiserOptions [1/2] 均可用于设置视频降噪功能，区别在于该方法支持在设置视频降噪功能时指定应用视频降噪功能的媒体源。
信息
如果该方法实现的降噪强度无法满足你的需求，声网推荐你调用 setBeautyEffectOptions [1/2] 方法启用美颜磨皮功能，以获得更好的视频降噪效果。强效降噪效果的 BeautyOptions 推荐设置如下：
- lighteningContrastLevel：LIGHTENING_CONTRAST_NORMAL
- lighteningLevel：0.0
- smoothnessLevel：0.5
- rednessLevel：0.0
- sharpnessLevel：0.1
适用场景
采光不足的环境和低端视频采集设备会使视频图像含有明显的噪声，影响视频画质。在实时互动场景下，视频噪声还会在编码过程中占用码流资源并降低编码效率。
调用时机
请在 enableVideo 后调用该方法。
调用限制
- 该方法依赖于视频增强动态库
libagora_clear_vision_extension.so，如果删除该动态库会导致无法正常开启该功能。 - 视频降噪对设备性能有一定要求。开启视频降噪后，如果设备出现严重发烫等问题，建议你将视频降噪等级修改为消耗性能较少的等级或关闭视频降噪功能。
参数
- enabled
- 是否开启视频降噪功能：
true: 开启视频降噪功能。false:（默认）关闭视频降噪功能。
- options
- 视频降噪选项，用于设置视频降噪的效果。详见 VideoDenoiserOptions。
- sourceType
- 效果应用的媒体源类型。详见 MediaSourceType。注意在该方法中，该参数仅支持以下两种设置：
- 默认值为 PRIMARY_CAMERA_SOURCE。
- 如果要使用自定义采集的视频，将该参数设置为 CUSTOM_VIDEO_SOURCE。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。详见错误码了解详情和解决建议。