Material3 Compose

کتابخانه media3-ui-compose-material3 یک Player «ترکیب‌شدنی» ارائه می‌دهد که کنترل‌های پخش‌کننده، نوار پیشرفت، و محتوای رسانه‌ای فعلی را نشان می‌دهد. این ویجت هم مدیریت وضعیت و هم سبک‌بندی Material3 را به‌صورت داخلی انجام می‌دهد. برای اطلاعات بیشتر درباره اینکه از کدام کتابخانه استفاده کنید، نمای کلی 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»

درحالی‌که media3-ui-compose-material3 مؤلفه‌هایی را ارائه می‌دهد که از «طراحی Material3» پیروی می‌کنند، شما همچنان کنترل کامل روی زمینه‌سازی دارید. می‌توانید رنگ‌ها، حروف‌چینی، و شکل‌ها را با پیچیدن واسط کاربر پخش‌کننده در MaterialTheme سفارشی‌سازی کنید.

برای مثال، برای تغییر رنگ PlayPauseButton، می‌توانید colorScheme سفارشی ارائه دهید:

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

عناصر Material3 دردسترس

کتابخانه media3-ui-compose-material3 مجموعه‌ای از عناصر ترکیبی پیش‌ساخته برای کنترل‌های رایج پخش‌کننده ارائه می‌دهد. در اینجا برخی‌از عناصری که می‌توانید مستقیماً در برنامه‌تان استفاده کنید آورده شده است:

این فهرست کامل نیست. برای همه عناصر دردسترس، به مرجع API کتابخانه مراجعه کنید.

دو عنصر ترکیبی پیش‌ساخته دیگر که احتمالاً به آن‌ها نیاز خواهید داشت مربوط به مدیریت سطح هستند و در واحد media3-ui-compose قرار دارند زیرا از زمینه‌سازی Material برخوردار نیستند.