原文地址: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文件中添加网络权限,如果是从资源文件中加载媒体文件,那么就不需要添加任何权限。
在哪里渲染播放
然后,你需要将播放器附加到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的布局文件中进行声明,例如:
使用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
- MediaSession extension for ExoPlayer
- What is MediaSession
- What is Audio Focus
DASH, HLS
- Dash, HLS
- Dash benefits over HLS, etc
Picture in Picture
- Picture in Picture Mode in Oreo