Material3 Compose

media3-ui-compose-material3 kitaplığı, hem durum yönetimini hem de Material3 stilini dahili olarak işler. Hangi kitaplığın kullanılacağı hakkında daha fazla bilgi için Media3 Compose'a genel bakış başlıklı makaleyi inceleyin.

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

Material3 bileşenlerini özelleştirme

media3-ui-compose-material3, Material 3 tasarımına uygun bileşenler sunsa da temalandırma üzerinde tam kontrol sahibi olursunuz. Oynatıcı kullanıcı arayüzünüzü MaterialTheme ile sarmalayarak renkleri, tipografiyi ve şekilleri özelleştirebilirsiniz.

Örneğin, PlayPauseButton rengini değiştirmek için özel bir colorScheme sağlayabilirsiniz:

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

Kullanılabilir Material 3 bileşenleri

media3-ui-compose-material3 kitaplığı, yaygın oynatıcı kontrolleri için önceden oluşturulmuş bir dizi composable sağlar. Uygulamanızda doğrudan kullanabileceğiniz bileşenlerden bazıları şunlardır:

Bileşen Açıklama
PlayPauseButton Oynatma ve duraklatma arasında geçiş yapan bir düğme.
SeekBackButton Belirli bir artışla geri sarmaya yarayan düğme.
SeekForwardButton Belirli bir artışla ileri sarmak için kullanılan düğme.
NextButton Sonraki medya öğesine gitmek için kullanılan düğme.
PreviousButton Önceki medya öğesine gitmek için kullanılan düğme.
RepeatButton Tekrarlama modları arasında geçiş yapmaya yarayan bir düğme.
ShuffleButton Karıştırma modunu açıp kapatmak için bir düğme.
MuteButton Oynatıcının sesini kapatıp açma düğmesi
PositionAndDurationText Mevcut konumu ve toplam süreyi gösteren bir metin composable'ı.
PositionText Mevcut konumu gösteren bir metin composable'ı.
DurationText Toplam süreyi gösteren bir metin composable'ı.
RemainingDurationText Kalan süreyi gösteren bir metin composable'ı.

Bu liste tam kapsamlı değildir. Kullanılabilir tüm bileşenler için kitaplığın API referansına bakın.

İhtiyaç duyabileceğiniz diğer iki hazır composable, yüzey yönetimiyle ilgilidir ve Material teması içermediğinden media3-ui-compose modülünde bulunur.

Bileşen Açıklama
ContentFrame En boy oranı yönetimi, yeniden boyutlandırma ve deklanşör işlevlerini yerine getiren, medya içeriğini görüntüleme yüzeyi
PlayerSurface AndroidView içinde SurfaceView ve TextureView öğelerini saran ham yüzey