Material3 Compose

La libreria media3-ui-compose-material3 gestisce internamente sia la gestione dello stato sia lo stile Material3. Per saperne di più su quale libreria utilizzare, consulta la panoramica di Media3 Compose.

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

Personalizzare i componenti Material3

Sebbene media3-ui-compose-material3 fornisca componenti che seguono il design Material 3, hai comunque il controllo completo dei temi. Puoi personalizzare colori, tipografia e forme racchiudendo la UI del player in un MaterialTheme.

Ad esempio, per modificare il colore di PlayPauseButton, puoi fornire un colorScheme personalizzato:

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

Componenti Material3 disponibili

La libreria media3-ui-compose-material3 fornisce un insieme di componenti componibili predefiniti per i controlli comuni del player. Ecco alcuni componenti che puoi utilizzare direttamente nella tua app:

Componente Descrizione
PlayPauseButton Un pulsante che alterna la riproduzione e la pausa.
SeekBackButton Un pulsante per tornare indietro di un incremento definito.
SeekForwardButton Un pulsante per andare avanti di un incremento definito.
NextButton Un pulsante per passare all'elemento multimediale successivo.
PreviousButton Un pulsante per passare all'elemento multimediale precedente.
RepeatButton Un pulsante per scorrere le modalità di ripetizione.
ShuffleButton Un pulsante per attivare/disattivare la modalità di riproduzione casuale.
MuteButton Un pulsante per attivare e disattivare l'audio del player.
PositionAndDurationText Un composable di testo che mostra la posizione corrente e la durata totale.
PositionText Un composable di testo che mostra la posizione attuale.
DurationText Un composable di testo che mostra la durata totale.
RemainingDurationText Un composable di testo che mostra la durata rimanente.

Questo elenco non è esaustivo. Per tutti i componenti disponibili, consulta il riferimento API della libreria.

Altri due componenti predefiniti che probabilmente ti serviranno sono correlati alla gestione della superficie e si trovano nel modulo media3-ui-compose perché non hanno temi Material.

Componente Descrizione
ContentFrame Una superficie per la visualizzazione di contenuti multimediali che gestisce le proporzioni, il ridimensionamento e un otturatore
PlayerSurface Superficie grezza che avvolge SurfaceView e TextureView in AndroidView