网络堆栈

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

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

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

Cronet

Cronet 是作为库提供给 Android 应用的 Chromium 网络堆栈。Cronet 利用多种技术来降低延迟并提高应用(包括 ExoPlayer 发出的请求)所需网络请求的吞吐量。它原生支持 HTTP、HTTP/2 和基于 QUIC 的 HTTP/3 协议。Cronet 被包括 YouTube 在内的一些全球最大的流媒体应用使用。

ExoPlayer 通过其Cronet 库支持 Cronet。有关如何使用的详细说明,请参阅该库的 README.md。请注意,Cronet 库能够使用三种底层 Cronet 实现

  1. Google Play 服务:在大多数情况下,我们建议使用此实现;如果 Google Play 服务不可用,则回退到 Android 的内置网络堆栈 (DefaultHttpDataSource)。
  2. 嵌入式 Cronet:如果您的很大一部分用户位于 Google Play 服务不广泛可用的市场,或者您想控制所使用的 Cronet 实现的确切版本,这可能是一个不错的选择。嵌入式 Cronet 的主要缺点是它会为您的应用增加大约 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,但 OkHttp 的体积要小得多,为您的应用增加不到 1MB 的大小。

Android 的内置网络堆栈

ExoPlayer 支持使用 Android 的内置网络堆栈,包括 DefaultHttpDataSourceDefaultHttpDataSource.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

(<1MB)
内置网络堆栈 HTTP
(因设备而异)
实现因设备而异

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

在单独考虑媒体流式传输时,我们建议使用由 Google Play 服务提供的 HttpEngine 或 Cronet,如果 Google Play 服务不可用,则回退到 DefaultHttpDataSource。此建议在大多数设备上实现 HTTP/2 和基于 QUIC 的 HTTP/3 之间取得了良好的平衡,并避免了 APK 大幅增加。此建议也有例外。对于 Google Play 服务可能在运行您应用的很大一部分设备上不可用的情况,使用嵌入式 Cronet 或 OkHttp 可能更合适。如果 APK 大小是关键考虑因素,或者媒体流式传输只是您应用功能的一小部分,则使用内置网络堆栈可能是可接受的。

除了媒体之外,通常最好为您的应用执行的所有网络操作选择一个单一的网络堆栈。这允许资源(如套接字)在 ExoPlayer 和其他应用组件之间高效地池化和共享。

由于您的应用很可能需要执行与媒体播放无关的网络操作,因此您选择的网络堆栈最终应考虑我们上述针对独立媒体流式传输的建议、任何执行网络操作的其他组件的要求以及它们对您的应用的重要性。

缓存媒体

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();