إضافة الاعتمادية
تتضمّن مكتبة Media3 وحدتَي واجهة مستخدم تستندان إلى Jetpack Compose. ليس عليك إضافة كليهما لأنّ حزمة Material3 تعتمد على الحزمة الأساسية.
Kotlin
// Include only one of the following dependencies
implementation("androidx.media3:media3-ui-compose:1.10.0")
implementation("androidx.media3:media3-ui-compose-material3:1.10.0")
Groovy
// Include only one of the following dependencies
implementation "androidx.media3:media3-ui-compose:1.10.0"
implementation "androidx.media3:media3-ui-compose-material3:1.10.0"
ننصحك بشدة بتطوير تطبيقك باستخدام Compose أولاً أو نقل البيانات من Views.
تطبيق تجريبي متوافق بالكامل مع Compose
على الرغم من أنّ مكتبة media3-ui-compose لا تتضمّن عناصر Composables جاهزة للاستخدام (مثل الأزرار أو المؤشرات أو الصور أو مربّعات الحوار)، يمكنك العثور على تطبيق تجريبي مكتوب بالكامل بلغة Compose يتجنّب أي حلول للتوافق، مثل تضمين PlayerView في AndroidView. يستخدم التطبيق التجريبي فئات عنصر الاحتفاظ بالحالة لواجهة المستخدم من الوحدة media3-ui-compose، كما يستفيد من مكتبة Compose Material3.
ما هي المكتبة التي أحتاج إليها؟
استنادًا إلى مستوى التخصيص الذي تحتاجه، يمكنك الاختيار من بين مكتبتَين من مكتبات Media3 Compose. لفهم الفرق، من المفيد التفكير في مسار إعداد حالة واجهة المستخدم: Business logic → UI logic → UI.
استخدِم media3-ui-compose للتحكّم الكامل في مكوّنات واجهة المستخدم.
توفّر هذه المكتبة عملية الربط Business logic → UI logic. يحتوي على مكوّنات أساسية، مثل PlayerSurface وContentFrame، بالإضافة إلى فئات عنصر الاحتفاظ بالحالة (مثل PlayPauseButtonState) التي تحوّل حالة Player إلى حالة واجهة المستخدم.
لا توفّر هذه المكتبة مكوّنات التصميم المتعدد الأبعاد الجاهزة للاستخدام. أنت المسؤول عن إنشاء مكوّنات واجهة المستخدم وتصميمها. تمنحك هذه الطريقة الحد الأقصى من التحكّم في المظهر العام، ما يجعلها مثالية إذا كان لديك نظام تصميم مخصّص للغاية.
استخدام media3-ui-compose-material3 لدمج أسرع مع Material Design
توفّر هذه المكتبة الجزء UI الأخير من سلسلة المعالجة. يعتمد ذلك على
media3-ui-compose ويتضمّن دوال Composable مسبقة الإنشاء تم تصميمها
باستخدام مكوّنات Material3، بما في ذلك دالة Player Composable التي
توفّر تجربة شاملة لتشغيل الوسائط تتضمّن الفيديو وعناصر التحكّم
وشريط التقدم. ويغنيك ذلك عن إنشاء أزرارك وعناصر واجهة المستخدم الأخرى من البداية. سيظل بإمكانك تخصيص المظهر والألوان والأيقونات الخاصة بهذه المكوّنات، ولكن سيتم توفير التنفيذ الأساسي لك.
نظرة سريعة
| الميزة | media3-ui-compose |
media3-ui-compose-material3 |
|---|---|---|
| مكوّنات واجهة المستخدم | العناصر الأساسية، مثل PlayerSurface وContentFrame، ولكن بدون أزرار أو عناصر تحكّم مُعدّة مسبقًا |
توفّر مكتبة Player Composable ومجموعة كاملة من عناصر Composable الجاهزة والمصمَّمة وفقًا لأسلوب Material3، مثل PlayPauseButton وSeekBackButton وPositionAndDurationText وما إلى ذلك. |
| إدارة الحالة | توفّر remember...State لحامليها لإدارة المنطق. |
تدير الحالة داخليًا، ولكن سيظل بإمكانك الوصول إلى عناصر الحالة إذا احتجت إلى ذلك. |
| الاعتمادية | androidx.compose.foundation |
"media3-ui-compose" و"androidx.compose.material3" و"com.google.android.material" |
| حالة الاستخدام الأساسية | إنشاء واجهة مستخدم للمشغّل باستخدام نظام تصميم مخصّص التحكّم الكامل في المظهر العام | إنشاء واجهة مستخدم مشغّل بسرعة تتوافق مع إرشادات التصميم المتعدد الأبعاد 3 |