ماده۳ آهنگسازی

کتابخانه media3-ui-compose-material3 هم مدیریت حالت و هم استایل‌بندی Material3 را به صورت داخلی مدیریت می‌کند. برای اطلاعات بیشتر در مورد اینکه از کدام کتابخانه استفاده کنید، به نمای کلی Media3 Compose مراجعه کنید.

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

مواد موجود3 قطعات

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

کامپوننت	توضیحات
PlayPauseButton	دکمه‌ای که بین پخش و مکث تغییر وضعیت می‌دهد.
SeekBackButton	دکمه‌ای برای جستجو به عقب با یک گام تعریف‌شده.
SeekForwardButton	دکمه‌ای برای جستجوی رو به جلو با یک افزایش تعریف‌شده.
NextButton	دکمه‌ای برای جستجوی آیتم رسانه‌ای بعدی.
PreviousButton	دکمه‌ای برای جستجوی مورد رسانه قبلی.
RepeatButton	دکمه‌ای برای تغییر حالت‌های تکرار.
ShuffleButton	دکمه‌ای برای تغییر حالت پخش تصادفی.
MuteButton	دکمه‌ای برای بی‌صدا کردن و وصل کردن صدای پخش‌کننده.
PositionAndDurationText	یک متن قابل ترکیب که موقعیت فعلی و مدت زمان کل را نمایش می‌دهد.
PositionText	یک متن قابل ترکیب که موقعیت فعلی را نمایش می‌دهد.
DurationText	یک متن قابل ترکیب که مدت زمان کل را نمایش می‌دهد.
RemainingDurationText	متنی قابل ترکیب که مدت زمان باقی مانده را نمایش می‌دهد.

این لیست کامل نیست. برای مشاهده‌ی تمام اجزای موجود، به مرجع API کتابخانه مراجعه کنید.

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

کامپوننت	توضیحات
ContentFrame	سطحی برای نمایش محتوای رسانه‌ای که مدیریت نسبت ابعاد، تغییر اندازه و شاتر را مدیریت می‌کند
PlayerSurface	سطح خام که SurfaceView و TextureView را در AndroidView پوشش می‌دهد