AudioTrack

Denotes a generic operation failure.

Denotes a failure due to the use of an invalid value.

Denotes a failure due to the improper use of a method.

Creation mode where audio data is transferred from Java to the native layer only once before the audio starts playing.

Creation mode where audio data is streamed from Java to the native layer as the audio is playing.

indicates AudioTrack state is paused

indicates AudioTrack state is playing

indicates AudioTrack state is stopped

State of an AudioTrack that is ready to be used.

State of a successfully initialized AudioTrack that uses static data, but that hasn't received that data yet.

State of an AudioTrack that was not successfully initialized upon creation.

Denotes a successful operation.

Class constructor.

Flushes the audio data currently queued for playback.

Returns the configured audio data format. See ENCODING_PCM_16BIT and ENCODING_PCM_8BIT.

Returns the configured channel configuration. See CHANNEL_CONFIGURATION_MONO and CHANNEL_CONFIGURATION_STEREO.

Returns the configured number of channels.

Returns the maximum valid volume value. Volume values set above this one will be clamped at this value.

Returns the minimum buffer size required for the successful creation of an AudioTrack object to be created in the MODE_STREAM mode. Note that this size doesn't guarantee a smooth playback under load, and higher values should be chosen according to the expected frequency at which the buffer will be refilled with additional data to play.

Returns the minimum valid volume value. Volume values set under this one will be clamped at this value.

Returns the hardware output sample rate

Returns marker position expressed in frames.

Returns the playback state of the AudioTrack instance.

Returns the playback head position expressed in frames

Returns the current playback rate in Hz. Note that this rate may differ from the one set with setPlaybackRate(int) as the value effectively used is implementation-dependent.

Returns the notification update period expressed in frames.

Returns the configured audio data sample rate in Hz

Returns the state of the AudioTrack instance. This is useful after the AudioTrack instance has been created to check if it was initialized properly. This ensures that the appropriate hardware resources have been acquired.

Returns the type of audio stream this AudioTrack is configured for. Compare the result against STREAM_VOICE_CALL, STREAM_SYSTEM, STREAM_RING, STREAM_MUSIC or STREAM_ALARM

Pauses the playback of the audio data.

Starts playing an AudioTrack.

Releases the native AudioTrack resources.

Notifies the native resource to reuse the audio data already loaded in the native layer. This call is only valid with AudioTrack instances that don't use the streaming model.

Sets the loop points and the loop count. The loop can be infinite.

Sets the position of the notification marker.

Sets the playback head position. The track must be stopped for the position to be changed.

Sets the listener the AudioTrack notifies when a previously set marker is reached or for each periodic playback head position update. Use this method to receive AudioTrack events in the Handler associated with another thread than the one in which you created the AudioTrack instance.

Sets the listener the AudioTrack notifies when a previously set marker is reached or for each periodic playback head position update. Notifications will be received in the same thread as the one in which the AudioTrack instance was created.

Sets the playback sample rate for this track. This sets the sampling rate at which the audio data will be consumed and played back, not the original sampling rate of the content. Setting it to half the sample rate of the content will cause the playback to last twice as long, but will also result result in a negative pitch shift. The current implementation supports a maximum sample rate of 64kHz. Use getSampleRate() to check the rate actually used in hardware after potential clamping.

Sets the period for the periodic notification event.

Sets the specified left/right output volume values on the AudioTrack. Values are clamped to the (getMinVolume(), getMaxVolume()) interval if outside this range.

Stops playing the audio data.

Writes the audio data to the audio hardware for playback.

Writes the audio data to the audio hardware for playback.

Is called before the object's memory is being reclaimed by the VM. This can only happen once the VM has detected, during a run of the garbage collector, that the object is no longer reachable by any thread of the running application.

The method can be used to free system resources or perform other cleanup before the object is garbage collected. The default implementation of the method is empty, which is also expected by the VM, but subclasses can override finalize() as required. Uncaught exceptions which are thrown during the execution of this method cause it to terminate immediately but are otherwise ignored.

Note that the VM does guarantee that finalize() is called at most once for any object, but it doesn't guarantee when (if at all) finalize() will be called. For example, object B's finalize() can delay the execution of object A's finalize() method and therefore it can delay the reclamation of A's memory. To be safe, use a ReferenceQueue, because it provides more control over the way the VM deals with references during garbage collection.

Returns the native frame count used by the hardware.

Sets the initialization state of the instance. To be used in an AudioTrack subclass constructor to set a subclass-specific post-initialization state.