网络堆栈

ExoPlayer 通常用于通过互联网流式传输媒体内容。它支持多个网络堆栈来发出底层网络请求。网络堆栈的选择会对流式传输性能产生重大影响。

本页概述了如何配置 ExoPlayer 以使用您选择的网络堆栈，列出了可用的选项，提供了一些有关如何为应用选择网络堆栈的指导，并介绍了如何为流式传输的媒体启用缓存。

配置 ExoPlayer 以使用特定网络堆栈

ExoPlayer 通过 DataSource 组件加载数据，这些组件是从应用代码注入的 DataSource.Factory 实例中获取的。

如果您的应用只需要播放 http(s) 内容，那么选择网络堆栈非常简单，只需将应用注入的任何 DataSource.Factory 实例更新为与您希望使用的网络堆栈对应的 HttpDataSource.Factory 实例即可。如果您的应用还需要播放非 http(s) 内容（例如本地文件），请使用 DefaultDataSource.Factory：

Kotlin

DefaultDataSource.Factory(
  ...
  /* baseDataSourceFactory= */ PreferredHttpDataSource.Factory(...))

Java

new DefaultDataSource.Factory(
    ...
    /* baseDataSourceFactory= */ new PreferredHttpDataSource.Factory(...));

在此示例中，PreferredHttpDataSource.Factory 是与您的首选网络堆栈对应的工厂。DefaultDataSource.Factory 层添加了对非 http(s) 源（例如本地文件）的支持。

以下示例展示了如何构建将使用 Cronet 网络堆栈且还支持播放非 http(s) 内容的 ExoPlayer。

Kotlin

// Given a CronetEngine and Executor, build a CronetDataSource.Factory.
val cronetDataSourceFactory = CronetDataSource.Factory(cronetEngine, executor)

// Wrap the CronetDataSource.Factory in a DefaultDataSource.Factory, which adds
// in support for requesting data from other sources (such as files, resources,
// etc).
val dataSourceFactory =
  DefaultDataSource.Factory(context, /* baseDataSourceFactory= */ cronetDataSourceFactory)

// Inject the DefaultDataSource.Factory when creating the player.
val player =
  ExoPlayer.Builder(context)
    .setMediaSourceFactory(
      DefaultMediaSourceFactory(context).setDataSourceFactory(dataSourceFactory)
    )
    .build()

Java

// Given a CronetEngine and Executor, build a CronetDataSource.Factory.
CronetDataSource.Factory cronetDataSourceFactory =
    new CronetDataSource.Factory(cronetEngine, executor);

// Wrap the CronetDataSource.Factory in a DefaultDataSource.Factory, which adds
// in support for requesting data from other sources (such as files, resources,
// etc).
DefaultDataSource.Factory dataSourceFactory =
    new DefaultDataSource.Factory(
        context, /* baseDataSourceFactory= */ cronetDataSourceFactory);

// Inject the DefaultDataSource.Factory when creating the player.
ExoPlayer player =
    new ExoPlayer.Builder(context)
        .setMediaSourceFactory(
            new DefaultMediaSourceFactory(context).setDataSourceFactory(dataSourceFactory))
        .build();

支持的网络栈

ExoPlayer 直接支持 HttpEngine、Cronet、OkHttp 和 Android 的内置默认网络堆栈。ExoPlayer 还可以扩展为支持可在 Android 上运行的任何其他网络堆栈。

HttpEngine

HttpEngine 是 Android 上从 API 34（或 S 扩展程序 7）开始推荐的默认网络栈。在大多数情况下，它在内部使用 Cronet 网络堆栈，支持通过 QUIC 协议使用 HTTP、HTTP/2 和 HTTP/3 协议。

ExoPlayer 通过其 HttpEngineDataSource.Factory 支持 HttpEngine。您可以按照配置 ExoPlayer 以使用特定网络堆栈中所述注入此数据源工厂。

Cronet

