Stay organized with collections Save and categorize content based on your preferences.

public class AsyncPlayer
extends Object



Plays a series of audio URIs, but does all the hard work on another thread so that any slowness with preparing or loading doesn't block the calling thread.

Summary

Public constructors

AsyncPlayer(String tag)

Construct an AsyncPlayer object.

Public methods

void play(Context context, Uri uri, boolean looping, int stream)

This method was deprecated in API level 23. use play(android.content.Context, android.net.Uri, boolean, android.media.AudioAttributes) instead

void play(Context context, Uri uri, boolean looping, AudioAttributes attributes)

Start playing the sound.

void stop()

Stop a previously played sound.

Inherited methods

From class java.lang.Object

Object clone()

Creates and returns a copy of this object.

boolean equals(Object obj)

Indicates whether some other object is "equal to" this one.

void finalize()

Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.

final Class<?> getClass()

Returns the runtime class of this Object.

int hashCode()

Returns a hash code value for the object.

final void notify()

Wakes up a single thread that is waiting on this object's monitor.

final void notifyAll()

Wakes up all threads that are waiting on this object's monitor.

String toString()

Returns a string representation of the object.

final void wait(long timeoutMillis, int nanos)

Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.

final void wait(long timeoutMillis)

Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.

final void wait()

Causes the current thread to wait until it is awakened, typically by being notified or interrupted.

Public constructors

AsyncPlayer

public AsyncPlayer (String tag)

Construct an AsyncPlayer object.

Parameters
tag String: a string to use for debugging

Public methods

play

public void play (Context context, 
                Uri uri, 
                boolean looping, 
                int stream)

This method was deprecated in API level 23.
use play(android.content.Context, android.net.Uri, boolean, android.media.AudioAttributes) instead

Start playing the sound. It will actually start playing at some point in the future. There are no guarantees about latency here. Calling this before another audio file is done playing will stop that one and start the new one.

Parameters
context Context: Your application's context.
uri Uri: The URI to play. (see MediaPlayer#setDataSource(Context, Uri))
looping boolean: Whether the audio should loop forever. (see MediaPlayer#setLooping(boolean))
stream int: the AudioStream to use. (see MediaPlayer#setAudioStreamType(int))

play

public void play (Context context, 
                Uri uri, 
                boolean looping, 
                AudioAttributes attributes)

Start playing the sound. It will actually start playing at some point in the future. There are no guarantees about latency here. Calling this before another audio file is done playing will stop that one and start the new one.

Parameters
context Context: the non-null application's context.
uri Uri: the non-null URI to play. (see MediaPlayer#setDataSource(Context, Uri))
looping boolean: whether the audio should loop forever. (see MediaPlayer#setLooping(boolean))
attributes AudioAttributes: the non-null AudioAttributes to use. (see MediaPlayer#setAudioAttributes(AudioAttributes))
Throws
java.lang.IllegalArgumentException
IllegalArgumentException

stop

public void stop ()

Stop a previously played sound. It can't be played again or unpaused at this point. Calling this multiple times has no ill effects.

Content and code samples on this page are subject to the licenses described in the Content License. Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.

Last updated 2023-02-08 UTC.