使用 ExoPlayer 流式传输媒体内容  

注意：ExoPlayer 是在 Android 版 YouTube 应用中运行的视频播放器。

屏幕截图：YouTube Android 版应用

ExoPlayer 是一款基于 Android 中的低层级媒体 API 构建的应用级媒体播放器。与 Android 内置的 MediaPlayer 相比，ExoPlayer 具有多项优势。它支持 MediaPlayer 支持的许多媒体格式，还支持 DASH 和 SmoothStreaming 等自适应格式。ExoPlayer 具有高度的可定制性和可扩展性，因此能够用于许多高级用例。它是 Google 应用（包括 YouTube 和 Google Play 影视）使用的开源项目。

注意：如需详细了解相关优缺点，请参阅 ExoPlayer 开发者指南。

注意：此 Codelab 主要介绍 ExoPlayer。对于不相关的概念，我们仅会略作介绍，但是会提供不相关的代码块供您复制和粘贴。

首先，请下载 Android Studio 项目：

或者，您也可以克隆 GitHub 代码库：

通过克隆或解压缩，您会得到一个根文件夹 (exoplayer-intro)，其中包含一个 Gradle 项目以及多个模块（一个应用模块，以及此 Codelab 的每个步骤的模块），还有您需要的所有资源。

屏幕截图：导入时的项目结构

构建完成后，您会看到 6 个模块：app 模块（类型为“application”），以及 5 个名为 exoplayer-codelab-N 的模块（其中的 N 为 00 到 04,，类型均为“library”）。app 模块实际上是空的，其中只包含一个清单。当使用 app/build.gradle 中的 Gradle 依赖项构建应用时，当前指定的 exoplayer-codelab-N 模块中的所有内容都会被合并。

注意：您可以切换到此 Codelab 中任何步骤的起始状态，只需将 exoplayer-codelab-00 更改为 explayer-codelab-N 即可，其中 N 为步骤编号。完成后，请依次选择 File -> Sync Project With Gradle Files。

媒体播放器 activity 保存在 exoplayer-codelab-N 模块中。之所以将其保存在单独的库模块中，是为了让您可以在针对不同目标平台（例如，移动设备和 Android TV）的 APK 之间共享它。它还允许您充分利用各种功能，例如 Dynamic Delivery。使用 Dynamic Delivery 功能后，只有当用户需要时，系统才允许安装您的媒体播放功能。

屏幕截图：空白应用正在运行

ExoPlayer 是一个托管在 GitHub 上的开源项目。每个版本均通过 Google Maven 进行分发，后者是 Android Studio 和 Gradle 使用的默认软件包代码库之一。每个版本均以采用如下格式的字符串作为唯一标识：

您只需导入 ExoPlayer 的类和界面组件，即可将 ExoPlayer 添加到您的项目。它非常小巧，其收缩占用空间约为 70-300 kB，具体大小取决于包含的功能和支持的格式。ExoPlayer 库分为不同的模块，开发者只需导入自己需要的功能。如需详细了解 ExoPlayer 的模块化结构，请参阅添加 ExoPlayer 模块。

根据您的上下文创建 SimpleExoPlayer.Builder，然后调用 build 来创建 SimpleExoPlayer 对象。然后，系统会将其分配给 player，您需要将其声明为成员字段。然后，您可以使用 viewBinding.videoView.player 可变属性将 player 绑定到其对应视图。

现在，player 需要一些可以播放的内容。为此，您要创建一个 MediaItem。有许多不同类型的 MediaItem，但您首先要针对互联网上的 MP3 文件创建一个。

若要创建 MediaItem，最简单的方法是使用 MediaItem.fromUri，后者会接受媒体文件的 URI。使用 player.setMediaItem 将 MediaItem 添加到 player。

请注意，R.string.media_url_mp3 在 strings.xml 中定义为 https://storage.googleapis.com/exoplayer-test-media-0/play.mp3。

我们的 player 可能会占用大量资源，包括内存、CPU、网络连接和硬件编解码器。其中许多资源都很短缺，尤其是对于硬件编解码器（可能只有一个）来说更是如此。当您不使用这些资源时（例如，当您的应用已置于后台时），请务必释放这些资源以供其他应用使用。

换句话说，播放器的生命周期应该与应用的生命周期相关联。若要实现这一点，您需要替换 PlayerActivity 的 4 个方法：onStart、onResume、onPause 和 onStop。

Android API 级别 24 及更高版本支持多窗口。由于您的应用在分屏模式下可见，但不处于活动状态，因此您需要在 onStart 中初始化播放器。由于 Android API 级别 24 及更低版本要求您尽可能多等些时间，直到您获取到资源为止，因此您要等到 onResume 再初始化播放器。

hideSystemUi 是在 onResume 中调用的辅助方法，借助该方法，您可以实现全屏体验。

对于 API 级别 24 及更低版本，系统并不一定会调用 onStop，因此您必须尽早在 onPause 中释放播放器。对于 API 级别 24 及更高版本（具备多窗口模式和分屏模式），系统一定会调用 onStop。在暂停状态下，您的 activity 仍然可见，因此您要等到 onStop 再释放播放器。

