ExoPlayer 开发指南

最新推荐文章于 2023-07-21 16:36:48 发布

hongge372

最新推荐文章于 2023-07-21 16:36:48 发布

阅读量339

点赞数

分类专栏： android video

video 同时被 2 个专栏收录

423 篇文章 21 订阅

订阅专栏

android

215 篇文章 4 订阅

订阅专栏

https://www.jianshu.com/p/cb1e79267319

ExoPlayer 与 MediaPlayer

与Android内置的MediaPlayer相比，ExoPlayer具有许多优点：

1.支持通过HTTP（DASH）和SmoothStreaming进行动态自适应流，这两种都不受MediaPlayer的支持。还支持许多其他格式。同时它还支持HTTP直播（HLS),MP4,MP3,WebM,M4A,MPEG-TS 和 AAC的格式文件

2.能够自定义和扩展播放器，以适应各种不同需求。 ExoPlayer专门设计了这一点，大部分组件都可以自己替换
便于随着App的升级而升级。因为ExoPlayer是一个包含在你的应用中的库，对于你使用哪个版本有完全的控制权，并且你可以简单的跟随应用的升级而升级；

3.更少的适配性问题。

缺点：

ExoPlayer的音频和视频组件依赖Android的 MediaCodec接口，该接口发布于Android4.1（API 等级16）。因此它不能工作于之前的Android版本。

简述：
ExoPlayer库的核心是ExoPlayer接口，ExoPlayer公开了传统的高级媒体播放器功能，例如缓冲媒体，播放，暂停和seek等功能。在具体实现方面，该开源库对播放的媒体类型、存储方式、位置、渲染方式等进行了最少的实现，旨在让开发者自定义各种特性。ExoPlayer实现不是直接实现加载和呈现媒体，而是将这项工作委托给各种组件。所有ExoPlayer共同的组件有：

MediaSource：定义多媒体数据源，这个类的功能就是从Uri中读取多媒体文件的二进制数据。 MediaSource在播放开始时通过ExoPlayer.prepare注入
TrackSelector：轨道提取器，从MediaSource中提取各个轨道的二进制数据，交给Renderer渲染。创建播放器时初注入
Renderer：对多媒体中的各个轨道（音轨、视频轨、字幕轨等）数据进行渲染，渲染就是“播放”，把二进制文件渲染成声音、画面。创建播放器时注入
LoadControl：对MediaSource进行控制，比如什么时候开始缓冲、缓冲多少等等。创建播放器时注入

该库为提供了这些组件的默认实现，能够满足大部分需求，如果有特殊需求，可以通过自定义组件来实现。比如，可以自定义LoadControl来更改播放器的缓冲策略，或自定义Renderer来渲染Android本身不支持的编解码器。

整个库中都存在注入组件的概念，许多子组件都能单独替换成自定义组件，而不会影响整个流程。例如，默认的MediaSource实现需要通过其构造函数注入一个或多个DataSource工厂，通过提供自定义Factory，可以从非标准源或不同的网络堆栈加载数据。

入门

实现一个最简单的播放器，需要如下流程：

添加ExoPlayer库作为依赖
创建一个SimpleExoPlayer实例
将播放器连接到UI，用于视频输出和用户输入（也就是放在某个Activity中）
准备播放器，传入MediaSource作为多媒体源
播放完成后释放

这些步骤在下面更详细地概述。完整的示例可以参考demo（github地址:https://github.com/google/ExoPlayer）中的PlayerActivity。

添加ExoPlayer作为依赖

第一步是确保项目根目录中的build.gradle文件中包含jcenter仓库：

repositories {
    jcenter()
}

然后在应用app模块的build.gradle文件中添加ExoPlayer库的依赖：

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

创建播放器

使用ExoPlayerFactory创建一个ExoPlayer实例，该Factory提供了一系列方法来创建各种定制ExoPlayer实例。大部分情况下，使用ExoPlayerFactory.newSimpleInstance方法之一即可，这些方法返回SimpleExoPlayer，它实现了ExoPlayer以添加额外的高级别播放器功能。下面是创建SimpleExoPlayer的示例：

// step1\. 创建一个默认的TrackSelector
Handler mainHandler = new Handler();

// 创建带宽
BandwidthMeter bandwidthMeter = new DefaultBandwidthMeter();

// 创建轨道选择工厂
TrackSelection.Factory videoTrackSelectionFactory = new AdaptiveTrackSelection.Factory(bandwidthMeter);

// 创建轨道选择器实例
TrackSelector trackSelector = new DefaultTrackSelector(videoTrackSelectionFactory);

//step2\. 创建播放器
SimpleExoPlayer player = ExoPlayerFactory.newSimpleInstance(context, trackSelector);

使用SimpleExoPlayer的setVideoSurfaceView、setVideoTextureView、setVideoSurfaceHolder和setVideoSurface方法设置播放器的目标SurfaceView、TextureView、SurfaceHolder或Surface。

准备播放器

在ExoPlayer中，每一个多媒体文件均由MediaSource表示，要播放一个多媒体，您必须先创建一个相应的MediaSource实例，然后将此实例传递给ExoPlayer.prepare。 ExoPlayer库为DASH（DashMediaSource），SmoothStreaming（SsMediaSource），HLS（HlsMediaSource）和常规媒体文件（ExtractorMediaSource）提供了默认MediaSource实现，这些实现将在本指南的后面更详细地描述。下面的代码演示如何播放一个mp4文件：

