Package com.zego.zegoavkit2.audioprocessing

Class ZegoAudioProcessing

  • public class ZegoAudioProcessing
extends java.lang.Object
    音频处理类。

    Copyright © 2017 Zego. All rights reserved.

    • Constructor Detail

      • ZegoAudioProcessing

        public ZegoAudioProcessing()

    • Method Detail

      • enableVirtualStereo

        public static boolean enableVirtualStereo​(boolean enable,
                                          int angle)
        设置虚拟立体声。

        注意：必须在 InitSDK 之后调用，并且需要设置双声道 setAudioChannelCount(2)，推流成功后动态设置不同的 angle 都会生效。

        Parameters:
        enable - 开启/关闭虚拟立体声，true 表示开启虚拟立体声，false 表示关闭虚拟立体声； 默认为 false（关闭虚拟立体声）。
        angle - 虚拟立体声中声源的角度，范围为 -1 ~ 360，90 为正前方，0 / 180 / 270 分别对应最右边 / 最左边 / 正后方；特别的，设置 -1 时为全方位虚拟立体声效果。
        Returns:
        true 表示调用成功，false 表示调用失败。

      • enableReverb

        @Deprecated
public static boolean enableReverb​(boolean enable,
                                   ZegoAudioReverbMode mode)
        Deprecated.
        请使用 setReverbPreset(ZegoVoiceReverbType)
        设置音频混响。

        注意：必须在 InitSDK 之后调用，推流成功后动态设置不同的 mode 都会生效。

        Parameters:
        enable - 开启/关闭音频混响，true 表示开启音频混响，false 表示关闭音频混响。
        mode - 混响模式，详细定义见 ZegoAudioReverbMode
        Returns:
        true 表示调用成功，false 表示调用失败。

      • setReverbParam

        public static boolean setReverbParam​(float roomSize,
                                     float dryWetRatio)
        设置音频混响参数。

        注意： 必须在 InitSDK 之后调用，推流成功后动态设置不同的值都会生效。任意一个参数设置成0.0时，混响关闭。

        Parameters:
        roomSize - 房间大小，取值范围 [0.0, 1.0]。 值越大说明混响时间越长，产生的混响拖尾效应越大。
        dryWetRatio - 干湿比，取值范围 [0.0, +∞]。 干湿比的值越小，wet的值越大，产生的混响效果越大。
        Returns:
        true 表示调用成功，false 表示调用失败。

      • setReverbParam

        public static boolean setReverbParam​(ZegoAudioReverbParam param)
        设置音频混响参数。

        注意： 必须在 InitSDK 之后调用，推流成功后动态设置不同的值都会生效。任意一个参数设置成0.0时，混响关闭。

        Parameters:
        param - 混响参数，详细定义见 ZegoAudioReverbParam
        Returns:
        true 表示调用成功，false 表示调用失败。

      • setVoiceChangerParam

        public static boolean setVoiceChangerParam​(float param)
        设置变声器参数，用于调整声调。

        注意： 必须在 InitSDK 之后调用，变声音效只针对采集的声音有效。

        Parameters:
        param - 变声器参数，取值范围 [-12.0, 12.0]
        Returns:
        true 表示调用成功，false 表示调用失败。

      • setReverbEchoParam

        public static boolean setReverbEchoParam​(ZegoReverbEchoParam param)
        设置音频回声参数。

        注意： 必须在 InitSDK 之后调用，支持推流成功后动态设置。

        Parameters:
        param - 回声参数，详细定义见 ZegoReverbEchoParam
        Returns:
        true 表示调用成功，false 表示调用失败。

      • setVoicePreset

        @Deprecated
public static boolean setVoicePreset​(int type)
        Deprecated.
        请使用 setVoicePreset(com.zego.zegoavkit2.audioprocessing.ZegoVoiceChangerType)
        预设变声配置。

        注意： 1. 必须在 InitSDK 之后调用，变声音效只针对采集的声音有效。
        2. 该接口的效果可由SetReverbParam、SetVoiceChangerParam、SetReverbEchoParam组合实现。
        3. 调用该接口后，若想单独调用上述接口的效果，需先调用setVoicePreset(ZegoVoiceChangerType.CHANGER_OFF)还原配置

        Parameters:
        type - 变声器类型，参考 ZegoAudioProcessing.ZegoVoiceChangerType
        Returns:
        true 表示调用成功，false 表示调用失败。

      • setVoicePreset

        public static boolean setVoicePreset​(ZegoVoiceChangerType type)
        预设变声配置。

        注意： 1. 必须在 InitSDK 之后调用，变声音效只针对采集的声音有效。
        2. 该接口的效果可由SetReverbParam、SetVoiceChangerParam、SetReverbEchoParam组合实现。
        3. 调用该接口后，若想单独调用上述接口的效果，需先调用setVoicePreset(ZegoVoiceChangerType.CHANGER_OFF)还原配置

        Parameters:
        type - 变声器类型，参考 ZegoVoiceChangerType
        Returns:
        true 表示调用成功，false 表示调用失败。

      • setAudioEqualizerGain

        public static boolean setAudioEqualizerGain​(int bandIndex,
                                            float bandGain)
        调整音效均衡器参数

        注意：在 InitSDK 之后调用。使用此接口前请与即构技术支持联系确认是否支持此功能

        Parameters:
        bandIndex - 取值范围[0, 9]。分别对应10个频带，其中心频率分别是[31, 62, 125, 250, 500, 1K, 2K, 4K, 8K, 16K]Hz
        bandGain - 取值范围[-15, 15]。默认值是0，如果所有频带的增益值全部为0，则会关闭EQ功能
        Returns:
        true 调用成功，false 调用失败

      • setElectronicEffects

        public static boolean setElectronicEffects​(boolean enable,
                                           ZegoElectronicEffectsMode mode,
                                           int tonal)
        设置电音配置

        注意： 1. 支持版本：6.4.0 及以上。
        2. 在 InitSDK 之后调用。使用此接口前请与即构技术支持联系确认是否支持此功能

        Parameters:
        enable - true 开启，false 关闭。默认关闭。
        mode - 变声器类型，参考 ZegoElectronicEffectsMode
        tonal - 电音在某个调式下的起始音高，代表声音一个八度的12个半音，取值范围 [0, 11], 默认0
        Returns:
        true 调用成功，false 调用失败

      • enableSpeechEnhance

        public static boolean enableSpeechEnhance​(boolean enable,
                                          int level)
        设置人声增强

        注意： 1. 支持版本: 6.19.0 及以上。
        2. 在 InitSDK 之后调用有效。在KTV外放场景中，由于3A损伤/距离原因，会导致人声较弱/虚/不清晰，需要通过人声增强技术提升外放体验。
        3. 支持动态修改，重复调用本接口，使用最后一次调用的设置。
        4. 在 UninitSDK 后，设置才会失效。

        Parameters:
        enable - true 开启，false 关闭
        level - 人声增强等级, 取值范围 [0, 10]