This documentation may be out-of-date. Please refer to the documentation for the latest ExoPlayer release on developer.android.com.
Streams in the following container formats can be played directly by ExoPlayer. The contained audio and video sample formats must also be supported (see the sample formats section for details).
|MP3||YES||Some streams only seekable using constant bitrate seeking**|
|Ogg||YES||Containing Vorbis, Opus and FLAC|
|ADTS (AAC)||YES||Only seekable using constant bitrate seeking**|
|FLAC||YES||Using the FLAC extension or the FLAC extractor in the core library***|
|AMR||YES||Only seekable using constant bitrate seeking**|
|JPEG motion photo||YES||Only the MP4 content is extracted|
* Seeking is unsupported because the container does not provide metadata (e.g., a sample index) to allow a media player to perform a seek in an efficient way. If seeking is required, we suggest using a more appropriate container format.
** These extractors have
FLAG_ENABLE_CONSTANT_BITRATE_SEEKING flags for
enabling approximate seeking using a constant bitrate assumption. This
functionality is not enabled by default. The simplest way to enable this
functionality for all extractors that support it is to use
DefaultExtractorsFactory.setConstantBitrateSeekingEnabled, as described
*** The FLAC extension extractor outputs raw audio, which can be handled
by the framework on all API levels. The core library FLAC extractor outputs
FLAC audio frames and so relies on having a FLAC decoder (e.g., a
decoder that handles FLAC (required from API level 27), or the
FFmpeg extension with FLAC enabled). The
DefaultExtractorsFactory uses the
extension extractor if the application was built with the FLAC extension.
Otherwise, it uses the core library extractor.
To play a progressive stream, create a
MediaItem with the media URI and pass
it to the player.
// Create a player instance. ExoPlayer player = new ExoPlayer.Builder(context).build(); // Set the media item to be played. player.setMediaItem(MediaItem.fromUri(progressiveUri)); // Prepare the player. player.prepare();
For more customization options, you can create a
directly to the player instead of a
// Create a data source factory. DataSource.Factory dataSourceFactory = new DefaultHttpDataSource.Factory(); // Create a progressive media source pointing to a stream uri. MediaSource mediaSource = new ProgressiveMediaSource.Factory(dataSourceFactory) .createMediaSource(MediaItem.fromUri(progressiveUri)); // Create a player instance. ExoPlayer player = new ExoPlayer.Builder(context).build(); // Set the media source to be played. player.setMediaSource(mediaSource); // Prepare the player. player.prepare();
ExoPlayer provides multiple ways for you to tailor playback experience to your app’s needs. See the Customization page for examples.