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