AutomaticGainControl

public class AutomaticGainControl
extends AudioEffect

自动增益控制（AGC）。

自动增益控制（AGC）是一种音频预处理，通过升高或降低麦克风输入以匹配预设电平来自动标准化捕捉信号的输出，以便输出信号电平几乎恒定。 AGC可用于输入信号动态范围不重要但需要恒定强捕捉电平的应用。

应用程序创建一个AutomaticGainControl对象来实例化并控制音频框架中的AGC引擎。

要将AutomaticGainControl附加到特定的AudioRecord ，请在创建AutomaticGainControl时指定此AudioRecord的音频会话ID。 通过在AudioRecord实例上调用getAudioSessionId()来检索音频会话。

在某些设备上，平台根据所使用的MediaRecorder.AudioSource可以默认将AGC插入捕获路径。 创建AGC后，应用程序应调用AutomaticGainControl.getEnable（）以检查特定AudioRecord会话上的默认AGC激活状态。

有关控制音频效果的更多详细信息，请参见 AudioEffect类。

Summary

Inherited constants

From class android.media.audiofx.AudioEffect String ACTION_CLOSE_AUDIO_EFFECT_CONTROL_SESSION 旨在向效果控制应用程序或服务发信号通知音频会话已关闭，并且该效果不应再被应用。 String ACTION_DISPLAY_AUDIO_EFFECT_CONTROL_PANEL 意图启动音频效果控制面板用户界面。 String ACTION_OPEN_AUDIO_EFFECT_CONTROL_SESSION 旨在向效果控制应用程序或服务发信号通知新音频会话打开并要求应用音频效果。 int ALREADY_EXISTS 内部操作状态。 int CONTENT_TYPE_GAME 当播放的内容类型是游戏音频时， EXTRA_CONTENT_TYPE int CONTENT_TYPE_MOVIE 当播放的内容类型是视频或电影时， EXTRA_CONTENT_TYPE int CONTENT_TYPE_MUSIC 当播放的内容类型是音乐时， EXTRA_CONTENT_TYPE int CONTENT_TYPE_VOICE 当播放的内容类型是语音音频时， EXTRA_CONTENT_TYPE String EFFECT_AUXILIARY 效果连接模式是辅助功能。 String EFFECT_INSERT 插入效果连接模式。 int ERROR 未指定的错误。 int ERROR_BAD_VALUE 由于参数值不正确，操作失败。 int ERROR_DEAD_OBJECT 由于死亡的远程对象导致操作失败。 int ERROR_INVALID_OPERATION 操作失败，因为它被请求的状态不正确。 int ERROR_NO_INIT 由于对象初始化不当，操作失败。 int ERROR_NO_MEMORY 由于内存不足，操作失败。 String EXTRA_AUDIO_SESSION 包含应用效果的音频会话的ID。 String EXTRA_CONTENT_TYPE 指示应用程序播放哪种类型的内容。 String EXTRA_PACKAGE_NAME 包含调用应用程序的包名称。 int SUCCESS 成功运作。

Inherited fields

From class android.media.audiofx.AudioEffect public static final UUID EFFECT_TYPE_AEC 声学回声消除器（AEC）的UUID public static final UUID EFFECT_TYPE_AGC 用于自动增益控制（AGC）的UUID public static final UUID EFFECT_TYPE_BASS_BOOST 用于低音增强效果的UUID public static final UUID EFFECT_TYPE_ENV_REVERB UUID用于环境混响效果 public static final UUID EFFECT_TYPE_EQUALIZER 用于均衡器效果的UUID public static final UUID EFFECT_TYPE_LOUDNESS_ENHANCER 用于响度增强器的UUID public static final UUID EFFECT_TYPE_NS 用于噪声抑制器（NS）的UUID public static final UUID EFFECT_TYPE_PRESET_REVERB UUID用于预设混响效果 public static final UUID EFFECT_TYPE_VIRTUALIZER 用于虚拟器效果的UUID

Inherited methods
From class android.media.audiofx.AudioEffect void finalize() 当垃圾收集确定没有更多对该对象的引用时，由对象上的垃圾回收器调用。 AudioEffect.Descriptor getDescriptor() 获取效果描述符。 boolean getEnabled() 返回效果启用状态 int getId() 返回影响唯一标识符。 boolean hasControl() 检查此AudioEffect对象是否正在控制效果引擎。 static Descriptor[] queryEffects() 查询平台上可用的所有效果。 void release() 释放本机AudioEffect资源。 void setControlStatusListener(AudioEffect.OnControlStatusChangeListener listener) 设置侦听器AudioEffect通知何时执行效果引擎控件。 void setEnableStatusListener(AudioEffect.OnEnableStatusChangeListener listener) 当效果引擎启用或禁用时，设置侦听器AudioEffect通知。 int setEnabled(boolean enabled) 启用或禁用该效果。
From class java.lang.Object Object clone() 创建并返回此对象的副本。 boolean equals(Object obj) 指示其他某个对象是否“等于”这一个。 void finalize() 当垃圾收集确定没有更多对该对象的引用时，由对象上的垃圾回收器调用。 final Class<?> getClass() 返回此 Object的运行时类。 int hashCode() 返回对象的哈希码值。 final void notify() 唤醒正在等待该对象监视器的单个线程。 final void notifyAll() 唤醒在该对象监视器上等待的所有线程。 String toString() 返回对象的字符串表示形式。 final void wait(long millis, int nanos) 导致当前线程等待，直到另一个线程调用此对象的 notify()方法或 notifyAll()方法，或某个其他线程中断当前线程，或经过一定的实时时间。 final void wait(long millis) 导致当前线程等待，直到另一个线程调用此对象的 notify()方法或 notifyAll()方法或经过了指定的时间量。 final void wait() 导致当前线程等待，直到另一个线程调用此对象的 notify()方法或 notifyAll()方法。

Public methods

AutomaticGainControl create (int audioSession)

boolean isAvailable ()