ExoPlayer 开发者指导
想深入了解ExoPlayer的童鞋可以查看我的另外一篇文章:ExoPlayer源码浅析
Developer guide
在Android设备中,播放视频和音乐是非常普遍的。Android框架提供了一个对于媒体的操作的最省代码的解决方案:MediaPlayer。它提供了低等级的媒体API,例如:MediaCodec,AudioTrack,MediaDrm,可以用于建立自定义媒体播放的解决方案。
ExpPlayer是一个开源的,App等级的媒体API,它的开源项目包含了library和示例:
- ExoPlayer library - 这部分是核心的库
- Demo app - 这部分是演示怎么使用ExoPlayer的Demo
Pros and cons
ExoPlayer相较于MediaPlayer有很多很多的优点:
- 支持动态的自适应流HTTP(DASH) 和 平滑流,任何目前MediaPlayer支持的视频格式(同时它还支持HTTP直播了(HLS),MP4,MP3,WebM,M4A,MPEG-TS 和 AAC).
- 支持高级的HLS特性,例如正确处理
EXT-X-DISCONTINUITY
标签; - 支持自定义和扩治你的使用场景。ExoPlayer专门为此设计;
- 便于随着App的升级而升级。因为ExoPlayer是一个包含在你的应用中的库,对于你使用哪个版本有完全的控制权,并且你可以简单的跟随应用的升级而升级;
- 更少的适配性问题。
值得注意的时,ExoPlayer同时有些缺点:
- ExoPlayer的音频和视频组件依赖Android的
MediaCodec
接口,该接口发布于Android4.1(API 等级16)。因此它不能工作于之前的Android版本。 - ExoPlayer目前还不支持自动检查需要播放的媒体格式。应用需要知道他想要播放的媒体格式去构建一个ExoPlayer去播放媒体。这个问题已经在Issue #438解决。
Library overview
在ExoPlayer的库中最重要的类是ExoPlayer
,这个类维护着播放器的全局状态,和正在播放的媒体特质,例如怎么获取到的媒体数据,它使怎么缓存或者它的格式。你可以以TrackRenderer
类的方式通过ExoPlayer的prepare
方法注入。
ExoPlayer提供默认的音频和视频渲染器,利用了Android框架中的MediaCodec
和AudioTrach
类。这两个都需要一个SampleSource
对象中注入,用来实现媒体示例的播放。
组件的注入在当前ExoPlayer库中是普遍存在的。图1展示了使用一个ExoPlayer来配置和播放MP4媒体流的高级对象模型。默认的音频和视频渲染器已经被注解到ExoPlayer
中。一个叫ExtractorSampleSource
类的实现被注解到渲染器中用于提供简单的媒体播放功能。DataSource
和Extractor
示例被注解到ExtractorSampleSource
来支持加载媒体流和在被加载的数据中提取样板。在这个示例中DefaultUriDataSource
和Mp4Extractor
被用于播放从URIs中导入的MP4流。
![](https://google.github.io/ExoPlayer/images/standard-model.png)
总的来说,ExoPlayer实例被用来注解支持开发者需求的组件,这个模型使定制播放器变得非常简单,并支持自定义组件。以下部分介绍了在这个模型图种三个最最重要的部分:TrackRender
,SampleSource
和DataSource
。
TrackRenderer
一个TrackRenderer
播放特定类型的媒体,例如视频,音频和文字。ExoPlayer类在它的TrackRenderer
上执行方法,使用单独的线程,因此,导致每种类型的媒体被渲染全局的播放位置,ExoPlayer库提供MediaCodecVideoTrackRenderer
作为默认的实现用于渲染视频,MediaCodecAudioTrackRender
渲染音频。两种实现都是利用Android的 MediaCodec 去解码每个媒体样本。他们可以处理所有Android设备支持的音频和视频格式(详细信息请看支持媒体类型)。ExoPlayer库也提供了一个渲染文本的渲染器TextTrackRenderer
。
以下代码示例使用标准的TrackRenderer
实现视频,音频播放需要的步骤:
//1.初始化播放器
player = ExoPlayer.Factory.newInstance(RENDERER_COUNT);
//2.构建渲染器
MediaCodecVideoTrackRender videoRender = ...
MediaCodecAudioTrackRender audioRender = ...
//3.通过prepare注入渲染器
player.prepare(videoRender,audioRender);
//4.将surface传递到渲染器
player.sendMessage(videoRender,MediaCodecVideoTrackRenderer.MSG_SET_SURFACE,surface);
//5.开始播放
player.setPlayWhenReady(true);
....
player.release(); //当播放完成,别忘了释放!
想看完整的例子,请在ExoPlayer demo app中查看PlayerActivity和
DemoPlayer。其中详细的示范如何使用ExoPlayer实例,以及
Activity和
Surface`的生命周期。
SampleSource
库中提供标准的TrackRenderer
实现需要SampleSource
实例被注入到他们的构造方法中。一个SampleSource
对象提供了格式信息,和被渲染的媒体样本。ExoPlayer库提供了一些不同类型的SampleSource
实例:
ExtractorSampleSource
- 用于MP3,M4A,WebM,MPEG-TS和AAC;ChunkSampleSource
- 用于DASH和平滑流的播放;HlsSampleSource
- 用于HLS 播放;
后面的部分会详细介绍这些实例的使用。
DataSource
ExoPlayer库提供的标准的SampleSource
实例是利用了DataSource
来加载媒体数据的。各种类型的实现都放在upstream
包种。最最多用到的实现是:
DefaultUriDataSource
- 用于播放本地和网络媒体;AssetDataSource
- 用于播放应用中assets
文件夹下的媒体。
Traditional media playbacks
Explayer库提供了ExtractorSampleSource
用于播放传统格式的媒体,包括MP3,M4A,MP4,WebM,MPEG-TS和AAC,图1中展示了ExoPlayer播放MP4流的对象模型,以下代码展示了如何构造和实例化TrackRenderer
。
DataSource dataSource = new DefaultUriDataSource(userAgent, null);
Mp4Extractor extractor = new Mp4Extractor();
ExtractorSampleSource sampleSource = new ExtractorSampleSource(
uri, dataSource, extractor, 2, BUFFER_SIZE);
MediaCodecVideoTrackRenderer videoRenderer = new MediaCodecVideoTrackRenderer(
sampleSource, MediaCodec.VIDEO_SCALING_MODE_SCALE_TO_FIT);
MediaCodecAudioTrackRenderer audioRenderer = new MediaCodecAudioTrackRenderer(sampleSource);
每种类型的媒体格式都需要一个对应的解析器(Extractor
)。在ExoPlayer库的extractor
包种包含了不同类型的解析器,你可以实现你自己的解析器,如果库中不包含你需要的类型的话。
ExoPlayer的示例代码中提供了一个完整的ExtractorRendererBuilder
的示例。PlayerActivity
使用它播放一些可用的视频。
Adaptive media playbacks
ExoPlayer 支持自适应流,即在播放的时候,根据网络状况自动调节视频质量。DASH,SmoothStreaming和HLS展示了自适应流技术。以上三种,媒体都是通过小块的方式加载(通常2到10秒的长度)。每当一块媒体被请求,客户端将会选择一种可能的规格。例如:如果网络情况比较好,客户端将选择高质量的规格,如果网络比较差则会低质量的。在两种技术中,视频和音频都需要被分割。
DASH android SmoothStreaming
ExoPlayer库通过ChunkSampleSource
支持DASH和SmoothStreaming动态播放,即通过读取独立的媒体块。每个ChunkSampleSOurce
需要一个ChunkSource
通过构造方法注入进来。ChunkSource
主要负责加载和读取样本来提供媒体块。DashChunkSource
类使用FMP4和WebM容器格式来提供DASH播放。SmoothStreamingChunkSource
类使用FMP4容器格式。
两种类型的ChunkSource
实例需要一个解析器FormatEvaluator
和一个数据源DataSource
通过构造的方式注入。FormatEvaluator
在每个块被加载之前选择一种可用的格式,DataSource
提供数据源。最终,ChunkSampleSource
需要一个LoadControl
对象去控制缓冲块。
图2演示了DASH动态播放通常的配置。通过FormatEvaluator
实现视频质量的动态变化,但是音频的质量是固定的。
![](https://google.github.io/ExoPlayer/images/dash-model.png)
这部分动态视频流暂时用不着,以后有机会翻译...
Player events
在播放阶段,你的App可以收到所有ExoPlayer产生的时间,这些事件对于提升用户体验有很大的帮助,如对播放的控制。一些ExoPlayer组件还提供了他们自己底层的事件,可以监听性能。
High level events
ExoPlayer允许通过addListener()
和removeListener()
的方式添加ExoPlayer.Listener
实例,被注册的监听器将会得到播放状态的回调,还要错误导致的播放失败,如果需要知道更多的播放状态和可能的状态直接的相互转换,请查阅ExoPlayer源码。
Low level events
除了高级事件,个别的组件还允许监听他们自己的时间,例如,MediaCodecVideoTrackRenderer
的构造方法提供了MediaCodecVideoTrackRenderer.EventListener
。在ExoPlayer的demo中,这给PlayerAcitivity
调整目标surface的尺寸到合适的高度和宽度的途径。
@Override
public void onVideoSizeChanged(int width, int height, float pixelWidthAspectRatio) {
surfaceView.setVideoWidthHeightRatio(
height == 0 ? 1 : (width * pixelWidthAspectRatio) / height);
}
Customization
懒得翻译了...