您现在需要创建一个 releasePlayer 方法，用于释放播放器的资源并销毁播放器。

在释放和销毁播放器之前，请存储以下信息：

这样一来，您即可从用户停止播放的位置继续播放。您需要做的就是在初始化播放器时提供这些状态信息。

现在，您要做的就是在初始化期间将您保存在 releasePlayer 中的状态信息提供给播放器。

此时会发生下列情况：

最后，一切就绪！启动应用即可播放 MP3 文件并看到嵌入的海报图片。

屏幕截图：应用正在播放一个曲目。

测试应用在 activity 生命周期的所有不同状态下是否都能正常运行。

如果要播放视频，只需将媒体项 URI 修改为 MP4 文件即可。

PlayerView 会完成所有相关操作。视频（而非海报图片）会全屏呈现。

屏幕截图：应用正在播放视频。

真厉害！您刚刚制作了一款能够在 Android 上全屏流式传输媒体的应用，以及配套的生命周期管理、保存状态和界面控件！

注意：您可以继续更新当前项目，或从 exoplayer-intro/exoplayer-codelab-01 导入项目以返回某个已知的工作状态。

您当前的应用可以播放单个媒体文件，但如果您想让多个媒体文件相继播放，该怎么办呢？为此，您需要使用播放列表。

如需创建播放列表，您可以使用 addMediaItem 向 player 添加多个 MediaItem。这样可以实现无缝播放，并且系统会在后台处理缓冲，因此在更改媒体项时，用户不会看到“正在缓冲”旋转图标。

检查播放器控件的行为方式。您可以使用 和 在媒体项序列中跳转。

屏幕截图：显示“下一个”和“上一个”按钮的播放控件

您可以通过直接在播放器上调用 addMediaItem(MediaItem item)、moveMediaItem(int fromIndex, int toIndex) 和 removeMediaItem(int index) 来修改播放列表。播放列表修改可在播放器处于任何状态时执行，包括播放器做好准备之前以及当前正在播放媒体时。

这很方便！如需了解详情，请参阅有关媒体项和播放列表的开发者文档，以及有关 Playlist API 的这篇文章。

注意：您可以继续更新当前项目，或从 exoplayer-intro/exoplayer-codelab-02 导入项目以返回某个已知的工作状态。

自适应流式传输是一种媒体流式传输技术，可根据可用网络带宽改变串流质量。借助该技术，用户可体验其带宽支持的最高质量的媒体内容。

通常，同一媒体内容会分为多个轨道，其质量（比特率和分辨率）各有不同。播放器会根据可用的网络带宽来选择轨道。

每个轨道会分成给定时长的数据块，其时长通常在 2 到 10 秒之间。这样一来，播放器就可以随着可用带宽的变化快速切换不同轨道。播放器负责将这些数据块拼接在一起以实现无缝播放。

自适应流式传输的核心是为当前环境选择最合适的轨道。您可以使用自适应轨道选择功能将您的应用更新为播放流媒体。

首先，创建一个 DefaultTrackSelector，它将负责选择媒体项中的轨道。然后，告知 trackSelector 只选择标准清晰度或更低清晰度的轨道，这是以牺牲质量为代价节省用户流量的好方法。最后，将 trackSelector 传递给构建器，以便在构建 SimpleExoPlayer 实例时使用。

DASH 是一种广泛使用的自适应流式传输格式。如需流式传输 DASH 内容，您需要像以前一样创建 MediaItem。不过，这一次，我们必须使用 MediaItem.Builder，而不是 fromUri。

这是因为 fromUri 使用文件扩展名来确定底层媒体格式，但 DASH URI 没有文件扩展名，因此我们在构造 MediaItem 时必须提供 APPLICATION_MPD 的 MIME 类型。

借助 MediaItem.Builder，您可以创建 MediaItem 并为其设置多种附加属性，其中包括：

如需了解详情，请参阅开发者指南。

注意：现在，您正在流式传输 DASH，并使用可用带宽来选择轨道。若要查看其实际效果，您可以执行以下操作：

观察每当轨道选择器需要决定使用哪个轨道时，端点是如何遇到的。

其他常用的自适应流式传输格式为 HLS (MimeTypes.APPLICATION_M3U8) 和 SmoothStreaming (MimeTypes.APPLICATION_SS)，二者均受 ExoPlayer 支持。如需详细了解其他自适应媒体来源的构造方式，请参阅 ExoPlayer 演示版应用。

注意：您可以继续更新当前项目，或从 exoplayer-intro/exoplayer-codelab-03 导入项目以返回某个已知的工作状态。

在前面的步骤中，您学习了如何流式传输渐进式媒体串流和自适应媒体串流。ExoPlayer 会在幕后为您处理大量工作，其中包括以下各项：

有时，了解 ExoPlayer 在运行时执行的操作有助于了解和改进用户的播放体验。

