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:
void setVideoSurface(@Nullable Surface surface)void setVideoSurfaceHolder(@Nullable SurfaceHolder surfaceHolder)void setVideoSurfaceView(@Nullable SurfaceView surfaceView)void setVideoTextureView(@Nullable TextureView textureView)
Es gibt auch verschiedene Möglichkeiten, sie zu löschen:
void clearVideoSurface()void clearVideoSurface(@Nullable Surface surface)void clearVideoSurfaceHolder(@Nullable SurfaceHolder surfaceHolder)void clearVideoSurfaceView(@Nullable SurfaceView surfaceView)void clearVideoTextureView(@Nullable TextureView textureView)
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 Videosvideo_decoder_gl_surface_view(VideoDecoderGLSurfaceView) – Videorendering mit Erweiterungs-Renderernnone: 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_VIEWandroidx.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.