途徑類型

本頁面說明可透過 Media3 播放影片的不同類型介面，以及如何為您的用途選擇合適的類型。如要進一步瞭解 Android 中的 Surface 物件，請參閱這份圖像說明文件。

為 PlayerView 選擇介面類型

PlayerView 的 surface_type 屬性可讓你設定用於播放影片的介面類型。允許的值如下：

如果是用於一般影片播放，則應使用 surface_view 或 texture_view。SurfaceView 相較於 TextureView，在影片播放方面有許多優點：

  • 大幅降低許多裝置的耗電量。
  • 影格時間更準確，影片播放更流暢。
  • 在支援的裝置上輸出更高畫質的 HDR 影片。
  • 播放受 DRM 保護的內容時，支援安全輸出。
  • 在會放大 UI 層的 Android TV 裝置上，以螢幕完整解析度顯示影片內容。

因此，建議盡可能使用 SurfaceView 而非 TextureView。只有在 SurfaceView 無法滿足需求時，才應使用 TextureView。舉例來說，在 Android 7.0 (API 級別 24) 之前，如果需要流暢的動畫或影片表面捲動效果，請參閱下列附註。在這種情況下，建議僅在 SDK_INT 小於 24 (Android 7.0) 時使用 TextureView，否則請使用 SurfaceView。

在 Compose 中選擇介面類型

在 Compose 中，互通解決方案會使用 AndroidView 可組合函式包裝 SurfaceView 和 TextureView。對應的兩個可組合函式為 AndroidExternalSurface 和 AndroidEmbeddedExternalSurface。

Media3 ui-compose 模組提供 PlayerSurface 可組合函式，可透過生命週期感知方式將 Player 連結至 Surface。在本例中，途徑類型如下：

沒有 none 類型，因為這會對應至不在 Compose UI 樹狀結構中加入 PlayerSurface。