// 测量播放带宽，如果不需要可以传null
DefaultBandwidthMeter bandwidthMeter = new DefaultBandwidthMeter();

// 创建加载数据的工厂
DataSource.Factory dataSourceFactory = new DefaultDataSourceFactory(context,
    Util.getUserAgent(context, "yourApplicationName"), bandwidthMeter);

// 创建解析数据的工厂
ExtractorsFactory extractorsFactory = new DefaultExtractorsFactory();

// 传入Uri、加载数据的工厂、解析数据的工厂，就能创建出MediaSource
MediaSource videoSource = new ExtractorMediaSource(mp4VideoUri,
    dataSourceFactory, extractorsFactory, null, null);

// Prepare
player.prepare(videoSource);

播放器准备好后，可以通过各种方法来控制播放。例如，setPlayWhenReady启动和暂停播放，seekTo方法控制进度。

退出时通过ExoPlayer.release释放播放器，释放硬件资源。

MediaSource

在ExoPlayer中，每个多媒体均由MediaSource表示， ExoPlayer库为DASH（DashMediaSource）、SmoothStreaming（SsMediaSource）、HLS（HlsMediaSource）和常规媒体文件（ExtractorMediaSource）提供了默认实现。 github上的demo中，可以在PlayerActivity中找到实例化所有四个示例。

除了上述的MediaSource之外，ExoPlayer库还提供了MergingMediaSource、LoopingMediaSource和ConcatenatingMediaSource。这些MediaSource通过组合实现更复杂的播放功能。一些常见的用例如下所述。注意，示例描述的是视频播放，但它们同样适用于仅音频播放，实际上也适用于任何支持的媒体类型的播放。

事件监听

播放期间，可以监听由ExoPlayer生成的事件，指示播放器的整体状态。这些事件可用作更新用户界面（如播放控件）的触发器。许多ExoPlayer组件还报告自己的组件特定的底层事件，可以用来监听性能。

上层事件

ExoPlayer通过addListener/removeListener方法添加/删除ExoPlayer.EventListener的实例，监听者能够监听到播放状态的变化，以及播放失败的事件。

使用SimpleExoPlayer时，可以在播放器上设置其他侦听器。比如，setVideoListener允许应用程序接收与视频渲染有关的事件，这些事件可能对于调整UI（例如，一个特定宽高比的视频被渲染到surface上了）有用。可以在SimpleExoPlayer上设置其他侦听器来接收调试信息，例如调用setVideoDebugListener和setAudioDebugListener。

底层事件

除了上层监听外，ExoPlayer库提供的许多单独的组件允许自己的事件监听器。通常需要将Handler对象传递给这些组件，这些Handler决定侦听器方法将在哪个线程调用，所以在大多数情况下，应该使用主线程的Handler。

向组件发送消息

一些组件允许在播放过程中更改配置。一般来说，可以通过sendMessages或blockingSendMessages方法将消息通过ExoPlayer传递到组件来进行更改。这种方法确保了线程安全，更改配置的操作与ExoPlayer上的其它事件一样，需要按顺序执行。

自定义

ExoPlayer与MediaPlayer的主要优点之一是可以自定义和扩展播放器，以更好地适应开发人员使用。 ExoPlayer库专门设计了这一点，定义了一些接口和抽象基类，使应用程序开发人员可以轻松地替换库提供的默认实现。以下是构建自定义组件的一些case：

Renderer：可以自定义Renderer来处理默认实现不支持的多媒体格式
TrackSelector：自定义TrackSelector可以更改从MediaSource中提取轨道的方式
LoadControl：自定义LoadControl可以更改播放器的缓冲策略
Extractor：如果需要支持默认库不支持的容器格式，可以自定义Extractor类，然后可以将其与ExtractorMediaSource一起使用，以播放容器格式的多媒体
MediaSource：如果希望获取媒体样本以自定义方式提供给渲染器，或者希望实现自定义MediaSource合成行为，则实现自定义MediaSource类可能是适当的
DataSource：ExoPlayer库已经包含了许多不同情况的DataSource实现。您可能希望实现自己的DataSource类，以其他方式加载数据，比如通过自定义协议，使用自定义HTTP堆栈或从自定义持久缓存加载数据。

自定义指南

如果自定义组件需要将事件报告回应用程序，我们建议您使用与现有ExoPlayer组件相同的模型，其中将事件侦听器与Handler一起传递到组件的构造函数。

我们建议自定义组件使用与现有ExoPlayer组件相同的模型，以便在播放过程中可以方便地重新配置，请参考上面“向组件发送消息”章节。为此，您应该实现一个ExoPlayerComponent并在其handleMessage方法中接收配置更改消息。您的应用程序应通过调用ExoPlayer的sendMessages和blockingSendMessages方法来传递配置更改。

作者：April_Android
链接：https://www.jianshu.com/p/cb1e79267319
來源：简书
简书著作权归作者所有，任何形式的转载都请联系作者获得授权并注明出处。