ExoPlayer用户手册

贴上原网址：https://google.github.io/ExoPlayer/guide.html

非完全翻译，有需要可以原网址自取，我发现网上也蛮多这个指导的翻译，可以去看看~

开始啦！：

ExoPlayer是一个开源的应用级媒体播放器，构建在Android的低级媒体API之上。开源项目包含ExoPlayer库和demo app：

ExoPlayer library – 包含项目的一些核心类库
Demo app – ExoPlayer的演示

本指南介绍了ExoPlayer库及其用途，介绍了使用ExoPlayer的优缺点（不翻，需要自查），以及如何使用ExoPlayer播放DASH、SmoothStreaming和HLS自适应流，还有ExoPlayer事件、消息、定制、DRM支持等。

1、library概述

ExoPlayer库的核心是ExoPlayer 界面。ExoPlayer实现不是直接实现加载和呈现媒体，而是将这项工作委托给创建播放器或播放准备时注入的组件。所有ExoPlayer实现共同的组件有：

MediaSource：确定要播放的媒体，播放器从中读取要加载的媒体，MediaSource在播放开始时通过ExoPlayer.prepare注入。
Renderer：各种渲染器，播放器被创建的时候注入
TrackSelector：用于选择由MediaSource提供的轨道，以供每个可用渲染器使用。当播放器创建时，TrackSelector将被注入。
LoadControl：用于控制MediaSource缓冲更多媒体的时间，以及缓冲多少媒体。在创建播放器时注入LoadControl。

ExoPlayer可以使用这些组件，但如果需要非标准行为，也可以使用自定义实现来构建。例如，可以注入自定义的LoadControl来更改播放器的缓冲策略，或者可以注入自定义渲染器来使用Android本身不支持的视频编解码器。

Getting started

对于简单的用例，ExoPlayer入门包括实现以下步骤：

1、添加ExoPlayer作为您的项目的依赖。
2、创建一个SimpleExoPlayer实例。
3、将播放器连接到视图（用于视频输出和用户输入）。
4、准备使用MediaSource播放的播放器。
5、完成后释放播放器。

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

我们可以使用ExoPlayerFactory创建一个ExoPlayer实例。该工厂提供了一系列方法来创建具有不同级别的定制的ExoPlayer实例。对于绝大多数用例，应该使用ExoPlayerFactory.newSimpleInstance方法之一。这些方法返回SimpleExoPlayer，它扩展了ExoPlayer以添加额外的高级别播放器功能。以下代码是创建SimpleExoPlayer的示例。

// 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

ExoPlayer库提供了一个SimpleExoPlayerView，它将一个PlaybackControlView和一个Surface放在哪个视频中。 SimpleExoPlayerView可以包含在应用程序的布局xml中。将播放器绑定到视图：

// 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

给出一个视频文件和一个单独的字幕文件，MergingMediaSource可以用于将它们合并到单个源中进行播放。

// 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

要无限循环，通常最好使用ExoPlayer.setRepeatMode而不是LoopingMediaSource。

使用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);