例如，您可能想要通过执行以下操作来反映界面中的播放状态变化：

ExoPlayer 提供了几个监听器接口，用于提供对有用事件的回调。您可以使用监听器来记录播放器所处的状态。

注意：在实现接口时，很容易将所有接口方法都放在 PlayerActivity 类中。不过，这可能会导致代码冗长，难以阅读和维护。更好的解决方案是使用工厂函数生成接口的匿名类以监听事件。这样可以让 API 保持简洁。

当播放状态发生变化时，系统会调用 onPlaybackStateChanged。新状态由 playbackState 参数提供。

播放器可能会处于以下 4 种状态之一：

状态

说明

ExoPlayer.STATE_IDLE

播放器已实例化，但尚未准备就绪。

ExoPlayer.STATE_BUFFERING

播放器无法从当前位置开始播放，因为已缓冲的数据不足。

ExoPlayer.STATE_READY

播放器可以立即从当前位置开始播放。这意味着如果播放器的 playWhenReady 属性为 true，播放器将自动开始播放媒体。如果该属性为 false，播放器会暂停播放。

ExoPlayer.STATE_ENDED

播放器已完成媒体播放。

注意：如何确定播放器是否真的在播放媒体？必须满足以下所有条件：

幸运的是，ExoPlayer 专门为此提供了一个便捷方法 ExoPlayer.isPlaying。或者，如果您想在 isPlaying 发生变化时收到通知，可以监听 onIsPlayingChanged。

如需调用您的回调，您需要向播放器注册 playbackStateListener。该操作可在 initializePlayer 中完成。

同样，您需要进行整理以避免来自播放器的悬空引用，这可能会导致内存泄漏。

ExoPlayer 提供了许多其他监听器，有助于您了解用户的播放体验。其中包括音频和视频的监听器，以及 AnalyticsListener（其中包含来自所有监听器的回调）。以下是一些最重要的方法：

可以使用 addAnalyticsListener 将 AnalyticsListener 添加到 player。音频和视频的监听器也有对应的方法。

您需要考虑哪些事件对您的应用和用户很重要。如需了解详情，请参阅监听播放器事件。事件监听器就讲到这里！

注意：您可以继续更新当前项目，或从 exoplayer-intro/exoplayer-codelab-04 导入项目以返回某个已知的工作状态。

到目前为止，您一直在使用 ExoPlayer 的 PlayerControlView 向用户显示播放控制器。

屏幕截图：默认播放控制器

如果您想更改这些控件的功能或外观，该怎么办？幸运的是，这些控件是高度可定制的。

第一项简单的自定义是完全不使用控制器。这很容易实现，只需在 activity_player.xml 中的 PlayerView 元素上使用 use_controller 属性即可。

现在试一下吧。

PlayerControlView 包含几个对其行为有影响的属性。例如，您可以使用 show_timeout 自定义从用户最后一次与控件互动到控件隐藏之间的延迟（以毫秒为单位）。为此，请执行以下操作：

PlayerControlView 的属性也可通过编程方式设置。

好了，初步设置进展不错。但是，如果您想更改 PlayerControlView 的外观或显示的按钮，该怎么办？PlayerControlView 的实现并未假设任何按钮存在，因此您可以轻松地删除按钮并添加新按钮。

我们来看看如何自定义 PlayerControlView。

屏幕截图：播放器控件视图的布局文件已创建。

如需使用自定义布局，您需要在 activity_player.xml 文件中设置 PlayerView 元素的属性 app:controller_layout_id。

屏幕截图：没有“上一个”和“下一个”按钮的自定义播放器控件视图

注意：PlayerControlView 根据 ID 标识它使用的界面元素。因此在自定义布局文件时，请勿更改标准元素的 ID（例如 @id/exo_play 和 @id/exo_pause,），否则 PlayerControlView 将无法找到它们。

您可以视需要在布局文件中应用任何更改。默认情况下，系统会选择 Android 主题的颜色。您可以替换此设置以匹配您应用的设计。

屏幕截图：彩色按钮和文本视图

注意：对于您的真实应用，您可能需要使用 Android 样式，而不是直接在布局文件的元素中设置属性。

您刚刚创建了一个自定义布局文件，并在 activity_player.xml 中使用 controller_layout_id 引用了它。

另一种方法是替换 PlayerControlView 使用的默认布局文件。从 PlayerControlView 的源代码可以看出，它使用 R.layout.exo_player_control_view 进行布局。如果您使用相同的文件名创建自己的布局文件，PlayerControlView 就会改用您的文件。

现在，activity_player.xml 中的 PlayerView 方法应如下所示：

以上操作演示了如何在此处添加您自己的元素，并将它们与标准控件元素融为一体。现在，当与控件的互动保持不变时，ExoPlayerView 会使用您的自定义控件以及所有隐藏和显示逻辑。

恭喜！您已经学习了很多关于如何将 ExoPlayer 与您的应用集成的知识。

如需详细了解 ExoPlayer，请查看开发者指南和源代码，并订阅 ExoPlayer 博客。