Getting started

Add ExoPlayer as a dependency

1、确保项目根目录中的build.gradle文件中包含jcenter库

repositories {jcenter()
}

2、添加一个gradle编译依赖关系到应用程序模块的build.gradle文件。

compile 'com.google.android.exoplayer:exoplayer:r2.X.X'

3、以下内容将添加依赖于Core，DASH和UI库模块，这可能是播放DASH内容的应用程序所必需的：

compile 'com.google.android.exoplayer:exoplayer-core:r2.X.X'
compile 'com.google.android.exoplayer:exoplayer-dash:r2.X.X'
compile 'com.google.android.exoplayer:exoplayer-ui:r2.X.X'

Creating the player

// 1. Create a default TrackSelector
Handler mainHandler = new Handler();
BandwidthMeter bandwidthMeter = new DefaultBandwidthMeter();
TrackSelection.Factory videoTrackSelectionFactory = new AdaptiveTrackSelection.Factory(bandwidthMeter);
TrackSelector trackSelector =new DefaultTrackSelector(videoTrackSelectionFactory);// 2. Create the player
SimpleExoPlayer player = ExoPlayerFactory.newSimpleInstance(context, trackSelector);

Attaching the player to a view

// Bind the player to the view.
simpleExoPlayerView.setPlayer(player);

如果需要对播放器控件和渲染视频的Surface进行细粒度控制，则可以分别使用SimpleExoPlayer的setVideoSurfaceView，setVideoTextureView，setVideoSurfaceHolder和setVideoSurface方法直接设置播放器的目标SurfaceView，TextureView，SurfaceHolder或Surface。 可以使用PlaybackControlView作为独立组件，或实现与播放器直接交互的自己的播放控件。 setTextOutput和setId3Output可用于在播放过程中接收字幕和ID3元数据输出。

Preparing the player

在ExoPlayer中，每一块媒体均由MediaSource表示。 要播放一块媒体，必须先创建一个相应的MediaSource，然后将此对象传递给ExoPlayer.prepare。 ExoPlayer库为DASH（DashMediaSource），SmoothStreaming（SsMediaSource），HLS（HlsMediaSource）和常规媒体文件（ExtractorMediaSource）提供MediaSource实现。 以下代码显示如何使用适合播放MP4文件的MediaSource准备播放器。

// Measures bandwidth during playback. Can be null if not required.
DefaultBandwidthMeter bandwidthMeter = new DefaultBandwidthMeter();
// Produces DataSource instances through which media data is loaded.
DataSource.Factory dataSourceFactory = new DefaultDataSourceFactory(context,Util.getUserAgent(context, "yourApplicationName"), bandwidthMeter);
// Produces Extractor instances for parsing the media data.
ExtractorsFactory extractorsFactory = new DefaultExtractorsFactory();
// This is the MediaSource representing the media to be played.
MediaSource videoSource = new ExtractorMediaSource(mp4VideoUri,dataSourceFactory, extractorsFactory, null, null);
// Prepare the player with the source.
player.prepare(videoSource);

播放器准备好后，可以通过播放器上的方法来控制播放。 例如setPlayWhenReady可用于启动和暂停播放，并且可以使用各种seekTo方法在媒体内查找。 如果播放器被绑定到SimpleExoPlayerView或PlaybackControlView，则用户与这些组件的交互将导致播放器上的相应方法被调用。

Releasing the player

重要的是在不再需要时释放播放器，以释放有限的资源，如视频解码器供其他应用使用。 这可以通过调用ExoPlayer.release来完成。

MediaSource

在ExoPlayer中，每一块媒体均由MediaSource表示。 ExoPlayer库为DASH（DashMediaSource），SmoothStreaming（SsMediaSource），HLS（HlsMediaSource）和常规媒体文件（ExtractorMediaSource）提供MediaSource实现。 在ExoPlayer演示应用程序中，可以在PlayerActivity中找到实例化所有四个示例。

Side-loading a subtitle file

// Build the video MediaSource.
MediaSource videoSource = new ExtractorMediaSource(videoUri, ...);
// Build the subtitle MediaSource.
Format subtitleFormat = Format.createTextSampleFormat(id, // An identifier for the track. May be null.MimeTypes.APPLICATION_SUBRIP, // The mime type. Must be set correctly.selectionFlags, // Selection flags for the track.language); // The subtitle language. May be null.
MediaSource subtitleSource = new SingleSampleMediaSource(subtitleUri, dataSourceFactory, subtitleFormat, C.TIME_UNSET);
// Plays the video with the sideloaded subtitle.
MergingMediaSource mergedSource =new MergingMediaSource(videoSource, subtitleSource);

Seamlessly looping a video a fixed number of times

使用LoopingMediaSource可以使视频无缝地固定多次。 以下示例播放视频两次。

MediaSource source = new ExtractorMediaSource(videoUri, ...);
// Plays the video twice.
LoopingMediaSource loopingSource = new LoopingMediaSource(source, 2);

Seamlessly playing a sequence of videos

ConcatenatingMediaSource可以连续播放两个或多个单独的MediaSource。 以下示例依次播放两个视频。 源之间的转换是无缝的。 没有要求连接的源具有相同的格式（例如，将包含480p H264的视频文件与包含720p VP9的视频文件连接在一起是很好的）。 源甚至可能是不同的类型（例如，将视频与仅音频流连接是很好的）。

MediaSource firstSource = new ExtractorMediaSource(firstVideoUri, ...);
MediaSource secondSource = new ExtractorMediaSource(secondVideoUri, ...);
// Plays the first video, then the second video.
ConcatenatingMediaSource concatenatedSource =new ConcatenatingMediaSource(firstSource, secondSource);

Advanced composition

（略）应避免在组合中多次使用相同的MediaSource实例，除非根据文档明确允许。  然而，一般来说，组合物形成的对象的图形应该是一棵树。 但是允许在组合中使用多个等效的MediaSource实例。

Player events

Sending messages to components

一些ExoPlayer组件允许在播放过程中更改配置。 按照惯例，我们可以通过使用sendMessages或blockingSendMessages方法将消息通过ExoPlayer传递到组件来进行这些更改。 这种方法确保了线程安全性，并且配置更改按照播放器上执行的任何其他操作顺序执行。

Customization

以下是构建自定义组件的一些用例：

Customization guidelines