Cronet 是以库的形式提供给 Android 应用使用的 Chromium 网络堆栈。Cronet 利用多种技术来减少延迟和提高网络请求吞吐量，以满足您的应用的运行需要，包括 ExoPlayer 发出的请求。它本身支持 HTTP、HTTP/2 和 HTTP/3 over QUIC 协议。Cronet 被一些全球最大的在线媒体应用（包括 YouTube）所使用。

ExoPlayer 通过其 Cronet 库支持 Cronet。如需详细了解如何使用该库，请参阅其 README.md。请注意，Cronet 库能够使用三种底层 Cronet 实现：

1. Google Play 服务：我们建议在大多数情况下使用此实现，并在 Google Play 服务不可用时回退到 Android 的内置网络堆栈 (DefaultHttpDataSource)。
2. 嵌入式 Cronet：如果您的用户中有很大一部分位于 Google Play 服务未广泛普及的市场，或者您想精确控制所用 Cronet 实现的版本，那么嵌入式 Cronet 可能是不错的选择。Cronet Embedded 的主要缺点是会使应用大小增加大约 8MB。
3. Cronet 回退：Cronet 的回退实现将 Cronet 的 API 实现为 Android 内置网络堆栈的封装容器。它不应与 ExoPlayer 搭配使用，因为直接使用 Android 的内置网络堆栈（通过使用 DefaultHttpDataSource）效率更高。

OkHttp

OkHttp 是另一个现代网络堆栈，被许多热门 Android 应用广泛使用。它支持 HTTP 和 HTTP/2，但尚不支持通过 QUIC 实现的 HTTP/3。

ExoPlayer 通过其 OkHttp 库支持 OkHttp。如需详细了解如何使用该库，请参阅其 README.md。使用 OkHttp 库时，网络堆栈会嵌入到应用中。这与 Cronet Embedded 类似，但 OkHttp 的大小要小得多，只会使应用增加不到 1MB。

Android 的内置网络堆栈

注意： 在 API 34（或 S 扩展程序 7）及更高版本中，建议使用的内置网络堆栈是 HttpEngine。

ExoPlayer 支持将 Android 的内置网络堆栈与 DefaultHttpDataSource 和 DefaultHttpDataSource.Factory 配合使用，这两个类是核心 ExoPlayer 库的一部分。

确切的网络堆栈实现取决于底层设备上运行的软件。在大多数设备上，仅支持 HTTP（即不支持 HTTP/2 和基于 QUIC 的 HTTP/3）。

其他网络栈

应用还可以将其他网络堆栈与 ExoPlayer 集成。为此，请实现一个封装网络堆栈的 HttpDataSource，以及一个对应的 HttpDataSource.Factory。ExoPlayer 的 Cronet 和 OkHttp 库很好地展示了如何实现这一点。

在与纯 Java 网络堆栈集成时，最好实现一个 DataSourceContractTest 来检查 HttpDataSource 实现是否正常运行。OkHttp 库中的 OkHttpDataSourceContractTest 是一个很好的示例，展示了如何实现此目的。

选择网络堆栈

下表概述了 ExoPlayer 支持的网络堆栈的优缺点。

网络堆栈	协议	对 APK 大小的影响	备注
HttpEngine	HTTP HTTP/2 基于 QUIC 的 HTTP/3	无	仅适用于 API 34 或 S 扩展程序 7
Cronet (Google Play 服务)	HTTP HTTP/2 基于 QUIC 的 HTTP/3	小 （<100KB）	需要 Google Play 服务。Cronet 版本会自动更新
Cronet（嵌入式）	HTTP HTTP/2 基于 QUIC 的 HTTP/3	大 （约 8MB）	由应用开发者控制的 Cronet 版本
Cronet（后备）	HTTP （因设备而异）	小 （<100KB）	不建议用于 ExoPlayer
OkHttp	HTTP HTTP/2	小 （不到 1 MB）
内置网络堆栈	HTTP （因设备而异）	无	实现方式因设备而异

