You can reset, reuse, or release a MediaPlayer instance that you no longer need.
When you reset a
MediaPlayer instance, it is returned to its uninitialized IDLE status as defined in
You want to reuse a
MediaPlayer instance but need to load a new
MediaResource (video content) and replace the previous instance.
Resetting allows you to reuse the
MediaPlayer instance without the overhead of releasing resources, recreating the
MediaPlayer, and reallocating resources.
MediaPlayer is in ERROR status and needs to be cleared.
This is the only way to recover from the ERROR status.
reset to return the
MediaPlayer instance to its uninitialized status:
void reset() throws MediaPlayerException;
MediaPlayer.replaceCurrentResource() to load another
To clear an error, load the same
When you receive the
STATUS_CHANGED event callback with
PREPARED status, start the playback.
You should release a
MediaPlayer instance and resources when you no longer need the
When you release a
MediaPlayer object, the underlying hardware resources that are associated with this
MediaPlayer object are deallocated.
Here are some reasons to release a
Holding unnecessary resources can affect performance.
Leaving an unnecessary
MediaPlayer object instantiated can lead to continuous battery consumption for mobile devices.
If multiple instances of the same video-codec are not supported on a device, playback failure might occur for other applications.
void release() throws MediaPlayerException;
MediaPlayer instance is released, you can no longer use it. If any method of the
MediaPlayer interface is called after it is released, a
MediaPlayerException is thrown.