Material3 Compose

Die Bibliothek media3-ui-compose-material3 übernimmt intern sowohl die Statusverwaltung als auch das Material3-Styling. Weitere Informationen dazu, welche Bibliothek verwendet werden sollte, finden Sie in der Media3 Compose-Übersicht.

// The library provides styled UI components
Row {
  SeekBackButton(player)
  PlayPauseButton(player)
  SeekForwardButton(player)
}
ComposeMaterial3Snippets.kt

Material3-Komponenten anpassen

media3-ui-compose-material3 bietet zwar Komponenten, die dem Material3-Design folgen, Sie haben aber weiterhin die volle Kontrolle über das Theming. Sie können Farben, Typografie und Formen anpassen, indem Sie die Benutzeroberfläche des Players in ein MaterialTheme einfügen.

Wenn Sie beispielsweise die Farbe des PlayPauseButton ändern möchten, können Sie einen benutzerdefinierten colorScheme angeben:

MaterialTheme(
  colorScheme =
    lightColorScheme(
      primary = Color.Red, // Change the primary color for the button
      onPrimary = Color.White,
    )
) {
  // The PlayPauseButton will now use the custom colors
  PlayPauseButton(player)
}
ComposeMaterial3Snippets.kt

Verfügbare Material3-Komponenten

Die media3-ui-compose-material3-Bibliothek bietet eine Reihe vordefinierter Composables für gängige Player-Steuerelemente. Hier sind einige Komponenten, die Sie direkt in Ihrer App verwenden können:

Komponente	Beschreibung
PlayPauseButton	Eine Schaltfläche, mit der zwischen Wiedergabe und Pause umgeschaltet wird.
SeekBackButton	Eine Schaltfläche zum Zurückspulen um ein definiertes Intervall.
SeekForwardButton	Eine Schaltfläche zum Vorspulen um einen bestimmten Wert.
NextButton	Eine Schaltfläche zum Springen zum nächsten Media-Element.
PreviousButton	Eine Schaltfläche zum Springen zum vorherigen Medienelement.
RepeatButton	Eine Schaltfläche zum Durchlaufen der Wiederholungsmodi.
ShuffleButton	Eine Schaltfläche zum Aktivieren und Deaktivieren des Zufallsmodus.
MuteButton	Eine Schaltfläche zum Stummschalten und Aufheben der Stummschaltung des Players.
PositionAndDurationText	Eine Text-Composable, die die aktuelle Position und die Gesamtdauer anzeigt.
PositionText	Eine Text-Composable, die die aktuelle Position anzeigt.
DurationText	Eine Text-Composable, die die Gesamtdauer anzeigt.
RemainingDurationText	Ein Text-Composable, das die verbleibende Dauer anzeigt.

Diese Liste ist nicht vollständig. Alle verfügbaren Komponenten finden Sie in der API-Referenz der Bibliothek.

Zwei weitere vorgefertigte Composables, die Sie wahrscheinlich benötigen, beziehen sich auf die Oberflächenverwaltung und befinden sich im media3-ui-compose-Modul, da sie kein Material-Theming haben.

Komponente	Beschreibung
ContentFrame	Eine Oberfläche zur Darstellung von Medieninhalten, die das Seitenverhältnis, die Größenanpassung und einen Verschluss berücksichtigt
PlayerSurface	Rohoberfläche, die SurfaceView und TextureView in AndroidView umschließt