הוספת התלות
ספריית Media3 כוללת שני מודולים של ממשק משתמש שמבוססים על Jetpack Compose. לא צריך להוסיף את שניהם כי Material3 תלוי ב-core.
Kotlin
// Include only one of the following dependencies
implementation("androidx.media3:media3-ui-compose:1.11.1")
implementation("androidx.media3:media3-ui-compose-material3:1.11.1")
מגניב
// Include only one of the following dependencies
implementation "androidx.media3:media3-ui-compose:1.11.1"
implementation "androidx.media3:media3-ui-compose-material3:1.11.1"
אנחנו ממליצים מאוד לפתח את האפליקציה קודם כל ב-Compose או לעבור משימוש בתצוגות.
אפליקציית הדגמה שמבוססת רק על Compose
למרות שהספרייה media3-ui-compose לא כוללת רכיבים קומפוזביליים מוכנים לשימוש (כמו לחצנים, אינדיקטורים, תמונות או תיבות דו-שיח), אתם יכולים למצוא אפליקציה לדוגמה שכתובה כולה ב-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, CurrentMediaItemState, PlaylistState, ErrorState) שממירות את המצב של Player למצב של ממשק המשתמש.
הספרייה הזו לא מספקת רכיבי Material Design מוכנים לשימוש. אתם אחראים ליצור את רכיבי ממשק המשתמש שלכם ולעצב אותם. היא נותנת לכם שליטה מקסימלית על העיצוב והסגנון, ולכן היא אידיאלית אם יש לכם מערכת עיצוב בהתאמה אישית.
כדאי להשתמש ב-media3-ui-compose-material3 כדי לשלב מהר יותר עם Material Design.
הספרייה הזו מספקת את החלק האחרון של הצינור, UI. היא תלויה ב-media3-ui-compose וכוללת פונקציות קומפוזביליות מובנות שעוצבו באמצעות רכיבי Material3, כולל הפונקציות הקומפוזביליות Player ו-MiniController. הפונקציה הקומפוזבילית Player מציעה חוויית הפעלת מדיה מקיפה עם סרטון, פקדים וסרגל התקדמות, שאפשר להתאים אישית באמצעות PlayerDefaults. הרכיב הקומפוזבילי MiniController מספק ממשק קומפקטי לשליטה בנגן, ומציג מידע על קובץ המדיה הנוכחי. כך לא תצטרכו ליצור כפתורים ורכיבים אחרים בממשק המשתמש מאפס. אתם עדיין יכולים להתאים אישית את העיצוב, הצבעים והסמלים של הרכיבים האלה, אבל ההטמעה הבסיסית כבר מוכנה.
בקצרה
| תכונה | media3-ui-compose |
media3-ui-compose-material3 |
|---|---|---|
| רכיבים בממשק המשתמש | רכיבים בסיסיים כמו PlayerSurface ו-ContentFrame, אבל בלי לחצנים או אמצעי בקרה מעוצבים מראש. |
מספק את הפונקציות הניתנות לשילוב Player ו-MiniController וקבוצה מלאה של פונקציות ניתנות לשילוב בסגנון Material3, כמו PlayPauseButton, SeekBackButton, PositionAndDurationText, ErrorText וכו'. |
| ניהול מצב | מספק מחזיקי remember...State לניהול הלוגיקה. |
מנהל את המצב באופן פנימי, אבל עדיין אפשר לגשת למאחסני המצב אם צריך. |
| יחסי תלות | androidx.compose.foundation |
media3-ui-compose, androidx.compose.material3, com.google.android.material |
| תרחיש שימוש ראשי | יצירת ממשק משתמש של נגן עם מערכת עיצוב מותאמת אישית. שליטה מלאה בעיצוב ובסגנון. | בנייה מהירה של ממשק משתמש לנגן בהתאם להנחיות של Material Design 3. |
מדריכים קשורים
- התאמת תוכן מדיה לגורמי צורה שונים: איך מטפלים בתוספות מקצה לקצה, בגדלים דינמיים של חלונות ובהתאמה של תוכן בטלפונים, במכשירים מתקפלים ובטאבלטים.