AudioEffect

ACTION_CLOSE_AUDIO_EFFECT_CONTROL_SESSION

String ACTION_CLOSE_AUDIO_EFFECT_CONTROL_SESSION

旨在向效果控制应用程序或服务发信号通知音频会话已关闭，并且该效果不应再被应用。

接收该意图的效果控制应用程序将删除此会话上的所有效果并将当前设置存储在特定于包的存储中。

通话包名称由额外的EXTRA_PACKAGE_NAME表示，音频会话ID由EXTRA_AUDIO_SESSION 。 这两个附加项都是强制性的

在音乐播放停止时和/或退出音频效果引擎消耗的免费系统资源时，应用程序广播此意图是一种好的做法。

常量值：“android.media.action.CLOSE_AUDIO_EFFECT_CONTROL_SESSION”

ACTION_DISPLAY_AUDIO_EFFECT_CONTROL_PANEL

String ACTION_DISPLAY_AUDIO_EFFECT_CONTROL_PANEL

意图启动音频效果控制面板用户界面。

此意图的目标是实现音乐/媒体播放器应用程序和音频效果控制应用程序或服务的单独实现。 这将使平台供应商能够为标准效果提供更先进的控制选项，或控制平台特定的效果。

该意图携带播放器应用程序用于向控制面板应用程序传送必要信息的许多附加信息。

调用应用程序必须使用 startActivityForResult(Intent, int)方法启动控制面板，以便控制面板应用程序指示和使用其包名称，以跟踪此特定应用程序的更改。

额外的EXTRA_AUDIO_SESSION将指示应该应用音频效果的音频会话。 如果没有指定音频会话，则会发生以下任何一个follownig：

- 如果音频会话之前由呼叫应用程序以 ACTION_OPEN_AUDIO_EFFECT_CONTROL_SESSION意图打开，则效果更改将应用于该会话。

- 如果未打开任何音频会话，则更改将存储在程序包特定的存储区中，并且在此应用程序打开新的音频会话时应用此更改。

EXTRA_CONTENT_TYPE额外的将帮助控制面板应用程序自定义用户界面布局和默认音频效果设置，如果没有存储调用应用程序。

常量值：“android.media.action.DISPLAY_AUDIO_EFFECT_CONTROL_PANEL”

ACTION_OPEN_AUDIO_EFFECT_CONTROL_SESSION

String ACTION_OPEN_AUDIO_EFFECT_CONTROL_SESSION

旨在向效果控制应用程序或服务发信号通知新音频会话打开并要求应用音频效果。

这与ACTION_DISPLAY_AUDIO_EFFECT_CONTROL_PANEL不同， ACTION_DISPLAY_AUDIO_EFFECT_CONTROL_PANEL在这种情况下不应该显示UI。 音乐播放器应用程序可以在开始播放之前播放此意图，以确保先前由用户选择的任何音频效果设置都已应用。

接收到该意图的效果控制应用程序将查找先前存储的调用应用程序的设置，创建所有需要的音频效果并将效果设置应用于指定的音频会话。

主叫包名称由EXTRA_PACKAGE_NAME额外指示，音频会话ID由EXTRA_AUDIO_SESSION 。 这两个附加项都是强制性的

如果找不到调用应用程序的存储设置，则将应用由EXTRA_CONTENT_TYPE指示的内容类型的默认设置。 给定内容类型的默认设置是平台特定的。

常量值：“android.media.action.OPEN_AUDIO_EFFECT_CONTROL_SESSION”

ALREADY_EXISTS

int ALREADY_EXISTS

内部操作状态。 没有任何方法返回。

常量值：-2（0xfffffffe）

CONTENT_TYPE_GAME

int CONTENT_TYPE_GAME

当播放内容的类型是游戏音频时， EXTRA_CONTENT_TYPE

常量值：2（0x00000002）

CONTENT_TYPE_MOVIE

int CONTENT_TYPE_MOVIE

当播放的内容类型是视频或电影时， EXTRA_CONTENT_TYPE

