diff options
author | Eric Laurent <elaurent@google.com> | 2010-08-03 03:50:02 -0700 |
---|---|---|
committer | Eric Laurent <elaurent@google.com> | 2010-08-04 08:31:01 -0700 |
commit | 17cb280e7f1ac3556eac90ab08263712e0348cb9 (patch) | |
tree | 324ae1f315fddc25a0b5ad82863f68a74bc2ed0b | |
parent | 23796e3b622c6be4feb15d4d57e58645acfa431b (diff) | |
download | frameworks_base-17cb280e7f1ac3556eac90ab08263712e0348cb9.zip frameworks_base-17cb280e7f1ac3556eac90ab08263712e0348cb9.tar.gz frameworks_base-17cb280e7f1ac3556eac90ab08263712e0348cb9.tar.bz2 |
NEW_API: Unhide audio effect APIs.
This change unhides all public APIs for controling audio effects exposed
by the following classes:
- AudioEffect
- BassBoost
- EnvironmentalReverb
- Equalizer
- PresetReverb
- Virtualizer
- Visualizer
Also fixes several problems in javadoc.
Change-Id: I541ee4ad0232312ec720545737cbcdb8c9a82597
-rw-r--r-- | api/current.xml | 3331 | ||||
-rw-r--r-- | media/java/android/media/AudioEffect.java | 48 | ||||
-rw-r--r-- | media/java/android/media/AudioTrack.java | 14 | ||||
-rw-r--r-- | media/java/android/media/BassBoost.java | 17 | ||||
-rw-r--r-- | media/java/android/media/EnvironmentalReverb.java | 42 | ||||
-rw-r--r-- | media/java/android/media/Equalizer.java | 59 | ||||
-rw-r--r-- | media/java/android/media/MediaPlayer.java | 63 | ||||
-rw-r--r-- | media/java/android/media/PresetReverb.java | 41 | ||||
-rw-r--r-- | media/java/android/media/Virtualizer.java | 17 | ||||
-rwxr-xr-x | media/java/android/media/Visualizer.java | 20 |
10 files changed, 3479 insertions, 173 deletions
diff --git a/api/current.xml b/api/current.xml index 4dd0909..2b75b03 100644 --- a/api/current.xml +++ b/api/current.xml @@ -84589,6 +84589,1029 @@ > </method> </class> +<class name="AudioEffect" + extends="java.lang.Object" + abstract="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<constructor name="AudioEffect" + type="android.media.AudioEffect" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="type" type="java.util.UUID"> +</parameter> +<parameter name="uuid" type="java.util.UUID"> +</parameter> +<parameter name="priority" type="int"> +</parameter> +<parameter name="audioSession" type="int"> +</parameter> +<exception name="IllegalArgumentException" type="java.lang.IllegalArgumentException"> +</exception> +<exception name="RuntimeException" type="java.lang.RuntimeException"> +</exception> +<exception name="UnsupportedOperationException" type="java.lang.UnsupportedOperationException"> +</exception> +</constructor> +<method name="byteArrayToInt" + return="int" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="valueBuf" type="byte[]"> +</parameter> +</method> +<method name="byteArrayToInt" + return="int" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="valueBuf" type="byte[]"> +</parameter> +<parameter name="offset" type="int"> +</parameter> +</method> +<method name="byteArrayToShort" + return="short" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="valueBuf" type="byte[]"> +</parameter> +</method> +<method name="byteArrayToShort" + return="short" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="valueBuf" type="byte[]"> +</parameter> +<parameter name="offset" type="int"> +</parameter> +</method> +<method name="checkState" + return="void" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="methodName" type="java.lang.String"> +</parameter> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +</method> +<method name="checkStatus" + return="void" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="status" type="int"> +</parameter> +</method> +<method name="command" + return="int" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="cmdCode" type="int"> +</parameter> +<parameter name="command" type="byte[]"> +</parameter> +<parameter name="reply" type="byte[]"> +</parameter> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +</method> +<method name="concatArrays" + return="byte[]" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="arrays" type="byte..."> +</parameter> +</method> +<method name="getDescriptor" + return="android.media.AudioEffect.Descriptor" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +</method> +<method name="getEnabled" + return="boolean" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +</method> +<method name="getId" + return="int" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +</method> +<method name="getParameter" + return="int" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="param" type="byte[]"> +</parameter> +<parameter name="value" type="byte[]"> +</parameter> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +</method> +<method name="getParameter" + return="int" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="param" type="int"> +</parameter> +<parameter name="value" type="byte[]"> +</parameter> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +</method> +<method name="getParameter" + return="int" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="param" type="int"> +</parameter> +<parameter name="value" type="int[]"> +</parameter> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +</method> +<method name="getParameter" + return="int" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="param" type="int"> +</parameter> +<parameter name="value" type="short[]"> +</parameter> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +</method> +<method name="getParameter" + return="int" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="param" type="int[]"> +</parameter> +<parameter name="value" type="int[]"> +</parameter> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +</method> +<method name="getParameter" + return="int" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="param" type="int[]"> +</parameter> +<parameter name="value" type="short[]"> +</parameter> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +</method> +<method name="getParameter" + return="int" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="param" type="int[]"> +</parameter> +<parameter name="value" type="byte[]"> +</parameter> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +</method> +<method name="hasControl" + return="boolean" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +</method> +<method name="intToByteArray" + return="byte[]" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="value" type="int"> +</parameter> +</method> +<method name="queryEffects" + return="android.media.AudioEffect.Descriptor[]" + abstract="false" + native="false" + synchronized="false" + static="true" + final="false" + deprecated="not deprecated" + visibility="public" +> +</method> +<method name="release" + return="void" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +</method> +<method name="setControlStatusListener" + return="void" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="listener" type="android.media.AudioEffect.OnControlStatusChangeListener"> +</parameter> +</method> +<method name="setEnableStatusListener" + return="void" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="listener" type="android.media.AudioEffect.OnEnableStatusChangeListener"> +</parameter> +</method> +<method name="setEnabled" + return="int" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="enabled" type="boolean"> +</parameter> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +</method> +<method name="setParameter" + return="int" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="param" type="byte[]"> +</parameter> +<parameter name="value" type="byte[]"> +</parameter> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +</method> +<method name="setParameter" + return="int" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="param" type="int"> +</parameter> +<parameter name="value" type="int"> +</parameter> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +</method> +<method name="setParameter" + return="int" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="param" type="int"> +</parameter> +<parameter name="value" type="short"> +</parameter> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +</method> +<method name="setParameter" + return="int" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="param" type="int"> +</parameter> +<parameter name="value" type="byte[]"> +</parameter> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +</method> +<method name="setParameter" + return="int" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="param" type="int[]"> +</parameter> +<parameter name="value" type="int[]"> +</parameter> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +</method> +<method name="setParameter" + return="int" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="param" type="int[]"> +</parameter> +<parameter name="value" type="short[]"> +</parameter> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +</method> +<method name="setParameter" + return="int" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="param" type="int[]"> +</parameter> +<parameter name="value" type="byte[]"> +</parameter> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +</method> +<method name="setParameterListener" + return="void" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="listener" type="android.media.AudioEffect.OnParameterChangeListener"> +</parameter> +</method> +<method name="shortToByteArray" + return="byte[]" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="value" type="short"> +</parameter> +</method> +<field name="ALREADY_EXISTS" + type="int" + transient="false" + volatile="false" + value="-2" + static="true" + final="true" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="EFFECT_AUXILIARY" + type="java.lang.String" + transient="false" + volatile="false" + value=""Auxiliary"" + static="true" + final="true" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="EFFECT_INSERT" + type="java.lang.String" + transient="false" + volatile="false" + value=""Insert"" + static="true" + final="true" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="EFFECT_TYPE_BASS_BOOST" + type="java.util.UUID" + transient="false" + volatile="false" + static="true" + final="true" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="EFFECT_TYPE_ENV_REVERB" + type="java.util.UUID" + transient="false" + volatile="false" + static="true" + final="true" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="EFFECT_TYPE_EQUALIZER" + type="java.util.UUID" + transient="false" + volatile="false" + static="true" + final="true" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="EFFECT_TYPE_NULL" + type="java.util.UUID" + transient="false" + volatile="false" + static="true" + final="true" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="EFFECT_TYPE_PRESET_REVERB" + type="java.util.UUID" + transient="false" + volatile="false" + static="true" + final="true" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="EFFECT_TYPE_VIRTUALIZER" + type="java.util.UUID" + transient="false" + volatile="false" + static="true" + final="true" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="ERROR" + type="int" + transient="false" + volatile="false" + value="-1" + static="true" + final="true" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="ERROR_BAD_VALUE" + type="int" + transient="false" + volatile="false" + value="-4" + static="true" + final="true" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="ERROR_DEAD_OBJECT" + type="int" + transient="false" + volatile="false" + value="-7" + static="true" + final="true" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="ERROR_INVALID_OPERATION" + type="int" + transient="false" + volatile="false" + value="-5" + static="true" + final="true" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="ERROR_NO_INIT" + type="int" + transient="false" + volatile="false" + value="-3" + static="true" + final="true" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="ERROR_NO_MEMORY" + type="int" + transient="false" + volatile="false" + value="-6" + static="true" + final="true" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="NATIVE_EVENT_CONTROL_STATUS" + type="int" + transient="false" + volatile="false" + value="1" + static="true" + final="true" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="NATIVE_EVENT_ENABLED_STATUS" + type="int" + transient="false" + volatile="false" + value="0" + static="true" + final="true" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="NATIVE_EVENT_PARAMETER_CHANGED" + type="int" + transient="false" + volatile="false" + value="2" + static="true" + final="true" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="STATE_INITIALIZED" + type="int" + transient="false" + volatile="false" + value="1" + static="true" + final="true" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="STATE_UNINITIALIZED" + type="int" + transient="false" + volatile="false" + value="0" + static="true" + final="true" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="SUCCESS" + type="int" + transient="false" + volatile="false" + value="0" + static="true" + final="true" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="mControlChangeStatusListener" + type="android.media.AudioEffect.OnControlStatusChangeListener" + transient="false" + volatile="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="mEnableStatusChangeListener" + type="android.media.AudioEffect.OnEnableStatusChangeListener" + transient="false" + volatile="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="mId" + type="int" + transient="false" + volatile="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="mListenerLock" + type="java.lang.Object" + transient="false" + volatile="false" + static="false" + final="true" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="mNativeEventHandler" + type="android.media.AudioEffect.NativeEventHandler" + transient="false" + volatile="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="mParameterChangeListener" + type="android.media.AudioEffect.OnParameterChangeListener" + transient="false" + volatile="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="mState" + type="int" + transient="false" + volatile="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="mStateLock" + type="java.lang.Object" + transient="false" + volatile="false" + static="false" + final="true" + deprecated="not deprecated" + visibility="public" +> +</field> +</class> +<class name="AudioEffect.Descriptor" + extends="java.lang.Object" + abstract="false" + static="true" + final="false" + deprecated="not deprecated" + visibility="public" +> +<constructor name="AudioEffect.Descriptor" + type="android.media.AudioEffect.Descriptor" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +</constructor> +<constructor name="AudioEffect.Descriptor" + type="android.media.AudioEffect.Descriptor" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="type" type="java.lang.String"> +</parameter> +<parameter name="uuid" type="java.lang.String"> +</parameter> +<parameter name="connectMode" type="java.lang.String"> +</parameter> +<parameter name="name" type="java.lang.String"> +</parameter> +<parameter name="implementor" type="java.lang.String"> +</parameter> +</constructor> +<field name="mConnectMode" + type="java.lang.String" + transient="false" + volatile="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="mImplementor" + type="java.lang.String" + transient="false" + volatile="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="mName" + type="java.lang.String" + transient="false" + volatile="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="mType" + type="java.util.UUID" + transient="false" + volatile="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="mUuid" + type="java.util.UUID" + transient="false" + volatile="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +</field> +</class> +<class name="AudioEffect.NativeEventHandler" + extends="android.os.Handler" + abstract="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="private" +> +<constructor name="AudioEffect.NativeEventHandler" + type="android.media.AudioEffect.NativeEventHandler" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="ae" type="android.media.AudioEffect"> +</parameter> +<parameter name="looper" type="android.os.Looper"> +</parameter> +</constructor> +</class> +<interface name="AudioEffect.OnControlStatusChangeListener" + abstract="true" + static="true" + final="false" + deprecated="not deprecated" + visibility="public" +> +<method name="onControlStatusChange" + return="void" + abstract="true" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="effect" type="android.media.AudioEffect"> +</parameter> +<parameter name="controlGranted" type="boolean"> +</parameter> +</method> +</interface> +<interface name="AudioEffect.OnEnableStatusChangeListener" + abstract="true" + static="true" + final="false" + deprecated="not deprecated" + visibility="public" +> +<method name="onEnableStatusChange" + return="void" + abstract="true" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="effect" type="android.media.AudioEffect"> +</parameter> +<parameter name="enabled" type="boolean"> +</parameter> +</method> +</interface> +<interface name="AudioEffect.OnParameterChangeListener" + abstract="true" + static="true" + final="false" + deprecated="not deprecated" + visibility="public" +> +<method name="onParameterChange" + return="void" + abstract="true" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="effect" type="android.media.AudioEffect"> +</parameter> +<parameter name="status" type="int"> +</parameter> +<parameter name="param" type="byte[]"> +</parameter> +<parameter name="value" type="byte[]"> +</parameter> +</method> +</interface> <class name="AudioFormat" extends="java.lang.Object" abstract="false" @@ -86787,6 +87810,43 @@ <exception name="IllegalArgumentException" type="java.lang.IllegalArgumentException"> </exception> </constructor> +<constructor name="AudioTrack" + type="android.media.AudioTrack" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="streamType" type="int"> +</parameter> +<parameter name="sampleRateInHz" type="int"> +</parameter> +<parameter name="channelConfig" type="int"> +</parameter> +<parameter name="audioFormat" type="int"> +</parameter> +<parameter name="bufferSizeInBytes" type="int"> +</parameter> +<parameter name="mode" type="int"> +</parameter> +<parameter name="sessionId" type="int"> +</parameter> +<exception name="IllegalArgumentException" type="java.lang.IllegalArgumentException"> +</exception> +</constructor> +<method name="attachAuxEffect" + return="int" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="effectId" type="int"> +</parameter> +</method> <method name="flush" return="void" abstract="false" @@ -86809,6 +87869,17 @@ visibility="public" > </method> +<method name="getAudioSessionId" + return="int" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +</method> <method name="getChannelConfiguration" return="int" abstract="false" @@ -87030,6 +88101,19 @@ visibility="public" > </method> +<method name="setAuxEffectSendLevel" + return="int" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="level" type="float"> +</parameter> +</method> <method name="setLoopPoints" return="int" abstract="false" @@ -87369,6 +88453,217 @@ </parameter> </method> </interface> +<class name="BassBoost" + extends="android.media.AudioEffect" + abstract="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<constructor name="BassBoost" + type="android.media.BassBoost" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="priority" type="int"> +</parameter> +<parameter name="audioSession" type="int"> +</parameter> +<exception name="IllegalArgumentException" type="java.lang.IllegalArgumentException"> +</exception> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +<exception name="RuntimeException" type="java.lang.RuntimeException"> +</exception> +<exception name="UnsupportedOperationException" type="java.lang.UnsupportedOperationException"> +</exception> +</constructor> +<method name="getProperties" + return="android.media.BassBoost.Settings" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<exception name="IllegalArgumentException" type="java.lang.IllegalArgumentException"> +</exception> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +<exception name="UnsupportedOperationException" type="java.lang.UnsupportedOperationException"> +</exception> +</method> +<method name="getRoundedStrength" + return="short" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<exception name="IllegalArgumentException" type="java.lang.IllegalArgumentException"> +</exception> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +<exception name="UnsupportedOperationException" type="java.lang.UnsupportedOperationException"> +</exception> +</method> +<method name="getStrengthSupported" + return="boolean" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +</method> +<method name="setParameterListener" + return="void" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="listener" type="android.media.BassBoost.OnParameterChangeListener"> +</parameter> +</method> +<method name="setProperties" + return="void" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="settings" type="android.media.BassBoost.Settings"> +</parameter> +<exception name="IllegalArgumentException" type="java.lang.IllegalArgumentException"> +</exception> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +<exception name="UnsupportedOperationException" type="java.lang.UnsupportedOperationException"> +</exception> +</method> +<method name="setStrength" + return="void" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="strength" type="short"> +</parameter> +<exception name="IllegalArgumentException" type="java.lang.IllegalArgumentException"> +</exception> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +<exception name="UnsupportedOperationException" type="java.lang.UnsupportedOperationException"> +</exception> +</method> +<field name="PARAM_STRENGTH" + type="int" + transient="false" + volatile="false" + value="1" + static="true" + final="true" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="PARAM_STRENGTH_SUPPORTED" + type="int" + transient="false" + volatile="false" + value="0" + static="true" + final="true" + deprecated="not deprecated" + visibility="public" +> +</field> +</class> +<interface name="BassBoost.OnParameterChangeListener" + abstract="true" + static="true" + final="false" + deprecated="not deprecated" + visibility="public" +> +<method name="onParameterChange" + return="void" + abstract="true" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="effect" type="android.media.BassBoost"> +</parameter> +<parameter name="status" type="int"> +</parameter> +<parameter name="param" type="int"> +</parameter> +<parameter name="value" type="short"> +</parameter> +</method> +</interface> +<class name="BassBoost.Settings" + extends="java.lang.Object" + abstract="false" + static="true" + final="false" + deprecated="not deprecated" + visibility="public" +> +<constructor name="BassBoost.Settings" + type="android.media.BassBoost.Settings" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +</constructor> +<constructor name="BassBoost.Settings" + type="android.media.BassBoost.Settings" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="settings" type="java.lang.String"> +</parameter> +</constructor> +<field name="strength" + type="short" + transient="false" + volatile="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +</field> +</class> <class name="CamcorderProfile" extends="java.lang.Object" abstract="false" @@ -87626,6 +88921,1178 @@ > </field> </class> +<class name="EnvironmentalReverb" + extends="android.media.AudioEffect" + abstract="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<constructor name="EnvironmentalReverb" + type="android.media.EnvironmentalReverb" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="priority" type="int"> +</parameter> +<parameter name="audioSession" type="int"> +</parameter> +<exception name="IllegalArgumentException" type="java.lang.IllegalArgumentException"> +</exception> +<exception name="RuntimeException" type="java.lang.RuntimeException"> +</exception> +<exception name="UnsupportedOperationException" type="java.lang.UnsupportedOperationException"> +</exception> +</constructor> +<method name="getDecayHFRatio" + return="short" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<exception name="IllegalArgumentException" type="java.lang.IllegalArgumentException"> +</exception> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +<exception name="UnsupportedOperationException" type="java.lang.UnsupportedOperationException"> +</exception> +</method> +<method name="getDecayTime" + return="int" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<exception name="IllegalArgumentException" type="java.lang.IllegalArgumentException"> +</exception> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +<exception name="UnsupportedOperationException" type="java.lang.UnsupportedOperationException"> +</exception> +</method> +<method name="getDensity" + return="short" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<exception name="IllegalArgumentException" type="java.lang.IllegalArgumentException"> +</exception> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +<exception name="UnsupportedOperationException" type="java.lang.UnsupportedOperationException"> +</exception> +</method> +<method name="getDiffusion" + return="short" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<exception name="IllegalArgumentException" type="java.lang.IllegalArgumentException"> +</exception> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +<exception name="UnsupportedOperationException" type="java.lang.UnsupportedOperationException"> +</exception> +</method> +<method name="getProperties" + return="android.media.EnvironmentalReverb.Settings" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<exception name="IllegalArgumentException" type="java.lang.IllegalArgumentException"> +</exception> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +<exception name="UnsupportedOperationException" type="java.lang.UnsupportedOperationException"> +</exception> +</method> +<method name="getReflectionsDelay" + return="int" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<exception name="IllegalArgumentException" type="java.lang.IllegalArgumentException"> +</exception> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +<exception name="UnsupportedOperationException" type="java.lang.UnsupportedOperationException"> +</exception> +</method> +<method name="getReflectionsLevel" + return="short" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<exception name="IllegalArgumentException" type="java.lang.IllegalArgumentException"> +</exception> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +<exception name="UnsupportedOperationException" type="java.lang.UnsupportedOperationException"> +</exception> +</method> +<method name="getReverbDelay" + return="int" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<exception name="IllegalArgumentException" type="java.lang.IllegalArgumentException"> +</exception> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +<exception name="UnsupportedOperationException" type="java.lang.UnsupportedOperationException"> +</exception> +</method> +<method name="getReverbLevel" + return="short" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<exception name="IllegalArgumentException" type="java.lang.IllegalArgumentException"> +</exception> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +<exception name="UnsupportedOperationException" type="java.lang.UnsupportedOperationException"> +</exception> +</method> +<method name="getRoomHFLevel" + return="short" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<exception name="IllegalArgumentException" type="java.lang.IllegalArgumentException"> +</exception> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +<exception name="UnsupportedOperationException" type="java.lang.UnsupportedOperationException"> +</exception> +</method> +<method name="getRoomLevel" + return="short" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<exception name="IllegalArgumentException" type="java.lang.IllegalArgumentException"> +</exception> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +<exception name="UnsupportedOperationException" type="java.lang.UnsupportedOperationException"> +</exception> +</method> +<method name="setDecayHFRatio" + return="void" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="decayHFRatio" type="short"> +</parameter> +<exception name="IllegalArgumentException" type="java.lang.IllegalArgumentException"> +</exception> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +<exception name="UnsupportedOperationException" type="java.lang.UnsupportedOperationException"> +</exception> +</method> +<method name="setDecayTime" + return="void" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="decayTime" type="int"> +</parameter> +<exception name="IllegalArgumentException" type="java.lang.IllegalArgumentException"> +</exception> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +<exception name="UnsupportedOperationException" type="java.lang.UnsupportedOperationException"> +</exception> +</method> +<method name="setDensity" + return="void" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="density" type="short"> +</parameter> +<exception name="IllegalArgumentException" type="java.lang.IllegalArgumentException"> +</exception> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +<exception name="UnsupportedOperationException" type="java.lang.UnsupportedOperationException"> +</exception> +</method> +<method name="setDiffusion" + return="void" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="diffusion" type="short"> +</parameter> +<exception name="IllegalArgumentException" type="java.lang.IllegalArgumentException"> +</exception> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +<exception name="UnsupportedOperationException" type="java.lang.UnsupportedOperationException"> +</exception> +</method> +<method name="setParameterListener" + return="void" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="listener" type="android.media.EnvironmentalReverb.OnParameterChangeListener"> +</parameter> +</method> +<method name="setProperties" + return="void" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="settings" type="android.media.EnvironmentalReverb.Settings"> +</parameter> +<exception name="IllegalArgumentException" type="java.lang.IllegalArgumentException"> +</exception> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +<exception name="UnsupportedOperationException" type="java.lang.UnsupportedOperationException"> +</exception> +</method> +<method name="setReflectionsDelay" + return="void" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="reflectionsDelay" type="int"> +</parameter> +<exception name="IllegalArgumentException" type="java.lang.IllegalArgumentException"> +</exception> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +<exception name="UnsupportedOperationException" type="java.lang.UnsupportedOperationException"> +</exception> +</method> +<method name="setReflectionsLevel" + return="void" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="reflectionsLevel" type="short"> +</parameter> +<exception name="IllegalArgumentException" type="java.lang.IllegalArgumentException"> +</exception> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +<exception name="UnsupportedOperationException" type="java.lang.UnsupportedOperationException"> +</exception> +</method> +<method name="setReverbDelay" + return="void" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="reverbDelay" type="int"> +</parameter> +<exception name="IllegalArgumentException" type="java.lang.IllegalArgumentException"> +</exception> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +<exception name="UnsupportedOperationException" type="java.lang.UnsupportedOperationException"> +</exception> +</method> +<method name="setReverbLevel" + return="void" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="reverbLevel" type="short"> +</parameter> +<exception name="IllegalArgumentException" type="java.lang.IllegalArgumentException"> +</exception> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +<exception name="UnsupportedOperationException" type="java.lang.UnsupportedOperationException"> +</exception> +</method> +<method name="setRoomHFLevel" + return="void" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="roomHF" type="short"> +</parameter> +<exception name="IllegalArgumentException" type="java.lang.IllegalArgumentException"> +</exception> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +<exception name="UnsupportedOperationException" type="java.lang.UnsupportedOperationException"> +</exception> +</method> +<method name="setRoomLevel" + return="void" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="room" type="short"> +</parameter> +<exception name="IllegalArgumentException" type="java.lang.IllegalArgumentException"> +</exception> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +<exception name="UnsupportedOperationException" type="java.lang.UnsupportedOperationException"> +</exception> +</method> +<field name="PARAM_DECAY_HF_RATIO" + type="int" + transient="false" + volatile="false" + value="3" + static="true" + final="true" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="PARAM_DECAY_TIME" + type="int" + transient="false" + volatile="false" + value="2" + static="true" + final="true" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="PARAM_DENSITY" + type="int" + transient="false" + volatile="false" + value="9" + static="true" + final="true" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="PARAM_DIFFUSION" + type="int" + transient="false" + volatile="false" + value="8" + static="true" + final="true" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="PARAM_REFLECTIONS_DELAY" + type="int" + transient="false" + volatile="false" + value="5" + static="true" + final="true" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="PARAM_REFLECTIONS_LEVEL" + type="int" + transient="false" + volatile="false" + value="4" + static="true" + final="true" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="PARAM_REVERB_DELAY" + type="int" + transient="false" + volatile="false" + value="7" + static="true" + final="true" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="PARAM_REVERB_LEVEL" + type="int" + transient="false" + volatile="false" + value="6" + static="true" + final="true" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="PARAM_ROOM_HF_LEVEL" + type="int" + transient="false" + volatile="false" + value="1" + static="true" + final="true" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="PARAM_ROOM_LEVEL" + type="int" + transient="false" + volatile="false" + value="0" + static="true" + final="true" + deprecated="not deprecated" + visibility="public" +> +</field> +</class> +<interface name="EnvironmentalReverb.OnParameterChangeListener" + abstract="true" + static="true" + final="false" + deprecated="not deprecated" + visibility="public" +> +<method name="onParameterChange" + return="void" + abstract="true" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="effect" type="android.media.EnvironmentalReverb"> +</parameter> +<parameter name="status" type="int"> +</parameter> +<parameter name="param" type="int"> +</parameter> +<parameter name="value" type="int"> +</parameter> +</method> +</interface> +<class name="EnvironmentalReverb.Settings" + extends="java.lang.Object" + abstract="false" + static="true" + final="false" + deprecated="not deprecated" + visibility="public" +> +<constructor name="EnvironmentalReverb.Settings" + type="android.media.EnvironmentalReverb.Settings" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +</constructor> +<constructor name="EnvironmentalReverb.Settings" + type="android.media.EnvironmentalReverb.Settings" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="settings" type="java.lang.String"> +</parameter> +</constructor> +<field name="decayHFRatio" + type="short" + transient="false" + volatile="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="decayTime" + type="int" + transient="false" + volatile="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="density" + type="short" + transient="false" + volatile="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="diffusion" + type="short" + transient="false" + volatile="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="reflectionsDelay" + type="int" + transient="false" + volatile="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="reflectionsLevel" + type="short" + transient="false" + volatile="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="reverbDelay" + type="int" + transient="false" + volatile="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="reverbLevel" + type="short" + transient="false" + volatile="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="roomHFLevel" + type="short" + transient="false" + volatile="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="roomLevel" + type="short" + transient="false" + volatile="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +</field> +</class> +<class name="Equalizer" + extends="android.media.AudioEffect" + abstract="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<constructor name="Equalizer" + type="android.media.Equalizer" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="priority" type="int"> +</parameter> +<parameter name="audioSession" type="int"> +</parameter> +<exception name="IllegalArgumentException" type="java.lang.IllegalArgumentException"> +</exception> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +<exception name="RuntimeException" type="java.lang.RuntimeException"> +</exception> +<exception name="UnsupportedOperationException" type="java.lang.UnsupportedOperationException"> +</exception> +</constructor> +<method name="getBand" + return="short" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="frequency" type="int"> +</parameter> +<exception name="IllegalArgumentException" type="java.lang.IllegalArgumentException"> +</exception> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +<exception name="UnsupportedOperationException" type="java.lang.UnsupportedOperationException"> +</exception> +</method> +<method name="getBandFreqRange" + return="int[]" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="band" type="short"> +</parameter> +<exception name="IllegalArgumentException" type="java.lang.IllegalArgumentException"> +</exception> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +<exception name="UnsupportedOperationException" type="java.lang.UnsupportedOperationException"> +</exception> +</method> +<method name="getBandLevel" + return="short" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="band" type="short"> +</parameter> +<exception name="IllegalArgumentException" type="java.lang.IllegalArgumentException"> +</exception> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +<exception name="UnsupportedOperationException" type="java.lang.UnsupportedOperationException"> +</exception> +</method> +<method name="getBandLevelRange" + return="short[]" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<exception name="IllegalArgumentException" type="java.lang.IllegalArgumentException"> +</exception> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +<exception name="UnsupportedOperationException" type="java.lang.UnsupportedOperationException"> +</exception> +</method> +<method name="getCenterFreq" + return="int" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="band" type="short"> +</parameter> +<exception name="IllegalArgumentException" type="java.lang.IllegalArgumentException"> +</exception> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +<exception name="UnsupportedOperationException" type="java.lang.UnsupportedOperationException"> +</exception> +</method> +<method name="getCurrentPreset" + return="short" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<exception name="IllegalArgumentException" type="java.lang.IllegalArgumentException"> +</exception> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +<exception name="UnsupportedOperationException" type="java.lang.UnsupportedOperationException"> +</exception> +</method> +<method name="getNumberOfBands" + return="short" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<exception name="IllegalArgumentException" type="java.lang.IllegalArgumentException"> +</exception> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +<exception name="UnsupportedOperationException" type="java.lang.UnsupportedOperationException"> +</exception> +</method> +<method name="getNumberOfPresets" + return="short" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<exception name="IllegalArgumentException" type="java.lang.IllegalArgumentException"> +</exception> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +<exception name="UnsupportedOperationException" type="java.lang.UnsupportedOperationException"> +</exception> +</method> +<method name="getPresetName" + return="java.lang.String" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="preset" type="short"> +</parameter> +</method> +<method name="getProperties" + return="android.media.Equalizer.Settings" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<exception name="IllegalArgumentException" type="java.lang.IllegalArgumentException"> +</exception> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +<exception name="UnsupportedOperationException" type="java.lang.UnsupportedOperationException"> +</exception> +</method> +<method name="setBandLevel" + return="void" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="band" type="short"> +</parameter> +<parameter name="level" type="short"> +</parameter> +<exception name="IllegalArgumentException" type="java.lang.IllegalArgumentException"> +</exception> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +<exception name="UnsupportedOperationException" type="java.lang.UnsupportedOperationException"> +</exception> +</method> +<method name="setParameterListener" + return="void" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="listener" type="android.media.Equalizer.OnParameterChangeListener"> +</parameter> +</method> +<method name="setProperties" + return="void" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="settings" type="android.media.Equalizer.Settings"> +</parameter> +<exception name="IllegalArgumentException" type="java.lang.IllegalArgumentException"> +</exception> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +<exception name="UnsupportedOperationException" type="java.lang.UnsupportedOperationException"> +</exception> +</method> +<method name="usePreset" + return="void" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="preset" type="short"> +</parameter> +<exception name="IllegalArgumentException" type="java.lang.IllegalArgumentException"> +</exception> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +<exception name="UnsupportedOperationException" type="java.lang.UnsupportedOperationException"> +</exception> +</method> +<field name="PARAM_BAND_FREQ_RANGE" + type="int" + transient="false" + volatile="false" + value="4" + static="true" + final="true" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="PARAM_BAND_LEVEL" + type="int" + transient="false" + volatile="false" + value="2" + static="true" + final="true" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="PARAM_CENTER_FREQ" + type="int" + transient="false" + volatile="false" + value="3" + static="true" + final="true" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="PARAM_CURRENT_PRESET" + type="int" + transient="false" + volatile="false" + value="6" + static="true" + final="true" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="PARAM_GET_BAND" + type="int" + transient="false" + volatile="false" + value="5" + static="true" + final="true" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="PARAM_GET_NUM_OF_PRESETS" + type="int" + transient="false" + volatile="false" + value="7" + static="true" + final="true" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="PARAM_GET_PRESET_NAME" + type="int" + transient="false" + volatile="false" + value="8" + static="true" + final="true" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="PARAM_LEVEL_RANGE" + type="int" + transient="false" + volatile="false" + value="1" + static="true" + final="true" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="PARAM_NUM_BANDS" + type="int" + transient="false" + volatile="false" + value="0" + static="true" + final="true" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="PARAM_STRING_SIZE_MAX" + type="int" + transient="false" + volatile="false" + value="32" + static="true" + final="true" + deprecated="not deprecated" + visibility="public" +> +</field> +</class> +<interface name="Equalizer.OnParameterChangeListener" + abstract="true" + static="true" + final="false" + deprecated="not deprecated" + visibility="public" +> +<method name="onParameterChange" + return="void" + abstract="true" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="effect" type="android.media.Equalizer"> +</parameter> +<parameter name="status" type="int"> +</parameter> +<parameter name="param1" type="int"> +</parameter> +<parameter name="param2" type="int"> +</parameter> +<parameter name="value" type="int"> +</parameter> +</method> +</interface> +<class name="Equalizer.Settings" + extends="java.lang.Object" + abstract="false" + static="true" + final="false" + deprecated="not deprecated" + visibility="public" +> +<constructor name="Equalizer.Settings" + type="android.media.Equalizer.Settings" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +</constructor> +<constructor name="Equalizer.Settings" + type="android.media.Equalizer.Settings" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="settings" type="java.lang.String"> +</parameter> +</constructor> +<field name="bandLevels" + type="short[]" + transient="false" + volatile="false" + value="null" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="curPreset" + type="short" + transient="false" + volatile="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="numBands" + type="short" + transient="false" + volatile="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +</field> +</class> <class name="ExifInterface" extends="java.lang.Object" abstract="false" @@ -88577,6 +91044,19 @@ visibility="public" > </constructor> +<method name="attachAuxEffect" + return="void" + abstract="false" + native="true" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="effectId" type="int"> +</parameter> +</method> <method name="create" return="android.media.MediaPlayer" abstract="false" @@ -88624,6 +91104,17 @@ <parameter name="resid" type="int"> </parameter> </method> +<method name="getAudioSessionId" + return="int" + abstract="false" + native="true" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +</method> <method name="getCurrentPosition" return="int" abstract="false" @@ -88768,6 +91259,23 @@ <exception name="IllegalStateException" type="java.lang.IllegalStateException"> </exception> </method> +<method name="setAudioSessionId" + return="void" + abstract="false" + native="true" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="sessionId" type="int"> +</parameter> +<exception name="IllegalArgumentException" type="java.lang.IllegalArgumentException"> +</exception> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +</method> <method name="setAudioStreamType" return="void" abstract="false" @@ -88781,6 +91289,19 @@ <parameter name="streamtype" type="int"> </parameter> </method> +<method name="setAuxEffectSendLevel" + return="void" + abstract="false" + native="true" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="level" type="float"> +</parameter> +</method> <method name="setDataSource" return="void" abstract="false" @@ -90236,6 +92757,270 @@ </parameter> </method> </interface> +<class name="PresetReverb" + extends="android.media.AudioEffect" + abstract="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<constructor name="PresetReverb" + type="android.media.PresetReverb" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="priority" type="int"> +</parameter> +<parameter name="audioSession" type="int"> +</parameter> +<exception name="IllegalArgumentException" type="java.lang.IllegalArgumentException"> +</exception> +<exception name="RuntimeException" type="java.lang.RuntimeException"> +</exception> +<exception name="UnsupportedOperationException" type="java.lang.UnsupportedOperationException"> +</exception> +</constructor> +<method name="getPreset" + return="short" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<exception name="IllegalArgumentException" type="java.lang.IllegalArgumentException"> +</exception> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +<exception name="UnsupportedOperationException" type="java.lang.UnsupportedOperationException"> +</exception> +</method> +<method name="getProperties" + return="android.media.PresetReverb.Settings" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<exception name="IllegalArgumentException" type="java.lang.IllegalArgumentException"> +</exception> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +<exception name="UnsupportedOperationException" type="java.lang.UnsupportedOperationException"> +</exception> +</method> +<method name="setParameterListener" + return="void" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="listener" type="android.media.PresetReverb.OnParameterChangeListener"> +</parameter> +</method> +<method name="setPreset" + return="void" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="preset" type="short"> +</parameter> +<exception name="IllegalArgumentException" type="java.lang.IllegalArgumentException"> +</exception> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +<exception name="UnsupportedOperationException" type="java.lang.UnsupportedOperationException"> +</exception> +</method> +<method name="setProperties" + return="void" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="settings" type="android.media.PresetReverb.Settings"> +</parameter> +<exception name="IllegalArgumentException" type="java.lang.IllegalArgumentException"> +</exception> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +<exception name="UnsupportedOperationException" type="java.lang.UnsupportedOperationException"> +</exception> +</method> +<field name="PARAM_PRESET" + type="int" + transient="false" + volatile="false" + value="0" + static="true" + final="true" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="PRESET_LARGEHALL" + type="int" + transient="false" + volatile="false" + value="5" + static="true" + final="true" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="PRESET_LARGEROOM" + type="int" + transient="false" + volatile="false" + value="3" + static="true" + final="true" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="PRESET_MEDIUMHALL" + type="int" + transient="false" + volatile="false" + value="4" + static="true" + final="true" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="PRESET_MEDIUMROOM" + type="int" + transient="false" + volatile="false" + value="2" + static="true" + final="true" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="PRESET_NONE" + type="int" + transient="false" + volatile="false" + value="0" + static="true" + final="true" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="PRESET_PLATE" + type="int" + transient="false" + volatile="false" + value="6" + static="true" + final="true" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="PRESET_SMALLROOM" + type="int" + transient="false" + volatile="false" + value="1" + static="true" + final="true" + deprecated="not deprecated" + visibility="public" +> +</field> +</class> +<interface name="PresetReverb.OnParameterChangeListener" + abstract="true" + static="true" + final="false" + deprecated="not deprecated" + visibility="public" +> +<method name="onParameterChange" + return="void" + abstract="true" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="effect" type="android.media.PresetReverb"> +</parameter> +<parameter name="status" type="int"> +</parameter> +<parameter name="param" type="int"> +</parameter> +<parameter name="value" type="short"> +</parameter> +</method> +</interface> +<class name="PresetReverb.Settings" + extends="java.lang.Object" + abstract="false" + static="true" + final="false" + deprecated="not deprecated" + visibility="public" +> +<constructor name="PresetReverb.Settings" + type="android.media.PresetReverb.Settings" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +</constructor> +<constructor name="PresetReverb.Settings" + type="android.media.PresetReverb.Settings" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="settings" type="java.lang.String"> +</parameter> +</constructor> +<field name="preset" + type="short" + transient="false" + volatile="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +</field> +</class> <class name="Ringtone" extends="java.lang.Object" abstract="false" @@ -92310,6 +95095,552 @@ > </field> </class> +<class name="Virtualizer" + extends="android.media.AudioEffect" + abstract="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<constructor name="Virtualizer" + type="android.media.Virtualizer" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="priority" type="int"> +</parameter> +<parameter name="audioSession" type="int"> +</parameter> +<exception name="IllegalArgumentException" type="java.lang.IllegalArgumentException"> +</exception> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +<exception name="RuntimeException" type="java.lang.RuntimeException"> +</exception> +<exception name="UnsupportedOperationException" type="java.lang.UnsupportedOperationException"> +</exception> +</constructor> +<method name="getProperties" + return="android.media.Virtualizer.Settings" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<exception name="IllegalArgumentException" type="java.lang.IllegalArgumentException"> +</exception> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +<exception name="UnsupportedOperationException" type="java.lang.UnsupportedOperationException"> +</exception> +</method> +<method name="getRoundedStrength" + return="short" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<exception name="IllegalArgumentException" type="java.lang.IllegalArgumentException"> +</exception> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +<exception name="UnsupportedOperationException" type="java.lang.UnsupportedOperationException"> +</exception> +</method> +<method name="getStrengthSupported" + return="boolean" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +</method> +<method name="setParameterListener" + return="void" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="listener" type="android.media.Virtualizer.OnParameterChangeListener"> +</parameter> +</method> +<method name="setProperties" + return="void" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="settings" type="android.media.Virtualizer.Settings"> +</parameter> +<exception name="IllegalArgumentException" type="java.lang.IllegalArgumentException"> +</exception> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +<exception name="UnsupportedOperationException" type="java.lang.UnsupportedOperationException"> +</exception> +</method> +<method name="setStrength" + return="void" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="strength" type="short"> +</parameter> +<exception name="IllegalArgumentException" type="java.lang.IllegalArgumentException"> +</exception> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +<exception name="UnsupportedOperationException" type="java.lang.UnsupportedOperationException"> +</exception> +</method> +<field name="PARAM_STRENGTH" + type="int" + transient="false" + volatile="false" + value="1" + static="true" + final="true" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="PARAM_STRENGTH_SUPPORTED" + type="int" + transient="false" + volatile="false" + value="0" + static="true" + final="true" + deprecated="not deprecated" + visibility="public" +> +</field> +</class> +<interface name="Virtualizer.OnParameterChangeListener" + abstract="true" + static="true" + final="false" + deprecated="not deprecated" + visibility="public" +> +<method name="onParameterChange" + return="void" + abstract="true" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="effect" type="android.media.Virtualizer"> +</parameter> +<parameter name="status" type="int"> +</parameter> +<parameter name="param" type="int"> +</parameter> +<parameter name="value" type="short"> +</parameter> +</method> +</interface> +<class name="Virtualizer.Settings" + extends="java.lang.Object" + abstract="false" + static="true" + final="false" + deprecated="not deprecated" + visibility="public" +> +<constructor name="Virtualizer.Settings" + type="android.media.Virtualizer.Settings" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +</constructor> +<constructor name="Virtualizer.Settings" + type="android.media.Virtualizer.Settings" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="settings" type="java.lang.String"> +</parameter> +</constructor> +<field name="strength" + type="short" + transient="false" + volatile="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +</field> +</class> +<class name="Visualizer" + extends="java.lang.Object" + abstract="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<constructor name="Visualizer" + type="android.media.Visualizer" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="audioSession" type="int"> +</parameter> +<exception name="RuntimeException" type="java.lang.RuntimeException"> +</exception> +<exception name="UnsupportedOperationException" type="java.lang.UnsupportedOperationException"> +</exception> +</constructor> +<method name="getCaptureSize" + return="int" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +</method> +<method name="getCaptureSizeRange" + return="int[]" + abstract="false" + native="true" + synchronized="false" + static="true" + final="false" + deprecated="not deprecated" + visibility="public" +> +</method> +<method name="getEnabled" + return="boolean" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +</method> +<method name="getFft" + return="int" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="fft" type="byte[]"> +</parameter> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +</method> +<method name="getMaxCaptureRate" + return="int" + abstract="false" + native="true" + synchronized="false" + static="true" + final="false" + deprecated="not deprecated" + visibility="public" +> +</method> +<method name="getSamplingRate" + return="int" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +</method> +<method name="getWaveForm" + return="int" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="waveform" type="byte[]"> +</parameter> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +</method> +<method name="release" + return="void" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +</method> +<method name="setCaptureSize" + return="int" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="size" type="int"> +</parameter> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +</method> +<method name="setDataCaptureListener" + return="int" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="listener" type="android.media.Visualizer.OnDataCaptureListener"> +</parameter> +<parameter name="rate" type="int"> +</parameter> +<parameter name="waveform" type="boolean"> +</parameter> +<parameter name="fft" type="boolean"> +</parameter> +</method> +<method name="setEnabled" + return="int" + abstract="false" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="enabled" type="boolean"> +</parameter> +<exception name="IllegalStateException" type="java.lang.IllegalStateException"> +</exception> +</method> +<field name="ALREADY_EXISTS" + type="int" + transient="false" + volatile="false" + value="-2" + static="true" + final="true" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="ERROR" + type="int" + transient="false" + volatile="false" + value="-1" + static="true" + final="true" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="ERROR_BAD_VALUE" + type="int" + transient="false" + volatile="false" + value="-4" + static="true" + final="true" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="ERROR_DEAD_OBJECT" + type="int" + transient="false" + volatile="false" + value="-7" + static="true" + final="true" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="ERROR_INVALID_OPERATION" + type="int" + transient="false" + volatile="false" + value="-5" + static="true" + final="true" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="ERROR_NO_INIT" + type="int" + transient="false" + volatile="false" + value="-3" + static="true" + final="true" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="ERROR_NO_MEMORY" + type="int" + transient="false" + volatile="false" + value="-6" + static="true" + final="true" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="STATE_ENABLED" + type="int" + transient="false" + volatile="false" + value="2" + static="true" + final="true" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="STATE_INITIALIZED" + type="int" + transient="false" + volatile="false" + value="1" + static="true" + final="true" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="STATE_UNINITIALIZED" + type="int" + transient="false" + volatile="false" + value="0" + static="true" + final="true" + deprecated="not deprecated" + visibility="public" +> +</field> +<field name="SUCCESS" + type="int" + transient="false" + volatile="false" + value="0" + static="true" + final="true" + deprecated="not deprecated" + visibility="public" +> +</field> +</class> +<interface name="Visualizer.OnDataCaptureListener" + abstract="true" + static="true" + final="false" + deprecated="not deprecated" + visibility="public" +> +<method name="onFftDataCapture" + return="void" + abstract="true" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="visualizer" type="android.media.Visualizer"> +</parameter> +<parameter name="fft" type="byte[]"> +</parameter> +<parameter name="samplingRate" type="int"> +</parameter> +</method> +<method name="onWaveFormDataCapture" + return="void" + abstract="true" + native="false" + synchronized="false" + static="false" + final="false" + deprecated="not deprecated" + visibility="public" +> +<parameter name="visualizer" type="android.media.Visualizer"> +</parameter> +<parameter name="waveform" type="byte[]"> +</parameter> +<parameter name="samplingRate" type="int"> +</parameter> +</method> +</interface> </package> <package name="android.net" > diff --git a/media/java/android/media/AudioEffect.java b/media/java/android/media/AudioEffect.java index 053cc22..aed29c3 100644 --- a/media/java/android/media/AudioEffect.java +++ b/media/java/android/media/AudioEffect.java @@ -42,8 +42,6 @@ import java.util.UUID; * <p>If the effect is to be applied to a specific AudioTrack or MediaPlayer instance, * the application must specify the audio session ID of that instance when calling the AudioEffect * constructor. - * - * { @hide Pending API council review } */ public class AudioEffect { static { @@ -107,15 +105,15 @@ public class AudioEffect { /** * Event id for engine state change notification. */ - protected static final int NATIVE_EVENT_ENABLED_STATUS = 0; + public static final int NATIVE_EVENT_ENABLED_STATUS = 0; /** * Event id for engine control ownership change notification. */ - protected static final int NATIVE_EVENT_CONTROL_STATUS = 1; + public static final int NATIVE_EVENT_CONTROL_STATUS = 1; /** * Event id for engine parameter change notification. */ - protected static final int NATIVE_EVENT_PARAMETER_CHANGED = 2; + public static final int NATIVE_EVENT_PARAMETER_CHANGED = 2; /** * Successful operation. @@ -203,15 +201,15 @@ public class AudioEffect { /** * Indicates the state of the AudioEffect instance */ - protected int mState = STATE_UNINITIALIZED; + private int mState = STATE_UNINITIALIZED; /** * Lock to synchronize access to mState */ - protected final Object mStateLock = new Object(); + private final Object mStateLock = new Object(); /** * System wide unique effect ID */ - protected int mId; + private int mId; // accessed by native methods private int mNativeAudioEffect; @@ -227,27 +225,27 @@ public class AudioEffect { * * @see #setEnableStatusListener(OnEnableStatusChangeListener) */ - protected OnEnableStatusChangeListener mEnableStatusChangeListener = null; + private OnEnableStatusChangeListener mEnableStatusChangeListener = null; /** * Listener for effect engine control ownership change notifications. * * @see #setControlStatusListener(OnControlStatusChangeListener) */ - protected OnControlStatusChangeListener mControlChangeStatusListener = null; + private OnControlStatusChangeListener mControlChangeStatusListener = null; /** * Listener for effect engine control ownership change notifications. * * @see #setParameterListener(OnParameterChangeListener) */ - protected OnParameterChangeListener mParameterChangeListener = null; + private OnParameterChangeListener mParameterChangeListener = null; /** * Lock to protect listeners updates against event notifications */ - protected final Object mListenerLock = new Object(); + public final Object mListenerLock = new Object(); /** * Handler for events coming from the native code */ - protected NativeEventHandler mNativeEventHandler = null; + public NativeEventHandler mNativeEventHandler = null; // -------------------------------------------------------------------------- // Constructor, Finalize @@ -275,7 +273,7 @@ public class AudioEffect { * how much the requesting application needs control of effect * parameters. The normal priority is 0, above normal is a * positive number, below normal a negative number. - * @param audioSession System wide unique audio session identifier. If audioSession + * @param audioSession system wide unique audio session identifier. If audioSession * is not 0, the effect will be attached to the MediaPlayer or * AudioTrack in the same audio session. Otherwise, the effect * will apply to the output mix. @@ -337,7 +335,7 @@ public class AudioEffect { /** * Get the effect descriptor. * - //TODO when AudioEffect class is unhidden @ see android.media.AudioEffect.Descriptor + * @see android.media.AudioEffect.Descriptor * @throws IllegalStateException */ public Descriptor getDescriptor() throws IllegalStateException { @@ -351,7 +349,7 @@ public class AudioEffect { /** * Query all effects available on the platform. Returns an array of - //TODO when AudioEffect class is unhidden: {@ link android.media.AudioEffect.Descriptor} objects + * {@link android.media.AudioEffect.Descriptor} objects * * @throws IllegalStateException */ @@ -967,7 +965,7 @@ public class AudioEffect { // Utility methods // ------------------ - protected void checkState(String methodName) throws IllegalStateException { + public void checkState(String methodName) throws IllegalStateException { synchronized (mStateLock) { if (mState != STATE_INITIALIZED) { throw (new IllegalStateException(methodName @@ -976,7 +974,7 @@ public class AudioEffect { } } - protected void checkStatus(int status) { + public void checkStatus(int status) { switch (status) { case AudioEffect.SUCCESS: break; @@ -991,37 +989,37 @@ public class AudioEffect { } } - protected int byteArrayToInt(byte[] valueBuf) { + public int byteArrayToInt(byte[] valueBuf) { return byteArrayToInt(valueBuf, 0); } - protected int byteArrayToInt(byte[] valueBuf, int offset) { + public int byteArrayToInt(byte[] valueBuf, int offset) { ByteBuffer converter = ByteBuffer.wrap(valueBuf); converter.order(ByteOrder.nativeOrder()); return converter.getInt(offset); } - protected byte[] intToByteArray(int value) { + public byte[] intToByteArray(int value) { ByteBuffer converter = ByteBuffer.allocate(4); converter.order(ByteOrder.nativeOrder()); converter.putInt(value); return converter.array(); } - protected short byteArrayToShort(byte[] valueBuf) { + public short byteArrayToShort(byte[] valueBuf) { return byteArrayToShort(valueBuf, 0); } - protected short byteArrayToShort(byte[] valueBuf, int offset) { + public short byteArrayToShort(byte[] valueBuf, int offset) { ByteBuffer converter = ByteBuffer.wrap(valueBuf); converter.order(ByteOrder.nativeOrder()); return converter.getShort(offset); } - protected byte[] shortToByteArray(short value) { + public byte[] shortToByteArray(short value) { ByteBuffer converter = ByteBuffer.allocate(2); converter.order(ByteOrder.nativeOrder()); short sValue = (short) value; @@ -1029,7 +1027,7 @@ public class AudioEffect { return converter.array(); } - protected byte[] concatArrays(byte[]... arrays) { + public byte[] concatArrays(byte[]... arrays) { int len = 0; for (byte[] a : arrays) { len += a.length; diff --git a/media/java/android/media/AudioTrack.java b/media/java/android/media/AudioTrack.java index 6360541..7469133 100644 --- a/media/java/android/media/AudioTrack.java +++ b/media/java/android/media/AudioTrack.java @@ -298,8 +298,6 @@ public class AudioTrack * @param mode streaming or static buffer. See {@link #MODE_STATIC} and {@link #MODE_STREAM} * @param sessionId Id of audio session the AudioTrack must be attached to * @throws java.lang.IllegalArgumentException - // FIXME: unhide. - * @hide */ public AudioTrack(int streamType, int sampleRateInHz, int channelConfig, int audioFormat, int bufferSizeInBytes, int mode, int sessionId) @@ -648,9 +646,6 @@ public class AudioTrack * Returns the audio session ID. * * @return the ID of the audio session this AudioTrack belongs to. - // FIXME: unhide. - // FIXME: link to AudioEffect class when public. - * @hide */ public int getAudioSessionId() { return mSessionId; @@ -972,17 +967,14 @@ public class AudioTrack * reverberation effect which can be applied on any sound source that directs a certain * amount of its energy to this effect. This amount is defined by setAuxEffectSendLevel(). * {@see #setAuxEffectSendLevel(float)}. - // TODO when AudioEffect are unhidden - * <p>After creating an auxiliary effect (e.g. {_at_link android.media.EnvironmentalReverb}), - * retrieve its ID with {_at_link android.media.AudioEffect#getId()} and use it when calling + * <p>After creating an auxiliary effect (e.g. {@link android.media.EnvironmentalReverb}), + * retrieve its ID with {@link android.media.AudioEffect#getId()} and use it when calling * this method to attach the audio track to the effect. * <p>To detach the effect from the audio track, call this method with a null effect id. * * @param effectId system wide unique id of the effect to attach * @return error code or success, see {@link #SUCCESS}, * {@link #ERROR_INVALID_OPERATION}, {@link #ERROR_BAD_VALUE} - // FIXME: unhide. - * @hide */ public int attachAuxEffect(int effectId) { if (mState != STATE_INITIALIZED) { @@ -1005,8 +997,6 @@ public class AudioTrack * @param level send level scalar * @return error code or success, see {@link #SUCCESS}, * {@link #ERROR_INVALID_OPERATION} - // FIXME: unhide. - * @hide */ public int setAuxEffectSendLevel(float level) { if (mState != STATE_INITIALIZED) { diff --git a/media/java/android/media/BassBoost.java b/media/java/android/media/BassBoost.java index 75c2c88..73c1751 100644 --- a/media/java/android/media/BassBoost.java +++ b/media/java/android/media/BassBoost.java @@ -1,5 +1,5 @@ /* - * Copyright (C) 2009 The Android Open Source Project + * Copyright (C) 2010 The Android Open Source Project * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. @@ -40,10 +40,7 @@ import java.util.StringTokenizer; * <p>To attach the BassBoost to a particular AudioTrack or MediaPlayer, specify the audio session * ID of this AudioTrack or MediaPlayer when constructing the BassBoost. If the audio session ID 0 * is specified, the BassBoost applies to the main audio output mix. - // TODO when AudioEffect is unhidden - // <p> See {_at_link android.media.AudioEffect} class for more details on controlling audio effects. - * - * {@hide Pending API council review} + * <p> See {@link android.media.AudioEffect} class for more details on controlling audio effects. */ public class BassBoost extends AudioEffect { @@ -88,7 +85,7 @@ public class BassBoost extends AudioEffect { * engine. As the same engine can be shared by several applications, this parameter indicates * how much the requesting application needs control of effect parameters. The normal priority * is 0, above normal is a positive number, below normal a negative number. - * @param audioSession System wide unique audio session identifier. If audioSession + * @param audioSession system wide unique audio session identifier. If audioSession * is not 0, the BassBoost will be attached to the MediaPlayer or AudioTrack in the * same audio session. Otherwise, the BassBoost will apply to the output mix. * @@ -121,7 +118,7 @@ public class BassBoost extends AudioEffect { * accuracy for setting the strength, it is allowed to round the given strength to the nearest * supported value. You can use the {@link #getRoundedStrength()} method to query the * (possibly rounded) value that was actually set. - * @param strength Strength of the effect. The valid range for strength strength is [0, 1000], + * @param strength strength of the effect. The valid range for strength strength is [0, 1000], * where 0 per mille designates the mildest effect and 1000 per mille designates the strongest. * @throws IllegalStateException * @throws IllegalArgumentException @@ -134,7 +131,7 @@ public class BassBoost extends AudioEffect { /** * Gets the current strength of the effect. - * @return The strength of the effect. The valid range for strength is [0, 1000], where 0 per + * @return the strength of the effect. The valid range for strength is [0, 1000], where 0 per * mille designates the mildest effect and 1000 per mille the strongest * @throws IllegalStateException * @throws IllegalArgumentException @@ -158,8 +155,7 @@ public class BassBoost extends AudioEffect { * BassBoost engine. * @param effect the BassBoost on which the interface is registered. * @param status status of the set parameter operation. - // TODO when AudioEffect is unhidden - // See {_at_link android.media.AudioEffect#setParameter(byte[], byte[])}. + * See {@link android.media.AudioEffect#setParameter(byte[], byte[])}. * @param param ID of the modified parameter. See {@link #PARAM_STRENGTH} ... * @param value the new parameter value. */ @@ -282,6 +278,7 @@ public class BassBoost extends AudioEffect { /** * Sets the bass boost properties. This method is useful when bass boost settings have to * be applied from a previous backup. + * @param settings a BassBoost.Settings object containing the properties to apply * @throws IllegalStateException * @throws IllegalArgumentException * @throws UnsupportedOperationException diff --git a/media/java/android/media/EnvironmentalReverb.java b/media/java/android/media/EnvironmentalReverb.java index 3cc8452..b50febc 100644 --- a/media/java/android/media/EnvironmentalReverb.java +++ b/media/java/android/media/EnvironmentalReverb.java @@ -1,5 +1,5 @@ /* - * Copyright (C) 2009 The Android Open Source Project + * Copyright (C) 2010 The Android Open Source Project * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. @@ -39,8 +39,7 @@ import java.util.StringTokenizer; * The EnvironmentalReverb class allows an application to control each reverb engine property in a * global reverb environment and is more suitable for games. For basic control, more suitable for * music applications, it is recommended to use the - // TODO when PresetReverb is unhidden - // {_at_link android.media.PresetReverb} class. + * {@link android.media.PresetReverb} class. * <p>An application creates a EnvironmentalReverb object to instantiate and control a reverb engine * in the audio framework. * <p>The methods, parameter types and units exposed by the EnvironmentalReverb implementation are @@ -52,11 +51,8 @@ import java.util.StringTokenizer; * they must be explicitely attached to it and a send level must be specified. Use the effect ID * returned by getId() method to designate this particular effect when attaching it to the * MediaPlayer or AudioTrack. - // TODO when AudioEffect is unhidden - // <p> See {_at_link android.media.AudioEffect} class for more details on controlling + * <p> See {@link android.media.AudioEffect} class for more details on controlling * audio effects. - * - * {@hide Pending API council review} */ public class EnvironmentalReverb extends AudioEffect { @@ -67,8 +63,7 @@ public class EnvironmentalReverb extends AudioEffect { // frameworks/base/include/media/EffectEnvironmentalReverbApi.h /** - * Room level. Parameter ID for - * {@link android.media.EnvironmentalReverb.OnParameterChangeListener} + * Room level. Parameter ID for OnParameterChangeListener */ public static final int PARAM_ROOM_LEVEL = 0; /** @@ -80,7 +75,8 @@ public class EnvironmentalReverb extends AudioEffect { */ public static final int PARAM_DECAY_TIME = 2; /** - * Decay HF ratio. Parameter ID for OnParameterChangeListener + * Decay HF ratio. Parameter ID for + * {@link android.media.EnvironmentalReverb.OnParameterChangeListener} */ public static final int PARAM_DECAY_HF_RATIO = 3; /** @@ -133,7 +129,7 @@ public class EnvironmentalReverb extends AudioEffect { * EnvironmentalReverb engine. As the same engine can be shared by several applications, this * parameter indicates how much the requesting application needs control of effect parameters. * The normal priority is 0, above normal is a positive number, below normal a negative number. - * @param audioSession System wide unique audio session identifier. If audioSession + * @param audioSession system wide unique audio session identifier. If audioSession * is not 0, the EnvironmentalReverb will be attached to the MediaPlayer or AudioTrack in the * same audio session. Otherwise, the EnvironmentalReverb will apply to the output mix. * As the EnvironmentalReverb is an auxiliary effect it is recommended to instantiate it on @@ -150,7 +146,7 @@ public class EnvironmentalReverb extends AudioEffect { /** * Sets the master volume level of the environmental reverb effect. - * @param room Room level in millibels. The valid range is [-9000, 0]. + * @param room room level in millibels. The valid range is [-9000, 0]. * @throws IllegalStateException * @throws IllegalArgumentException * @throws UnsupportedOperationException @@ -179,7 +175,7 @@ public class EnvironmentalReverb extends AudioEffect { * Sets the volume level at 5 kHz relative to the volume level at low frequencies of the * overall reverb effect. * <p>This controls a low-pass filter that will reduce the level of the high-frequency. - * @param roomHF High frequency attenuation level in millibels. The valid range is [-9000, 0]. + * @param roomHF high frequency attenuation level in millibels. The valid range is [-9000, 0]. * @throws IllegalStateException * @throws IllegalArgumentException * @throws UnsupportedOperationException @@ -206,7 +202,7 @@ public class EnvironmentalReverb extends AudioEffect { /** * Sets the time taken for the level of reverberation to decay by 60 dB. - * @param decayTime Decay time in milliseconds. The valid range is [100, 20000]. + * @param decayTime decay time in milliseconds. The valid range is [100, 20000]. * @throws IllegalStateException * @throws IllegalArgumentException * @throws UnsupportedOperationException @@ -234,7 +230,7 @@ public class EnvironmentalReverb extends AudioEffect { /** * Sets the ratio of high frequency decay time (at 5 kHz) relative to the decay time at low * frequencies. - * @param decayHFRatio High frequency decay ratio using a permille scale. The valid range is + * @param decayHFRatio high frequency decay ratio using a permille scale. The valid range is * [100, 2000]. A ratio of 1000 indicates that all frequencies decay at the same rate. * @throws IllegalStateException * @throws IllegalArgumentException @@ -264,7 +260,7 @@ public class EnvironmentalReverb extends AudioEffect { * Sets the volume level of the early reflections. * <p>This level is combined with the overall room level * (set using {@link #setRoomLevel(short)}). - * @param reflectionsLevel Reflection level in millibels. The valid range is [-9000, 1000]. + * @param reflectionsLevel reflection level in millibels. The valid range is [-9000, 1000]. * @throws IllegalStateException * @throws IllegalArgumentException * @throws UnsupportedOperationException @@ -293,7 +289,7 @@ public class EnvironmentalReverb extends AudioEffect { * Sets the delay time for the early reflections. * <p>This method sets the time between when the direct path is heard and when the first * reflection is heard. - * @param reflectionsDelay Reflections delay in milliseconds. The valid range is [0, 300]. + * @param reflectionsDelay reflections delay in milliseconds. The valid range is [0, 300]. * @throws IllegalStateException * @throws IllegalArgumentException * @throws UnsupportedOperationException @@ -321,7 +317,7 @@ public class EnvironmentalReverb extends AudioEffect { /** * Sets the volume level of the late reverberation. * <p>This level is combined with the overall room level (set using {@link #setRoomLevel(short)}). - * @param reverbLevel Reverb level in millibels. The valid range is [-9000, 2000]. + * @param reverbLevel reverb level in millibels. The valid range is [-9000, 2000]. * @throws IllegalStateException * @throws IllegalArgumentException * @throws UnsupportedOperationException @@ -348,7 +344,7 @@ public class EnvironmentalReverb extends AudioEffect { /** * Sets the time between the first reflection and the reverberation. - * @param reverbDelay Reverb delay in milliseconds. The valid range is [0, 100]. + * @param reverbDelay reverb delay in milliseconds. The valid range is [0, 100]. * @throws IllegalStateException * @throws IllegalArgumentException * @throws UnsupportedOperationException @@ -376,7 +372,7 @@ public class EnvironmentalReverb extends AudioEffect { /** * Sets the echo density in the late reverberation decay. * <p>The scale should approximately map linearly to the perceived change in reverberation. - * @param diffusion Diffusion specified using a permille scale. The diffusion valid range is + * @param diffusion diffusion specified using a permille scale. The diffusion valid range is * [0, 1000]. A value of 1000 o/oo indicates a smooth reverberation decay. * Values below this level give a more <i>grainy</i> character. * @throws IllegalStateException @@ -409,7 +405,7 @@ public class EnvironmentalReverb extends AudioEffect { * <p> The scale should approximately map linearly to the perceived change in reverberation. * A lower density creates a hollow sound that is useful for simulating small reverberation * spaces such as bathrooms. - * @param density Density specified using a permille scale. The valid range is [0, 1000]. + * @param density density specified using a permille scale. The valid range is [0, 1000]. * A value of 1000 o/oo indicates a natural sounding reverberation. Values below this level * produce a more colored effect. * @throws IllegalStateException @@ -448,8 +444,7 @@ public class EnvironmentalReverb extends AudioEffect { * EnvironmentalReverb engine. * @param effect the EnvironmentalReverb on which the interface is registered. * @param status status of the set parameter operation. - // TODO when AudioEffect is unhidden - // See {_at_link android.media.AudioEffect#setParameter(byte[], byte[])}. + * See {@link android.media.AudioEffect#setParameter(byte[], byte[])}. * @param param ID of the modified parameter. See {@link #PARAM_ROOM_LEVEL} ... * @param value the new parameter value. */ @@ -649,6 +644,7 @@ public class EnvironmentalReverb extends AudioEffect { /** * Sets the environmental reverb properties. This method is useful when reverb settings have to * be applied from a previous backup. + * @param settings a EnvironmentalReverb.Settings object containing the properties to apply * @throws IllegalStateException * @throws IllegalArgumentException * @throws UnsupportedOperationException diff --git a/media/java/android/media/Equalizer.java b/media/java/android/media/Equalizer.java index b062b64..6fa48c5 100644 --- a/media/java/android/media/Equalizer.java +++ b/media/java/android/media/Equalizer.java @@ -1,5 +1,5 @@ /* - * Copyright (C) 2009 The Android Open Source Project + * Copyright (C) 2010 The Android Open Source Project * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. @@ -41,10 +41,7 @@ import java.util.StringTokenizer; * <p>To attach the Equalizer to a particular AudioTrack or MediaPlayer, specify the audio session * ID of this AudioTrack or MediaPlayer when constructing the Equalizer. If the audio session ID 0 * is specified, the Equalizer applies to the main audio output mix. - // TODO when AudioEffect is unhidden - // <p> See {_at_link android.media.AudioEffect} class for more details on controlling audio effects. - * - * {@hide Pending API council review} + * <p> See {@link android.media.AudioEffect} class for more details on controlling audio effects. */ public class Equalizer extends AudioEffect { @@ -54,7 +51,7 @@ public class Equalizer extends AudioEffect { // These constants must be synchronized with those in // frameworks/base/include/media/EffectEqualizerApi.h /** - * Number of bands. Parameter ID for {@link android.media.Equalizer.OnParameterChangeListener} + * Number of bands. Parameter ID for OnParameterChangeListener */ public static final int PARAM_NUM_BANDS = 0; /** @@ -70,11 +67,13 @@ public class Equalizer extends AudioEffect { */ public static final int PARAM_CENTER_FREQ = 3; /** - * Band frequency range. Parameter ID for OnParameterChangeListener + * Band frequency range. Parameter ID for + * {@link android.media.Equalizer.OnParameterChangeListener} */ public static final int PARAM_BAND_FREQ_RANGE = 4; /** * Band for a given frequency. Parameter ID for OnParameterChangeListener + * */ public static final int PARAM_GET_BAND = 5; /** @@ -92,7 +91,7 @@ public class Equalizer extends AudioEffect { // used by setProperties()/getProperties private static final int PARAM_PROPERTIES = 9; /** - * maximum size for perset name + * Maximum size for preset name */ public static final int PARAM_STRING_SIZE_MAX = 32; @@ -131,7 +130,7 @@ public class Equalizer extends AudioEffect { * engine. As the same engine can be shared by several applications, this parameter indicates * how much the requesting application needs control of effect parameters. The normal priority * is 0, above normal is a positive number, below normal a negative number. - * @param audioSession System wide unique audio session identifier. If audioSession + * @param audioSession system wide unique audio session identifier. If audioSession * is not 0, the Equalizer will be attached to the MediaPlayer or AudioTrack in the * same audio session. Otherwise, the Equalizer will apply to the output mix. * @@ -189,7 +188,7 @@ public class Equalizer extends AudioEffect { } /** - * Gets the level range for use by {@link #setBandLevel(int,short)}. The level is expressed in + * Gets the level range for use by {@link #setBandLevel(short,short)}. The level is expressed in * milliBel. * @return the band level range in an array of short integers. The first element is the lower * limit of the range, the second element the upper limit. @@ -206,13 +205,14 @@ public class Equalizer extends AudioEffect { /** * Sets the given equalizer band to the given gain value. - * @param band Frequency band that will have the new gain. The numbering of the bands starts - * from 0 and ends at (number of bands - 1). See @see #getNumberOfBands(). - * @param level New gain in millibels that will be set to the given band. getBandLevelRange() + * @param band frequency band that will have the new gain. The numbering of the bands starts + * from 0 and ends at (number of bands - 1). + * @param level new gain in millibels that will be set to the given band. getBandLevelRange() * will define the maximum and minimum values. * @throws IllegalStateException * @throws IllegalArgumentException * @throws UnsupportedOperationException + * @see #getNumberOfBands() */ public void setBandLevel(short band, short level) throws IllegalStateException, IllegalArgumentException, UnsupportedOperationException { @@ -227,9 +227,9 @@ public class Equalizer extends AudioEffect { /** * Gets the gain set for the given equalizer band. - * @param band Frequency band whose gain is requested. The numbering of the bands starts + * @param band frequency band whose gain is requested. The numbering of the bands starts * from 0 and ends at (number of bands - 1). - * @return Gain in millibels of the given band. + * @return the gain in millibels of the given band. * @throws IllegalStateException * @throws IllegalArgumentException * @throws UnsupportedOperationException @@ -249,9 +249,9 @@ public class Equalizer extends AudioEffect { /** * Gets the center frequency of the given band. - * @param band Frequency band whose center frequency is requested. The numbering of the bands + * @param band frequency band whose center frequency is requested. The numbering of the bands * starts from 0 and ends at (number of bands - 1). - * @return The center frequency in milliHertz + * @return the center frequency in milliHertz * @throws IllegalStateException * @throws IllegalArgumentException * @throws UnsupportedOperationException @@ -270,9 +270,9 @@ public class Equalizer extends AudioEffect { /** * Gets the frequency range of the given frequency band. - * @param band Frequency band whose frequency range is requested. The numbering of the bands + * @param band frequency band whose frequency range is requested. The numbering of the bands * starts from 0 and ends at (number of bands - 1). - * @return The frequency range in millHertz in an array of integers. The first element is the + * @return the frequency range in millHertz in an array of integers. The first element is the * lower limit of the range, the second element the upper limit. * @throws IllegalStateException * @throws IllegalArgumentException @@ -291,8 +291,8 @@ public class Equalizer extends AudioEffect { /** * Gets the band that has the most effect on the given frequency. - * @param frequency Frequency in milliHertz which is to be equalized via the returned band. - * @return Frequency band that has most effect on the given frequency. + * @param frequency frequency in milliHertz which is to be equalized via the returned band. + * @return the frequency band that has most effect on the given frequency. * @throws IllegalStateException * @throws IllegalArgumentException * @throws UnsupportedOperationException @@ -311,7 +311,7 @@ public class Equalizer extends AudioEffect { /** * Gets current preset. - * @return Preset that is set at the moment. + * @return the preset that is set at the moment. * @throws IllegalStateException * @throws IllegalArgumentException * @throws UnsupportedOperationException @@ -325,11 +325,12 @@ public class Equalizer extends AudioEffect { /** * Sets the equalizer according to the given preset. - * @param preset New preset that will be taken into use. The valid range is [0, - * number of presets-1]. See {@see #getNumberOfPresets()}. + * @param preset new preset that will be taken into use. The valid range is [0, + * number of presets-1]. * @throws IllegalStateException * @throws IllegalArgumentException * @throws UnsupportedOperationException + * @see #getNumberOfPresets() */ public void usePreset(short preset) throws IllegalStateException, IllegalArgumentException, UnsupportedOperationException { @@ -339,7 +340,7 @@ public class Equalizer extends AudioEffect { /** * Gets the total number of presets the equalizer supports. The presets will have indices * [0, number of presets-1]. - * @return The number of presets the equalizer supports. + * @return the number of presets the equalizer supports. * @throws IllegalStateException * @throws IllegalArgumentException * @throws UnsupportedOperationException @@ -353,8 +354,8 @@ public class Equalizer extends AudioEffect { /** * Gets the preset name based on the index. - * @param preset Index of the preset. The valid range is [0, number of presets-1]. - * @return A string containing the name of the given preset. + * @param preset index of the preset. The valid range is [0, number of presets-1]. + * @return a string containing the name of the given preset. * @throws IllegalStateException * @throws IllegalArgumentException * @throws UnsupportedOperationException @@ -379,8 +380,7 @@ public class Equalizer extends AudioEffect { * Equalizer engine. * @param effect the Equalizer on which the interface is registered. * @param status status of the set parameter operation. - // TODO when AudioEffect is unhidden - // See {_at_link android.media.AudioEffect#setParameter(byte[], byte[])}. + * See {@link android.media.AudioEffect#setParameter(byte[], byte[])}. * @param param1 ID of the modified parameter. See {@link #PARAM_BAND_LEVEL} ... * @param param2 additional parameter qualifier (e.g the band for band level parameter). * @param value the new parameter value. @@ -539,6 +539,7 @@ public class Equalizer extends AudioEffect { /** * Sets the equalizer properties. This method is useful when equalizer settings have to * be applied from a previous backup. + * @param settings an Equalizer.Settings object containing the properties to apply * @throws IllegalStateException * @throws IllegalArgumentException * @throws UnsupportedOperationException diff --git a/media/java/android/media/MediaPlayer.java b/media/java/android/media/MediaPlayer.java index e1f95b2..b8403e1 100644 --- a/media/java/android/media/MediaPlayer.java +++ b/media/java/android/media/MediaPlayer.java @@ -273,6 +273,16 @@ import java.lang.ref.WeakReference; * <td>Valid Sates </p></td> * <td>Invalid States </p></td> * <td>Comments </p></td></tr> + * <tr><td>attachAuxEffect </p></td> + * <td>{Initialized, Prepared, Started, Paused, Stopped, PlaybackCompleted} </p></td> + * <td>{Idle, Error} </p></td> + * <td>This method must be called after setDataSource. + * Calling it does not change the object state. </p></td></tr> + * <tr><td>getAudioSessionId </p></td> + * <td>any </p></td> + * <td>{} </p></td> + * <td>This method can be called in any state and calling it does not change + * the object state. </p></td></tr> * <tr><td>getCurrentPosition </p></td> * <td>{Idle, Initialized, Prepared, Started, Paused, Stopped, * PlaybackCompleted} </p></td> @@ -340,6 +350,12 @@ import java.lang.ref.WeakReference; * <td>Successful invoke of this method in a valid state does not change * the state. Calling this method in an invalid state transfers the * object to the <em>Error</em> state. </p></td></tr> + * <tr><td>setAudioSessionId </p></td> + * <td>{Idle} </p></td> + * <td>{Initialized, Prepared, Started, Paused, Stopped, PlaybackCompleted, + * Error} </p></td> + * <td>This method must be called in idle state as the audio session ID must be known before + * calling setDataSource. Calling it does not change the object state. </p></td></tr> * <tr><td>setAudioStreamType </p></td> * <td>{Idle, Initialized, Stopped, Prepared, Started, Paused, * PlaybackCompleted}</p></td> @@ -347,6 +363,10 @@ import java.lang.ref.WeakReference; * <td>Successful invoke of this method does not change the state. In order for the * target audio stream type to become effective, this method must be called before * prepare() or prepareAsync().</p></td></tr> + * <tr><td>setAuxEffectSendLevel </p></td> + * <td>any</p></td> + * <td>{} </p></td> + * <td>Calling this method does not change the object state. </p></td></tr> * <tr><td>setDataSource </p></td> * <td>{Idle} </p></td> * <td>{Initialized, Prepared, Started, Paused, Stopped, PlaybackCompleted, @@ -423,26 +443,6 @@ import java.lang.ref.WeakReference; * <td>Successful invoke of this method in a valid state transfers the * object to the <em>Stopped</em> state. Calling this method in an * invalid state transfers the object to the <em>Error</em> state.</p></td></tr> - * <tr><td>setAudioSessionId </p></td> - * <td>{Idle} </p></td> - * <td>{Initialized, Prepared, Started, Paused, Stopped, PlaybackCompleted, - * Error} </p></td> - * <td>This method must be called in idle state as the audio session ID must be known before - * calling setDataSource. Calling it does not change the object state. </p></td></tr> - * <tr><td>getAudioSessionId </p></td> - * <td>any </p></td> - * <td>{} </p></td> - * <td>This method can be called in any state and calling it does not change - * the object state. </p></td></tr> - * <tr><td>attachAuxEffect </p></td> - * <td>{Initialized, Prepared, Started, Paused, Stopped, PlaybackCompleted} </p></td> - * <td>{Idle, Error} </p></td> - * <td>This method must be called after setDataSource. - * Calling it does not change the object state. </p></td></tr> - * <tr><td>setAuxEffectSendLevel </p></td> - * <td>any</p></td> - * <td>{} </p></td> - * <td>Calling this method does not change the object state. </p></td></tr> * * </table> * @@ -1182,7 +1182,7 @@ public class MediaPlayer /** * Sets the audio session ID. * - * @param sessionId: the audio session ID. + * @param sessionId the audio session ID. * The audio session ID is a system wide unique identifier for the audio stream played by * this MediaPlayer instance. * The primary use of the audio session ID is to associate audio effects to a particular @@ -1194,20 +1194,14 @@ public class MediaPlayer * by calling this method. * This method must be called before one of the overloaded <code> setDataSource </code> methods. * @throws IllegalStateException if it is called in an invalid state - * - // FIXME: unhide. - // TODO when AudioEffect is unhidden - * @hide */ public native void setAudioSessionId(int sessionId) throws IllegalArgumentException, IllegalStateException; /** * Returns the audio session ID. * - * @return the audio session ID. {@see #setAudioSessionId(int)}. + * @return the audio session ID. {@see #setAudioSessionId(int)} * Note that the audio session ID is 0 only if a problem occured when the MediaPlayer was contructed. - // FIXME: unhide. - * @hide */ public native int getAudioSessionId(); @@ -1217,16 +1211,13 @@ public class MediaPlayer * energy to this effect. This amount is defined by setAuxEffectSendLevel(). * {@see #setAuxEffectSendLevel(float)}. // TODO when AudioEffect is unhidden - * <p>After creating an auxiliary effect (e.g. {_at_link android.media.EnvironmentalReverb}), - * retrieve its ID with {_at_link android.media.AudioEffect#getId()} and use it when calling + * <p>After creating an auxiliary effect (e.g. {@link android.media.EnvironmentalReverb}), + * retrieve its ID with {@link android.media.AudioEffect#getId()} and use it when calling * this method to attach the player to the effect. * <p>To detach the effect from the player, call this method with a null effect id. * <p>This method must be called after one of the overloaded <code> setDataSource </code> * methods. - * * @param effectId system wide unique id of the effect to attach - // FIXME: unhide. - * @hide */ public native void attachAuxEffect(int effectId); @@ -1241,8 +1232,6 @@ public class MediaPlayer * x == 0 -> level = 0 * 0 < x <= R -> level = 10^(72*(x-R)/20/R) * @param level send level scalar - // FIXME: unhide. - * @hide */ public native void setAuxEffectSendLevel(float level); @@ -1676,8 +1665,4 @@ public class MediaPlayer private OnInfoListener mOnInfoListener; - /** - * @hide - */ - public native static int snoop(short [] outData, int kind); } diff --git a/media/java/android/media/PresetReverb.java b/media/java/android/media/PresetReverb.java index c7d7037..1ec36fc 100644 --- a/media/java/android/media/PresetReverb.java +++ b/media/java/android/media/PresetReverb.java @@ -1,5 +1,5 @@ /* - * Copyright (C) 2009 The Android Open Source Project + * Copyright (C) 2010 The Android Open Source Project * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. @@ -40,8 +40,7 @@ import java.util.StringTokenizer; * The PresetReverb class allows an application to configure the global reverb using a reverb preset. * This is primarily used for adding some reverb in a music playback context. Applications * requiring control over a more advanced environmental reverb are advised to use the - // TODO when EnvironmentalReverb is unhidden - // {_at_link android.media.EnvironmentalReverb} class. + * {@link android.media.EnvironmentalReverb} class. * <p>An application creates a PresetReverb object to instantiate and control a reverb engine in the * audio framework. * <p>The methods, parameter types and units exposed by the PresetReverb implementation are @@ -53,10 +52,7 @@ import java.util.StringTokenizer; * they must be explicitely attached to it and a send level must be specified. Use the effect ID * returned by getId() method to designate this particular effect when attaching it to the * MediaPlayer or AudioTrack. - // TODO when AudioEffect is unhidden - // <p> See {_at_link android.media.AudioEffect} class for more details on controlling audio effects. - * - * {@hide Pending API council review} + * <p> See {@link android.media.AudioEffect} class for more details on controlling audio effects. */ public class PresetReverb extends AudioEffect { @@ -73,15 +69,32 @@ public class PresetReverb extends AudioEffect { public static final int PARAM_PRESET = 0; /** - * Room level. Parameter ID for - * {@link android.media.PresetReverb.OnParameterChangeListener} + * No reverb or reflections */ public static final int PRESET_NONE = 0; + /** + * Reverb preset representing a small room less than five meters in length + */ public static final int PRESET_SMALLROOM = 1; + /** + * Reverb preset representing a medium room with a length of ten meters or less + */ public static final int PRESET_MEDIUMROOM = 2; + /** + * Reverb preset representing a large-sized room suitable for live performances + */ public static final int PRESET_LARGEROOM = 3; + /** + * Reverb preset representing a medium-sized hall + */ public static final int PRESET_MEDIUMHALL = 4; + /** + * Reverb preset representing a large-sized hall suitable for a full orchestra + */ public static final int PRESET_LARGEHALL = 5; + /** + * Reverb preset representing a synthesis of the traditional plate reverb + */ public static final int PRESET_PLATE = 6; /** @@ -105,7 +118,7 @@ public class PresetReverb extends AudioEffect { * PresetReverb engine. As the same engine can be shared by several applications, this * parameter indicates how much the requesting application needs control of effect parameters. * The normal priority is 0, above normal is a positive number, below normal a negative number. - * @param audioSession System wide unique audio session identifier. If audioSession + * @param audioSession system wide unique audio session identifier. If audioSession * is not 0, the PresetReverb will be attached to the MediaPlayer or AudioTrack in the * same audio session. Otherwise, the PresetReverb will apply to the output mix. * As the PresetReverb is an auxiliary effect it is recommended to instantiate it on @@ -125,7 +138,7 @@ public class PresetReverb extends AudioEffect { * <p>The reverb PRESET_NONE disables any reverb from the current output but does not free the * resources associated with the reverb. For an application to signal to the implementation * to free the resources, it must call the release() method. - * @param preset This must be one of the the preset constants defined in this class. + * @param preset this must be one of the the preset constants defined in this class. * e.g. {@link #PRESET_SMALLROOM} * @throws IllegalStateException * @throws IllegalArgumentException @@ -138,7 +151,7 @@ public class PresetReverb extends AudioEffect { /** * Gets current reverb preset. - * @return Preset that is set at the moment. + * @return the preset that is set at the moment. * @throws IllegalStateException * @throws IllegalArgumentException * @throws UnsupportedOperationException @@ -161,8 +174,7 @@ public class PresetReverb extends AudioEffect { * PresetReverb engine. * @param effect the PresetReverb on which the interface is registered. * @param status status of the set parameter operation. - // TODO when AudioEffect is unhidden - // See {_at_link android.media.AudioEffect#setParameter(byte[], byte[])}. + * See {@link android.media.AudioEffect#setParameter(byte[], byte[])}. * @param param ID of the modified parameter. See {@link #PARAM_PRESET} ... * @param value the new parameter value. */ @@ -285,6 +297,7 @@ public class PresetReverb extends AudioEffect { /** * Sets the preset reverb properties. This method is useful when preset reverb settings have to * be applied from a previous backup. + * @param settings a PresetReverb.Settings object containing the properties to apply * @throws IllegalStateException * @throws IllegalArgumentException * @throws UnsupportedOperationException diff --git a/media/java/android/media/Virtualizer.java b/media/java/android/media/Virtualizer.java index 2c8909e..d03c2a8 100644 --- a/media/java/android/media/Virtualizer.java +++ b/media/java/android/media/Virtualizer.java @@ -1,5 +1,5 @@ /* - * Copyright (C) 2009 The Android Open Source Project + * Copyright (C) 2010 The Android Open Source Project * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. @@ -42,10 +42,7 @@ import java.util.StringTokenizer; * <p>To attach the Virtualizer to a particular AudioTrack or MediaPlayer, specify the audio session * ID of this AudioTrack or MediaPlayer when constructing the Virtualizer. If the audio session ID 0 * is specified, the Virtualizer applies to the main audio output mix. - // TODO when AudioEffect is unhidden - // <p> See {_at_link android.media.AudioEffect} class for more details on controlling audio effects. - * - * {@hide Pending API council review} + * <p> See {@link android.media.AudioEffect} class for more details on controlling audio effects. */ public class Virtualizer extends AudioEffect { @@ -89,7 +86,7 @@ public class Virtualizer extends AudioEffect { * engine. As the same engine can be shared by several applications, this parameter indicates * how much the requesting application needs control of effect parameters. The normal priority * is 0, above normal is a positive number, below normal a negative number. - * @param audioSession System wide unique audio session identifier. If audioSession + * @param audioSession system wide unique audio session identifier. If audioSession * is not 0, the Virtualizer will be attached to the MediaPlayer or AudioTrack in the * same audio session. Otherwise, the Virtualizer will apply to the output mix. * @@ -122,7 +119,7 @@ public class Virtualizer extends AudioEffect { * accuracy for setting the strength, it is allowed to round the given strength to the nearest * supported value. You can use the {@link #getRoundedStrength()} method to query the * (possibly rounded) value that was actually set. - * @param strength Strength of the effect. The valid range for strength strength is [0, 1000], + * @param strength strength of the effect. The valid range for strength strength is [0, 1000], * where 0 per mille designates the mildest effect and 1000 per mille designates the strongest. * @throws IllegalStateException * @throws IllegalArgumentException @@ -135,7 +132,7 @@ public class Virtualizer extends AudioEffect { /** * Gets the current strength of the effect. - * @return The strength of the effect. The valid range for strength is [0, 1000], where 0 per + * @return the strength of the effect. The valid range for strength is [0, 1000], where 0 per * mille designates the mildest effect and 1000 per mille the strongest * @throws IllegalStateException * @throws IllegalArgumentException @@ -159,8 +156,7 @@ public class Virtualizer extends AudioEffect { * Virtualizer engine. * @param effect the Virtualizer on which the interface is registered. * @param status status of the set parameter operation. - // TODO when AudioEffect is unhidden - // See {_at_link android.media.AudioEffect#setParameter(byte[], byte[])}. + * See {@link android.media.AudioEffect#setParameter(byte[], byte[])}. * @param param ID of the modified parameter. See {@link #PARAM_STRENGTH} ... * @param value the new parameter value. */ @@ -283,6 +279,7 @@ public class Virtualizer extends AudioEffect { /** * Sets the virtualizer properties. This method is useful when virtualizer settings have to * be applied from a previous backup. + * @param settings a Virtualizer.Settings object containing the properties to apply * @throws IllegalStateException * @throws IllegalArgumentException * @throws UnsupportedOperationException diff --git a/media/java/android/media/Visualizer.java b/media/java/android/media/Visualizer.java index cdd3cdf..453fc04 100755 --- a/media/java/android/media/Visualizer.java +++ b/media/java/android/media/Visualizer.java @@ -57,8 +57,6 @@ import android.os.Message; * When data capture is not needed any more, the Visualizer should be disabled. * <p>It is good practice to call the {@link #release()} method when the Visualizer is not used * anymore to free up native resources associated to the Visualizer instance. - * - * {@hide Pending API council review} */ public class Visualizer { @@ -84,8 +82,8 @@ public class Visualizer { public static final int STATE_ENABLED = 2; // to keep in sync with frameworks/base/media/jni/audioeffect/android_media_Visualizer.cpp - protected static final int NATIVE_EVENT_PCM_CAPTURE = 0; - protected static final int NATIVE_EVENT_FFT_CAPTURE = 1; + private static final int NATIVE_EVENT_PCM_CAPTURE = 0; + private static final int NATIVE_EVENT_FFT_CAPTURE = 1; // Error codes: /** @@ -127,28 +125,28 @@ public class Visualizer { /** * Indicates the state of the Visualizer instance */ - protected int mState = STATE_UNINITIALIZED; + private int mState = STATE_UNINITIALIZED; /** * Lock to synchronize access to mState */ - protected final Object mStateLock = new Object(); + private final Object mStateLock = new Object(); /** * System wide unique Identifier of the visualizer engine used by this Visualizer instance */ - protected int mId; + private int mId; /** * Lock to protect listeners updates against event notifications */ - protected final Object mListenerLock = new Object(); + private final Object mListenerLock = new Object(); /** * Handler for events coming from the native code */ - protected NativeEventHandler mNativeEventHandler = null; + private NativeEventHandler mNativeEventHandler = null; /** * PCM and FFT capture listener registered by client */ - protected OnDataCaptureListener mCaptureListener = null; + private OnDataCaptureListener mCaptureListener = null; // accessed by native methods private int mNativeVisualizer; @@ -159,7 +157,7 @@ public class Visualizer { //-------------------- /** * Class constructor. - * @param audioSession System wide unique audio session identifier. If audioSession + * @param audioSession system wide unique audio session identifier. If audioSession * is not 0, the visualizer will be attached to the MediaPlayer or AudioTrack in the * same audio session. Otherwise, the Visualizer will apply to the output mix. * |