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 مجموعة من الدوال المركّبة المُعدّة مسبقًا لعناصر التحكّم الشائعة في المشغّل. في ما يلي بعض المكوّنات التي يمكنك استخدامها مباشرةً في تطبيقك:

هذه القائمة ليست شاملة. يمكنك الرجوع إلى مرجع واجهة برمجة التطبيقات الخاص بالمكتبة للاطّلاع على جميع المكوّنات المتاحة.

هناك دالتان مركّبتان أخريان مُعدَّتان مسبقًا من المحتمل أن تحتاج إليهما، وهما مرتبطتان بإدارة الأسطح، وتوجدان في وحدة media3-ui-compose لأنّهما لا تتضمّنان ميزة "تخصيص التصميم المتعدد الأبعاد".