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

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

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

سفارشی‌سازی کامپوننت‌های 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)
}

مواد موجود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 پوشش می‌دهد