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]