常数值：1（0x00000001）

CONTENT_TYPE_MUSIC

int CONTENT_TYPE_MUSIC

当播放的内容类型是音乐时， EXTRA_CONTENT_TYPE

常量值：0（0x00000000）

CONTENT_TYPE_VOICE

int CONTENT_TYPE_VOICE

当播放的内容类型是语音音频时， EXTRA_CONTENT_TYPE

常量值：3（0x00000003）

EFFECT_AUXILIARY

String EFFECT_AUXILIARY

效果连接模式是辅助功能。

必须在会话0（全局输出混合）上创建辅助效果。 为了使MediaPlayer或AudioTrack得到这种效果，必须明确地附加这种效果，并且必须指定发送级别。

将其附加到MediaPlayer或AudioTrack时，使用由 getId()返回的效果ID指定此特定效果。

常数值：“辅助”

EFFECT_INSERT

String EFFECT_INSERT

插入效果连接模式。 在创建效果时指定音频会话ID将在所有播放器在同一音频会话中插入此效果。

常量值：“插入”

ERROR

int ERROR

未指定的错误。

常量值：-1（0xffffffff）

ERROR_BAD_VALUE

int ERROR_BAD_VALUE

由于参数值不正确，操作失败。

常量值：-4（0xfffffffc）

ERROR_DEAD_OBJECT

int ERROR_DEAD_OBJECT

由于死亡的远程对象导致操作失败。

常量值：-7（0xfffffff9）

ERROR_INVALID_OPERATION

int ERROR_INVALID_OPERATION

操作失败，因为它被请求的状态不正确。

常量值：-5（0xfffffffb）

ERROR_NO_INIT

int ERROR_NO_INIT

由于对象初始化不当，操作失败。

常量值：-3（0xfffffffd）

ERROR_NO_MEMORY

int ERROR_NO_MEMORY

由于内存不足，操作失败。

常量值：-6（0xfffffffa）

EXTRA_AUDIO_SESSION

String EXTRA_AUDIO_SESSION

包含应用效果的音频会话的ID。

这额外的是与使用 ACTION_DISPLAY_AUDIO_EFFECT_CONTROL_PANEL ， ACTION_OPEN_AUDIO_EFFECT_CONTROL_SESSION和 ACTION_CLOSE_AUDIO_EFFECT_CONTROL_SESSION意图。

额外的值是int类型，并且是音频会话ID。

常量值：“android.media.extra.AUDIO_SESSION”

EXTRA_CONTENT_TYPE

String EXTRA_CONTENT_TYPE

指示应用程序播放哪种类型的内容。

此额外用于 ACTION_DISPLAY_AUDIO_EFFECT_CONTROL_PANEL和 ACTION_OPEN_AUDIO_EFFECT_CONTROL_SESSION意图。

效果控制应用程序使用此信息来自定义UI并选择适当的默认效果设置。 内容类型是以下之一：

• CONTENT_TYPE_MUSIC
• CONTENT_TYPE_MOVIE
• CONTENT_TYPE_GAME
• CONTENT_TYPE_VOICE

常量值：“android.media.extra.CONTENT_TYPE”

EXTRA_PACKAGE_NAME

String EXTRA_PACKAGE_NAME

包含调用应用程序的包名称。

此额外用于 ACTION_OPEN_AUDIO_EFFECT_CONTROL_SESSION和 ACTION_CLOSE_AUDIO_EFFECT_CONTROL_SESSION意图。

额外的值是一个包含完整软件包名称的字符串。

常量值：“android.media.extra.PACKAGE_NAME”

SUCCESS

int SUCCESS

成功运作。

常量值：0（0x00000000）

EFFECT_TYPE_AEC

UUID EFFECT_TYPE_AEC

声学回声消除器（AEC）的UUID

EFFECT_TYPE_AGC

UUID EFFECT_TYPE_AGC

用于自动增益控制（AGC）的UUID

