Material3 Compose

Die Bibliothek media3-ui-compose-material3 bietet eine Player zusammensetzbare Funktion, die Player-Steuerelemente, eine Fortschrittsanzeige und aktuelle Medieninhalte anzeigt. Sie verwaltet sowohl den Status als auch das Material3-Styling intern. Weitere Informationen zur Verwendung der Bibliothek finden Sie in der Übersicht zu Media3 Compose.

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

// You can rearrange the composables into a layout that suits your needs
@Composable
fun PlayerProgressControlsLeftAligned(player: Player) {
  Row {
    PositionAndDurationText(player)
    ProgressSlider(player)
  }
}

@Composable
fun PlayerProgressControlsCenterAligned(player: Player) {
  Row {
    PositionText(player)
    ProgressSlider(player)
    DurationText(player)
  }
}
ComposeMaterial3.kt

Material3-Komponenten anpassen

Die Bibliothek media3-ui-compose-material3 bietet Komponenten, die dem Material3-Design folgen. Sie haben jedoch weiterhin die volle Kontrolle über das Design. Sie können Farben, Typografie und Formen anpassen, indem Sie die Player-UI in ein MaterialTheme einfügen.

Wenn Sie beispielsweise die Farbe des PlayPauseButton ändern möchten, können Sie ein benutzerdefiniertes 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)
}
ComposeMaterial3.kt

Verfügbare Material3-Komponenten

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

Komponente	Beschreibung
Player	Ein Player mit Steuerelementen, Fortschrittsanzeige und Inhaltsrahmen.
PlayPauseButton	Eine Schaltfläche zum Umschalten zwischen Wiedergabe und Pause.
SeekBackButton	Eine Schaltfläche zum Zurückspulen um ein festgelegtes Intervall.
SeekForwardButton	Eine Schaltfläche zum Vorspulen um ein festgelegtes Intervall.
NextButton	Eine Schaltfläche zum Wechseln zum nächsten Medienelement.
PreviousButton	Eine Schaltfläche zum Wechseln zum vorherigen Medienelement.
RepeatButton	Eine Schaltfläche zum Durchlaufen der Wiederholungsmodi.
ShuffleButton	Eine Schaltfläche zum Umschalten des Zufallsmodus.
MuteButton	Eine Schaltfläche zum Stummschalten und Aufheben der Stummschaltung des Players.
PositionAndDurationText	Eine zusammensetzbare Textfunktion, die die aktuelle Position und die Gesamtdauer anzeigt.
PositionText	Eine zusammensetzbare Textfunktion, die die aktuelle Position anzeigt.
DurationText	Eine zusammensetzbare Textfunktion, die die Gesamtdauer anzeigt.
RemainingDurationText	Eine zusammensetzbare Textfunktion, die die verbleibende Dauer anzeigt.
ProgressSlider	Ein Schieberegler, der den Wiedergabefortschritt anzeigt und dem Nutzer das Spulen ermöglicht.

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

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

Komponente	Beschreibung
ContentFrame	Eine Oberfläche zum Anzeigen von Medieninhalten, die das Seitenverhältnis, die Größenänderung und einen Verschluss verwaltet.
PlayerSurface	Rohe Oberfläche, die SurfaceView und TextureView in AndroidView umschließt.