Oberflächentypen

Auf dieser Seite werden die verschiedenen Arten von Oberflächen beschrieben, die für die Videowiedergabe mit Media3 verwendet werden können, und wie Sie den richtigen Typ für Ihren Anwendungsfall auswählen. Weitere Informationen zu Surface-Objekten in Android finden Sie in dieser Grafikdokumentation.

Oberfläche festlegen

Es gibt vier Einstiegspunkte, über die die Player ihre Videoausgabe mit einem Surface verbinden kann:

Es gibt auch verschiedene Möglichkeiten, sie zu löschen:

Oberflächentyp für PlayerView auswählen

Mit dem Attribut surface_type von PlayerView können Sie den Typ der Oberfläche für die Videowiedergabe festlegen. Zulässige Werte:

  • surface_view (SurfaceView)
  • texture_view (TextureView)
  • spherical_gl_surface_view (SphericalGLSurfaceView) – für die Wiedergabe von sphärischen Videos
  • video_decoder_gl_surface_view (VideoDecoderGLSurfaceView) – Videorendering mit Erweiterungs-Renderern
  • none: Nur für die Audiowiedergabe. Damit lässt sich das Erstellen einer Oberfläche vermeiden, was sehr aufwendig sein kann.

Wenn die Ansicht für die reguläre Videowiedergabe vorgesehen ist, sollte surface_view oder texture_view verwendet werden. SurfaceView bietet gegenüber TextureView eine Reihe von Vorteilen für die Videowiedergabe:

  • Deutlich geringerer Stromverbrauch auf vielen Geräten.
  • Präziseres Frame-Timing, was zu einer flüssigeren Videowiedergabe führt.
  • Unterstützung für HDR-Videoausgabe in höherer Qualität auf kompatiblen Geräten.
  • Unterstützung für die sichere Ausgabe bei der Wiedergabe von DRM-geschützten Inhalten.
  • Die Möglichkeit, Videoinhalte auf Android TV-Geräten, die die UI-Ebene hochskalieren, in der vollen Auflösung des Displays zu rendern.

SurfaceView sollte daher nach Möglichkeit gegenüber TextureView bevorzugt werden. TextureView sollte nur verwendet werden, wenn SurfaceView Ihre Anforderungen nicht erfüllt. Ein Beispiel ist, wenn vor Android 7.0 (API-Level 24) flüssige Animationen oder das Scrollen der Videooberfläche erforderlich sind, wie in den folgenden Hinweisen beschrieben. In diesem Fall ist es besser, TextureView nur zu verwenden, wenn SDK_INT kleiner als 24 (Android 7.0) ist, und andernfalls SurfaceView zu verwenden.

Oberflächentyp in Compose auswählen

In Compose wird die Interoperabilitätslösung mit dem AndroidView-Composable verwendet, um SurfaceView und TextureView zu umschließen. Die beiden entsprechenden Composables sind AndroidExternalSurface und AndroidEmbeddedExternalSurface aus androidx.compose.foundation. Diese Proxy-Klassen bieten jedoch eine API-Oberfläche, die den Zugriff auf die zugrunde liegenden Ansichten einschränkt. Diese Ansichten werden von Player benötigt, um den vollständigen Lebenszyklus der Oberfläche (Erstellung und Größenaktualisierungen) zu verarbeiten.

Im Modul media3-ui-compose finden Sie die Composables ContentFrame und PlayerSurface, die Player mit Surface auf lebenszyklusbewusste Weise verknüpfen. Die Oberflächentypen sind in diesem Fall:

  • androidx.media3.ui.compose.SURFACE_TYPE_SURFACE_VIEW
  • androidx.media3.ui.compose.SURFACE_TYPE_TEXTURE_VIEW

Es gibt keinen Typ none, da dies dem Nicht-Einbeziehen der komponierbaren Funktion in den Compose-UI-Baum entsprechen würde.

Informationen zum Verwalten von Videoseitenverhältnissen, dynamischer Fenstergröße und Inhaltsskalierung in Compose finden Sie unter Medieninhalte für verschiedene Formfaktoren skalieren.