EFFECT_TYPE_BASS_BOOST

UUID EFFECT_TYPE_BASS_BOOST

用于低音增强效果的UUID

EFFECT_TYPE_ENV_REVERB

UUID EFFECT_TYPE_ENV_REVERB

UUID用于环境混响效果

EFFECT_TYPE_EQUALIZER

UUID EFFECT_TYPE_EQUALIZER

用于均衡器效果的UUID

EFFECT_TYPE_LOUDNESS_ENHANCER

UUID EFFECT_TYPE_LOUDNESS_ENHANCER

用于响度增强器的UUID

EFFECT_TYPE_NS

UUID EFFECT_TYPE_NS

用于噪声抑制器（NS）的UUID

EFFECT_TYPE_PRESET_REVERB

UUID EFFECT_TYPE_PRESET_REVERB

UUID用于预设混响效果

EFFECT_TYPE_VIRTUALIZER

UUID EFFECT_TYPE_VIRTUALIZER

用于虚拟器效果的UUID

getDescriptor

AudioEffect.Descriptor getDescriptor ()

获取效果描述符。

getEnabled

boolean getEnabled ()

返回效果启用状态

getId

int getId ()

返回影响唯一标识符。 当该效果是辅助效果（混响）时，此系统范围的唯一标识符可用于将此效果附加到MediaPlayer或AudioTrack上，

hasControl

boolean hasControl ()

检查此AudioEffect对象是否正在控制效果引擎。

queryEffects

Descriptor[] queryEffects ()

查询平台上可用的所有效果。 返回一个包含AudioEffect.Descriptor对象的数组

release

void release ()

释放本机AudioEffect资源。 在不使用时释放效果引擎是一种很好的做法，因为控件可以返回到其他应用程序或释放的本地资源。

setControlStatusListener

void setControlStatusListener (AudioEffect.OnControlStatusChangeListener listener)

设置侦听器AudioEffect通知何时执行效果引擎控件。

setEnableStatusListener

void setEnableStatusListener (AudioEffect.OnEnableStatusChangeListener listener)

当效果引擎启用或禁用时，设置侦听器AudioEffect通知。

setEnabled

int setEnabled (boolean enabled)

启用或禁用该效果。 创建音频效果不会自动在音频源上应用此效果。 它创建了处理这种效果所需的资源，但音频信号仍然通过效果引擎绕过。 调用此方法将使效果实际应用于或不在相应的音频会话中播放的音频内容。

finalize

void finalize ()

当垃圾收集确定没有更多对该对象的引用时，由对象上的垃圾回收器调用。 子类会覆盖finalize方法以处置系统资源或执行其他清理。

finalize的一般合同是，如果当Java ^TM虚拟机已经确定不再有任何方式可以通过任何尚未死亡的线程访问该对象时，除了作为动作的结果之外取决于某些其他可以完成的对象或类别的最终定稿。 finalize方法可以采取任何行动，包括使该对象再次可用于其他线程; 然而， finalize的通常目的是在对象被不可撤销地丢弃之前执行清理操作。 例如，表示输入/输出连接的对象的finalize方法可能会执行显式I / O事务，以在永久丢弃该对象之前中断连接。

类finalize方法Object执行特殊操作; 它只是正常返回。 Object子类可能会覆盖此定义。

Java编程语言不保证哪个线程将为任何给定的对象调用finalize方法。 但是，保证调用finalize的线程在调用finalize时不会保留任何用户可见的同步锁。 如果finalize方法引发未捕获的异常，则忽略该异常，并终止该对象的终止。

在为对象调用 finalize方法后，不会采取进一步的操作，直到Java虚拟机再次确定不再有任何途径可以通过任何尚未死亡的线程访问此对象，包括可能的操作通过准备完成的其他对象或类别，此时该对象可能被丢弃。

对于任何给定的对象，Java虚拟机从不会多次调用 finalize方法。

由 finalize方法抛出的任何异常 finalize导致此对象的终止被暂停，但会被忽略。