原文地址：https://medium.com/google-developers/building-a-video-player-app-in-android-part-1-5-d95770ef762d
Android的多媒体APIs可以让你创建具有丰富的媒体体验的应用，它们还提供蓝牙耳机，汽车音响系统，有线耳机，甚至Google智能助理和Android Auto外部控制的控件。
本系列文章的目标是让您开始使用ExoPlayer和MediaSession构建简单但功能丰富的视频播放器应用程序。
这个app将会支持如下功能：
- 播放本地和远程的视频资源
- 支持播放列表，以便于你可以将视频列表串联在一起
- 支持MediaSession，以便于蓝牙耳机可以控制你的视频，并且可以查看当前播放的视频。
- 支持音频对焦，以便您遵守Android的音频对焦系统，并在播放其他内容或用户收到电话时暂停播放。
- 在Android Oreo上支持画中画模式，以便在使用其他应用程序时，您的应用程序的视频播放可以在最小化的窗口中继续播放。
我们将使用kotlin来开发这个app。
ExoPlayer概述
为了使用ExoPlayer来播放网络中或者是Apk中的视频文件，首先需要创建SimpleExoPlayer和MediaSource实例，你还需要一个包含PlayerView的Activity将用来实际呈现播放器加载的视频内容。
播放器
播放什么
你需要告诉播放器要加载什么媒体文件，并且从哪里加载，MediaSource可以让你做到这一点，媒体源表示为Uris，它可以指向Apk中的assets文件夹或者是Http。你提供的Uris用于加载准备播放的内容，ExtractorMediaSource允许您处理这些源。
注意：为了适配格式，你可以使用DashMediaSource(DASH 资源)，SsMediaSource(SmoothStreaming资源)，和HlsMediaSource(HLS资源)。
如果你通过HTTP加载媒体文件需要在AndroidManifest.xml文件中添加网络权限，如果是从资源文件中加载媒体文件，那么就不需要添加任何权限。
<uses-permission android:name="android.permission.INTERNET" />
在哪里渲染播放
然后，你需要将播放器附加到PlayerView中，他将视频呈现给用户，并且还提供用于音视频播放的UI控件。
你还必须准备播放器，该播放器会通知开始加载数据，因为从网络上缓存数据到播放之前会有一段时间，您还必须将playWhenReady设置为true，这会告知ExoPlayer播放。
playWhenReady = true -> PLAY(在足够的数据被缓冲之后开始)
playWhenReady = false -> PAUSE
为了支持ExoPlayer，需要在build.gradle中添加如下配置：
ext { ver = "2.7.0" }
dependencies {
implementation "com.google.android.exoplayer:exoplayer-core:$ver"
implementation “com.google.android.exoplayer:exoplayer-ui:$ver”
}
添加ExoPlayer依赖并不会明显增加apk的大小。
创建ExoPlayer实例
此代码演示了如何使用默认的选项创建一个播放器，并且把它附加到PlayerView(必须要在显示视频的Activity的布局文件中声明)。
enum class SourceType{
local_audio, local_video, http_audio, http_video, playlist
}
data class PlayerState(var window: Int = 0,
var position: Long = 0,
var whenReady: Boolean = true,
var source: SourceType = local_audio)
class PlayerHolder(val context: Context,
val playerView: PlayerView,
val PlayerState: PlayerState) : AnkoLogger {
val player: ExoPlayer
init{
player = ExoPlayerFactory.newSimpleInstance(ctx, DefaultTrackSelector())
.also{
playerView.player = it
info { "SimpleExoPlayer created " }
}
}
fun start() {
// Load media.
prepare(buildMediaSource(selectMediaToPlay(state.source)))
// Start playback when media has buffered enough.
playWhenReady = true
}
fun selectMediaToPlay(source: Source): Uri {
return when (source) {
Source.local_audio -> Uri.parse("asset:///audio/file.mp3")
Source.local_video -> Uri.parse("asset:///video/file.mp4")
Source.http_audio -> Uri.parse("http://site.../file.mp3")
Source.http_video -> Uri.parse("http://site.../file.mp4")
}
}
private fun buildMediaSource(uri: Uri): ExtractorMediaSource {
return ExtractorMediaSource.Factory(
DefaultDataSourceFactory(ctx, "videoapp")).createMediaSource(uri)
}
fun stop() { ... }
fun release() { ... }
}
}
PlayerView需要在Activity的布局文件中进行声明，例如：
<com.google.android.exoplayer2.ui.PlayerView
xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
android:id="@+id/exoplayerview_activity_video"
android:layout_width="match_parent"
android:layout_height="match_parent"
/>
使用ExoPlayer加载APK中的贝蒂文件
DefaultDataSource允许通过Uris加载本地文件：
- file:///
- asset:///
- content:///
- rtmp
- data
- http(s)
你可以用如下方式加载assets中的文件(你也可以在assets文件夹下面创建嵌套的文件夹)：
- Uri.parse("file:///android_asset/video/video.mp4")
- Uri.parse("asset:///video/video.mp4")
请注意：
- ExoPlayer不允许使用
Uri.parse("android.resource://${packageName}/${R.raw.id}")加载res文件夹中的文件,并且，Android不允许在res文件夹中添加文件夹。 - 你可以使用RawResourceDataSource去构建一个Uri指向你的res文件夹中的资源id，例如：
RawResourceDataSource.buildRawResourceUri(R.raw.my_media_file)
释放ExoPlayer资源
当播放完毕时，要停止播放器，因为他会消耗网络，内存和系统编解码器等资源。编解码器是手机上共享的资源，根据手机和操作系统的版本，可能数量有限，所以在不使用的时候及时释放很重要，如果需要的话，下面的代码允许你再次重用相同的ExoPlayer实例
fun stop(){
player.stop(true)
info { "SimpleExoPlayer is stopped" }
}
fun release() {
player.release()
info{ "SimpleExoPlayer is released" }
}
这将释放播放器持有的所有资源，为了再次使用播放器，请调用prepare并设置playWhenReady，如上面要点所示。
ExoPlayer.release()是一个与stop完全相同的方法，只有一个例外：他也停止播放线程，放置ExoPlayer实例被重用，当播放器不再使用时，例如在Service的onDestory或者Activity的onDestroy方法中，调用该方法释放资源。
Activity的生命周期集成
您必须与Android的Activity生命周期集成才能创建，使用和释放播放器，下面是一个简单的例子。
class VideoActivity : AppCompatActivity(){
lateinit var playerHolder: PlayerHolder
var state = PlayerState()
override fun onCreate(savedInstanceState: Bundle?){
...
playerHolder = PlayerHolder(this, exoplayerview_activity_video, state)
}
override fun onStart(){
super.onStart()
playerHolder.start()
}
override fun onStop(){
super.onStop()
playerHolder.stop()
}
override fun onDestroy(){
super.onDestroy()
playerHolder.release()
}
}
在onStart()和onStop()之间保持播放器状态
PlayerState数据类用于在播放器第一次运行之前加载播放器的状态信息。当播放器释放了，一些播放器的状态将会保存在对象中，当一个新的播放器被创建，这个简单的状态对象用于配置播放器以恢复实例以前停止的位置。
data class PlayerState(var window: Int = 0,
var position: Long = 0,
var whenReady: Boolean = true,
var source: SourceType = local_audio)
从用户体验角度来说，这意味着当你运行应用程序，播放一些媒体文件，并点击主页按钮，播放器资源就会被释放，当你切回该应用程序时，播放器会再次初始化，并且应该恢复先前的状态信息，以便用户可以从停止播放的位置继续播放。
在播放资源没有被释放以前，播放器的currentWindowIndex，currentPosition，playWhenReady和播放列表或媒体项目信息被保存到PlayerState对象。一旦播放器重新初始化，状态就会恢复，以下是来自PlayerHolder类的方法，演示了如何完成此操作。
class PlayerHolder(...) : AnkoPlayer {
...
fun start() {
player.prepare(...)
with(playerState) {
player.playWhenReady = whenReady
player.seekTo(window, position)
}
info { "SimpleExoPlayer is started" }
}
fun stop(){
with(player) {
with(state) {
position = currentPosition
window = currentWindowIndex
whenReady = playWhenReady
}
stop()
}
info {"SimpleExoPlayer is released"}
}
}
多一点控制播放器的功能
你也可以使用ExoPlayerFactor.newSimpleInstance(...)工厂方法的不同签名来自定义您的播放器，例如：即使使用DefaultLoadControl类你也可以更改ExoPlayer的缓冲策略，更好的满足您的需求。
player = ExoPlayerFactory.newSimpleInstance(
DefaultRenderersFactory(ctx),
DefaultTrackSelector(),
DefaultLoadControl()
).apply {...}
对于更复杂的用例，您可以为传递给ExoPlayerFactory.newSimpleInstance（...）工厂方法的所有参数提供自己的实现，这使您可以对ExoPlayer执行的操作有很大的灵活性。
学习资源
ExoPlayer
- IO17 ExoPlayer codelab
- IO14 ExoPlayer Introduction Video
- IO17 ExoPlayer Session Video
- Why ExoPlayer?
- Latest changes for ExoPlayer v2.6.1
MediaSession, Audio Focus
DASH, HLS
Picture in Picture
