Material3 Compose

تتعامل مكتبة 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)
}

مكوّنات Material3 المتاحة

توفّر مكتبة media3-ui-compose-material3 مجموعة من العناصر القابلة للإنشاء مسبقًا لأدوات التحكّم الشائعة في المشغّل. في ما يلي بعض المكوّنات التي يمكنك استخدامها مباشرةً في تطبيقك:

المكوّن الوصف
PlayPauseButton زر للتبديل بين التشغيل والإيقاف المؤقت
SeekBackButton زر للترجيع بمقدار محدّد
SeekForwardButton زر للتقديم بمقدار محدّد
NextButton زر للانتقال إلى عنصر الوسائط التالي
PreviousButton زر للترجيع إلى عنصر الوسائط السابق
RepeatButton زر للتنقل بين أوضاع التكرار
ShuffleButton زر لتفعيل وضع الترتيب العشوائي أو إيقافه
MuteButton زر لكتم صوت المشغّل وإعادته
PositionAndDurationText عنصر قابل للإنشاء يعرض الموضع الحالي والمدة الإجمالية.
PositionText عنصر قابل للإنشاء يعرض الموضع الحالي.
DurationText عنصر قابل للإنشاء يعرض المدة الإجمالية.
RemainingDurationText عنصر قابل للإنشاء يعرض المدة المتبقية.

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

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

المكوّن الوصف
ContentFrame سطح لعرض محتوى الوسائط يتعامل مع إدارة نسبة العرض إلى الارتفاع وتغيير الحجم والغالق
PlayerSurface السطح الأوّلي الذي يغلّف SurfaceView وTextureView في AndroidView