Compose Material3

Library media3-ui-compose-material3 menangani pengelolaan status dan gaya Material3 secara internal. Untuk mengetahui informasi selengkapnya tentang library yang akan digunakan, lihat Ringkasan Media3 Compose.

// The library provides styled UI components
Row {
  SeekBackButton(player)
  PlayPauseButton(player)
  SeekForwardButton(player)
}
ComposeMaterial3Snippets.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)
  }
}

ComposeMaterial3Snippets.kt

Menyesuaikan Komponen Material3

Meskipun media3-ui-compose-material3 menyediakan komponen yang mengikuti Desain Material 3, Anda tetap memiliki kontrol penuh atas tema. Anda dapat menyesuaikan warna, tipografi, dan bentuk dengan membungkus UI pemutar dalam MaterialTheme.

Misalnya, untuk mengubah warna PlayPauseButton, Anda dapat memberikan colorScheme kustom:

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

Komponen Material3 yang Tersedia

Library media3-ui-compose-material3 menyediakan serangkaian composable bawaan untuk kontrol pemutar umum. Berikut beberapa komponen yang dapat Anda gunakan langsung di aplikasi:

Komponen Deskripsi
PlayPauseButton Tombol yang beralih antara putar dan jeda.
SeekBackButton Tombol untuk mencari mundur dengan inkrement yang ditentukan.
SeekForwardButton Tombol untuk mencari ke depan dengan penambahan yang ditentukan.
NextButton Tombol untuk mencari item media berikutnya.
PreviousButton Tombol untuk mencari item media sebelumnya.
RepeatButton Tombol untuk berganti-ganti mode pengulangan.
ShuffleButton Tombol untuk mengaktifkan/menonaktifkan mode acak.
MuteButton Tombol untuk membisukan dan membunyikan pemutar.
PositionAndDurationText Composable teks yang menampilkan posisi saat ini dan total durasi.
PositionText Composable teks yang menampilkan posisi saat ini.
DurationText Composable teks yang menampilkan durasi total.
RemainingDurationText Composable teks yang menampilkan durasi yang tersisa.
ProgressSlider Penggeser yang menampilkan progres pemutaran dan memungkinkan pengguna mencari.

Ini bukan daftar lengkap. Lihat referensi API library untuk semua komponen yang tersedia.

Dua Composable bawaan lainnya yang mungkin Anda butuhkan terkait dengan pengelolaan permukaan dan berada di modul media3-ui-compose karena tidak memiliki tema Material.

Komponen Deskripsi
ContentFrame Platform untuk menampilkan konten media yang menangani pengelolaan rasio aspek, pengubahan ukuran, dan rana
PlayerSurface Permukaan mentah yang membungkus SurfaceView dan TextureView dalam AndroidView