通过 QUIC 协议实现的 HTTP/2 和 HTTP/3 可以显著提升媒体流式传输性能。具体而言，当流式传输使用内容分发网络 (CDN) 分发的自适应媒体时，在某些情况下，使用这些协议可以使 CDN 的运行效率更高。因此，与使用 Android 的内置网络堆栈相比，HttpEngine 和 Cronet 对基于 QUIC 的 HTTP/2 和 HTTP/3 的支持（以及 OkHttp 对 HTTP/2 的支持）是一项重大优势，前提是托管内容的服务器也支持这些协议。

如果仅考虑媒体流式传输，我们建议使用 Google Play 服务提供的 HttpEngine 或 Cronet，并在 Google Play 服务不可用时回退到 DefaultHttpDataSource。此建议在以下两方面取得了良好的平衡：在大多数设备上启用通过 QUIC 使用 HTTP/2 和 HTTP/3，同时避免 APK 大小显著增加。此建议也有例外情况。如果您的应用将在很大一部分可能无法使用 Google Play 服务的设备上运行，那么使用 Cronet 嵌入式或 OkHttp 可能更合适。如果 APK 大小是关键问题，或者媒体流式传输只是应用功能的一小部分，那么使用内置的网络堆栈可能可以接受。

除了媒体之外，通常最好为应用执行的所有网络操作选择单个网络堆栈。这样一来，ExoPlayer 和其他应用组件就可以高效地共享资源（例如套接字）。

注意： 为了帮助实现资源共享，建议在整个应用中使用单个 HttpEngine、CronetEngine 或 OkHttpClient 实例（分别在使用 HttpEngine、Cronet 或 OkHttp 时）。

由于您的应用很可能需要执行与媒体播放无关的网络操作，因此您在选择网络堆栈时，最终应考虑上述针对单独媒体流的建议、执行网络操作的任何其他组件的要求，以及这些组件对您的应用的相对重要性。

缓存媒体

ExoPlayer 支持将已加载的字节缓存到磁盘，以防止从网络重复加载相同的字节。当您想在当前媒体中向后搜索或重复播放同一项内容时，此功能非常有用。

注意： 您还可以按照下载媒体中的说明，在播放之外更永久地下载媒体。

缓存需要指向专用缓存目录的 SimpleCache 实例和 CacheDataSource.Factory：

Kotlin

// Note: This should be a singleton in your app.
val databaseProvider = StandaloneDatabaseProvider(context)

// An on-the-fly cache should evict media when reaching a maximum disk space limit.
val cache =
    SimpleCache(
        downloadDirectory, LeastRecentlyUsedCacheEvictor(maxBytes), databaseProvider)

// Configure the DataSource.Factory with the cache and factory for the desired HTTP stack.
val cacheDataSourceFactory =
    CacheDataSource.Factory()
        .setCache(cache)
        .setUpstreamDataSourceFactory(httpDataSourceFactory)

// Inject the DefaultDataSource.Factory when creating the player.
val player =
    ExoPlayer.Builder(context)
        .setMediaSourceFactory(
            DefaultMediaSourceFactory(context).setDataSourceFactory(cacheDataSourceFactory))
        .build()

Java

// Note: This should be a singleton in your app.
DatabaseProvider databaseProvider = new StandaloneDatabaseProvider(context);

// An on-the-fly cache should evict media when reaching a maximum disk space limit.
Cache cache =
    new SimpleCache(
        downloadDirectory, new LeastRecentlyUsedCacheEvictor(maxBytes), databaseProvider);

// Configure the DataSource.Factory with the cache and factory for the desired HTTP stack.
DataSource.Factory cacheDataSourceFactory =
    new CacheDataSource.Factory()
        .setCache(cache)
        .setUpstreamDataSourceFactory(httpDataSourceFactory);

// Inject the DefaultDataSource.Factory when creating the player.
ExoPlayer player =
    new ExoPlayer.Builder(context)
        .setMediaSourceFactory(
            new DefaultMediaSourceFactory(context).setDataSourceFactory(cacheDataSourceFactory))
        .build();