ExoPlayer 通常用於透過網際網路串流媒體。支援多個網路堆疊,可發出基礎網路要求。選擇的網路堆疊可能會對串流效能產生重大影響。
本頁面說明如何設定 ExoPlayer,以便使用您選擇的網路堆疊、列出可用選項、提供一些有關如何為應用程式選擇網路堆疊的指南,並說明如何為串流媒體啟用快取功能。
設定 ExoPlayer 使用特定網路堆疊
ExoPlayer 會透過 DataSource 元件載入資料,這些元件是從應用程式程式碼插入的 DataSource.Factory 執行個體取得。
如果應用程式只需要播放 http(s) 內容,只要更新應用程式插入的任何 DataSource.Factory 執行個體,使其成為與您要使用的網路堆疊相對應的 HttpDataSource.Factory 執行個體,即可選取網路堆疊。如果應用程式也需要播放非 HTTP(S) 內容 (例如本機檔案),請使用 DefaultDataSource.Factory:
Kotlin
DefaultDataSource.Factory( context, /* baseDataSourceFactory= */ PreferredHttpDataSource.Factory(context), )
Java
new DefaultDataSource.Factory( context, /* baseDataSourceFactory= */ new PreferredHttpDataSource.Factory(context));
在這個範例中,PreferredHttpDataSource.Factory 是對應至偏好網路堆疊的工廠。DefaultDataSource.Factory 層可支援非 HTTP(S) 來源,例如本機檔案。
以下範例說明如何建構 ExoPlayer,以便使用 Cronet 網路堆疊,並支援播放非 HTTP(S) 內容。
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 網路堆疊,支援 HTTP、HTTP/2 和 HTTP/3 over QUIC 通訊協定。
ExoPlayer 透過 HttpEngineDataSource.Factory 支援 HttpEngine。您可以按照「設定 ExoPlayer 使用特定網路堆疊」一節所述,插入這個資料來源工廠。
Cronet
Cronet 是 Chromium 網路堆疊,可做為供 Android 應用程式使用的程式庫。Cronet 利用多項技術縮短延遲時間,並提高應用程式運作所需的網路要求總處理量,包括 ExoPlayer 提出的要求。原生支援 HTTP、HTTP/2 和 HTTP/3 over QUIC 通訊協定。全球一些大型串流應用程式 (包括 YouTube) 都使用 Cronet。
ExoPlayer 透過 Cronet 程式庫支援 Cronet。如需詳細的使用說明,請參閱程式庫的 README.md。請注意,Cronet 程式庫可以使用三種基礎 Cronet 實作:
- Google Play 服務:在多數情況下,建議您使用這項實作,並在 Google Play 服務無法使用時,改用 Android 內建的網路堆疊 (
DefaultHttpDataSource)。 - Cronet Embedded:如果您的使用者有很大一部分位於 Google Play 服務不普及的市場,或者您想控管所用 Cronet 實作項目的確切版本,這可能是合適的選擇。Cronet Embedded 的主要缺點是會增加約 8 MB 的應用程式大小。
- 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 的大小明顯較小,只會為應用程式增加不到 1 MB。
Android 內建網路堆疊
ExoPlayer 支援使用 Android 內建網路堆疊,並搭配 DefaultHttpDataSource 和 DefaultHttpDataSource.Factory,這些是 ExoPlayer 核心程式庫的一部分。
確切的網路堆疊實作方式取決於基礎裝置上執行的軟體。大多數裝置僅支援 HTTP (也就是不支援 HTTP/2 和 HTTP/3 over QUIC)。
其他網路堆疊
應用程式也可以將其他網路堆疊與 ExoPlayer 整合。方法是實作包裝網路堆疊的 HttpDataSource,以及對應的 HttpDataSource.Factory。ExoPlayer 的 Cronet 和 OkHttp 程式庫就是很好的範例。
與純 Java 網路堆疊整合時,建議您實作 DataSourceContractTest,確認 HttpDataSource 實作行為正確。OkHttp 程式庫中的 OkHttpDataSourceContractTest 是很好的範例,說明如何執行這項操作。
選擇網路堆疊
下表列出 ExoPlayer 支援的網路堆疊優缺點。
| 網路堆疊 | 通訊協定 | APK 大小影響 | 附註 |
|---|---|---|---|
| HttpEngine | HTTP HTTP/2 HTTP/3 over QUIC |
無 | 僅適用於 API 34 或 S 擴充功能 7 |
| Cronet (Google Play 服務) | HTTP HTTP/2 HTTP/3 over QUIC |
小 (<100 KB) |
必須安裝 Google Play 服務。Cronet 版本會自動更新 |
| Cronet (內嵌) | HTTP HTTP/2 HTTP/3 over QUIC |
大 (~8MB) |
Cronet 版本由應用程式開發人員控管 |
| Cronet (備用) | HTTP (因裝置而異) |
小 (<100 KB) |
不建議用於 ExoPlayer |
| OkHttp | HTTP HTTP/2 |
小 (<1MB) |
|
| 內建網路堆疊 | HTTP (因裝置而異) |
無 | 導入方式因裝置而異 |
HTTP/2 和 HTTP/3 over QUIC 通訊協定可大幅提升媒體串流效能。特別是串流使用內容傳遞網路 (CDN) 發布的自動調整媒體時,在某些情況下,使用這些通訊協定可讓 CDN 運作更有效率。因此,相較於使用 Android 內建網路堆疊,HttpEngine 和 Cronet 支援 HTTP/2 和 HTTP/3 over QUIC (以及 OkHttp 支援 HTTP/2) 是一大優勢,前提是託管內容的伺服器也支援這些通訊協定。
如果只考慮媒體串流,建議使用 Google Play 服務提供的 HttpEngine 或 Cronet,並在 Google Play 服務無法使用時,改用 DefaultHttpDataSource。這項建議在大多數裝置上啟用 HTTP/2 和 HTTP/3 over QUIC,以及避免 APK 大幅增加之間取得良好平衡。這項建議有例外狀況。如果執行應用程式的大部分裝置可能無法使用 Google Play 服務,則使用 Cronet Embedded 或 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();