התאם אישית את המדיה

המדיה שייכת לחבילה של אפליקציות מערכת (לדוגמה, חייגן ו-App Launcher). אפליקציות אלו חולקות סגנונות ונכסים משותפים המוגדרים ברמות שונות במבנה AOSP.

• framework/base . כל סגנונות הבסיס של אנדרואיד מוגדרים כאן.
• packages/services/Car/car_product/overlay . מכיל שכבות-על בזמן בנייה שמשנות משאבי מסגרת/בסיס סטנדרטיים כדי לייצר את המראה והתחושה של AOSP של מערכת ההפעלה Android Automotive. יצרני ציוד מקורי עשויים לבחור לא לכלול שכבת-על זו ולהשתמש בשכבה שלהם.
• packages/apps/Car/libs/car-ui-lib . ספרייה זו מגדירה רכיבים ומשאבים של AAOS המשותפים ליישומי מערכת ואפליקציות מפורקות המיועדות להתאמה אישית. לפרטים, עיין במדריך לשילוב ספריית ממשק המשתמש לרכב .
• packages/apps/Car/libs/car_app_common . צבעים וסגנונות נפוצים משותפים בין אפליקציות מערכת הרכב. יצרני ציוד מקורי יכולים להשתמש בשכבות-על כדי להתאים אישית את האלמנטים הללו (בדומה ל- car_product/overlay המתואר לעיל).
• packages/apps/Car/libs/car_media_common . מכיל אלמנטים משותפים בין מדיה וממשקי מדיה אחרים. לדוגמה, ווידג'ט המדיה של מסך הבית.

• packages/apps/Car/Media. כל אפליקציות המערכת משתמשות בערכת הנושא שלהן, המשתרעת מ- Theme.CarUi , כפי שהוגדר ב- car-ui-lib .

Android Automotive AOSP מספקת שתי מצגות של מדיה.

• ממשק משתמש מדיה. מאפשר למשתמשים להיכנס, לגלוש בתוכן ולהשתמש בפקדי השמעה מפורטים.
• ווידג'ט מדיה למסך הבית. מאפשר שימוש בתכונות הליבה של הפעלת מדיה למסך הבית.

ממשק משתמש מדיה

איור זה מתאר את המבנה של ממשק המשתמש של המדיה:

איור 1. ממשק משתמש מדיה.

לפרטים על הנחיות UX וממשק משתמש, כמו גם על המבנה המרחבי של הרכיבים השונים של מדיה, ראה מודל מרחבי .

AppBarView: סרגל כלים

סרגל הכלים של ממשק המשתמש של מדיה הוא רכיב המשותף עם אפליקציות מערכת אחרות, כגון חייגן ורדיו. כדי ללמוד כיצד להתאים אישית את סרגל הכלים, עיין במדריך לשילוב ספריית ממשק המשתמש לרכב .

גודל גרפיקה מקסימלי של מדיה

כדי להודיע ​​לאפליקציות מדיה על הגודל המקסימלי של הגרפיקה להבאה, אתה יכול לשכב על media_items_bitmap_max_size_px במערכת שלך. כדי לעשות זאת, שלח EXTRA_MEDIA_ART_SIZE_HINT_PIXELS כרמז שורש. כתוצאה מכך, תחסוך רוחב פס בעת הורדת תמונות. למידע נוסף, ראה MediaConstants ב-Developer.android.com.

עיין בקטע

הגלישה מורכבת בעיקר מממשק המשתמש של Car UI RecyclerView , המטפל במיקום פס הגלילה, החצים והשוליים ויכול לעיין בפריטים מסוגים שונים, כגון כותרות, פריטי רשת, פריטי רשת סמלים, פריטי רשימה ופריטי רשימת אייקונים.

בקרות השמעה ממוזערות

כאשר קטע הדפדוף מוצג, וכאשר פריט מדיה נבחר, מוצגת תצוגת בקרות הפעלה ממוזערות . האיור הבא ממחיש את המבנה של תצוגה זו:

איור 2. בקרות השמעה ממוזערות.

רשימת עיון

מפתחים יכולים להשתמש בסט של רמז לסגנון (ראה החל סגנונות תוכן ) כדי להתאים אישית את הצגת תוכן הגלישה במדיה. יצרני OEM חייבים לדבוק בסגנונות אלה, ולהתאים את המצגת למערכת העיצוב שלהם.

סוגי הפריטים הנתמכים והפריסות המתאימות ממוקמים כדלקמן:

• LIST_ITEM ( media_browse_list_item.xml ). משמש בדרך כלל לפרקים בפודקאסט, כגון פריטי פלייליסט ומועדפים.
• ICON_LIST_ITEM ( media_browse_list_icons_item.xml ). משמש לקטגוריות או לאפשרויות תפריט, שבהן התמונה הכלולה בפריט המדיה אינה תמונת אלבום ממשית אלא סמל.
• GRID_ITEM ( media_browse_grid_item.xml ). משמש בדרך כלל לפריטים שניתנים להפעלה, כמו שירים או רשימות השמעה.
• ICON_GRID_ITEM ( media_browse_grid_icons_item.xml ). משמש לקטגוריות, בדומה ל- ICON_LIST_ITEM .
• HEADER ( media_browse_header_item.xml ). משמש לארגון פריטי מדיה למקטעים.

מסך השמעה

כדי להציג מסך זה, הרחב את בקרות ההשמעה הממוזערות:

• כרגע מנגן מדטה של ​​פריט מדיה (כולל כותרת וכתובית).
• השלם בקרות השמעה.
• תור השמעה (משמש להצגת הפריטים שהושמעו לאחרונה או הפריטים הבאים להפעלה).

רכיבי מסך ההפעלה מזוהים באיורים שלהלן.

איור 3. מסך השמעה.

מסך ההפעלה אינו חולק את סרגל הכלים עם שאר האפליקציה. במקום זאת, מסך זה מנהל בנפרד את האלמנטים בחלק העליון של המסך.

ייחוס פורמט אודיו

כאשר יישומים מגדירים את KEY_CONTENT_FORMAT_TINTABLE_LARGE_ICON_URI או את KEY_CONTENT_FORMAT_TINTABLE_SMALL_ICON_URI בתוספות של פריט המדיה המתנגן כעת. יצרני OEM חייבים להפוך את הווקטור המתאים לציור כפי שמצוין ב-URI.

יש להשתמש בגרסה הגדולה של סמל פורמט התוכן בתצוגת ההשמעה הראשית. בתצוגות משניות, כגון סרגל השמעה קטן יותר, יצרני OEM יכולים להשתמש בגרסה הקטנה יותר של סמל פורמט התוכן . ContentFormatView מציג את הסמל האופטימלי על סמך תכונת logoSize שלו.

קישורי השמעה

כאשר יישומים מגדירים KEY_SUBTITLE_LINK_MEDIA_ID או KEY_DESCRIPTION_LINK_MEDIA_ID , יצרני OEM חייבים להציג את הכתובית או התיאור באופן שמציע שניתן להקיש עליהם, ולאחר מכן לפתוח את תצוגת הגלישה כדי להציג את פריט המדיה המקושר בהקשה של משתמש.

בקרות השמעה

מסך ההשמעה כולל קבוצה מורחבת של פקדי השמעה, המאורגנים בשורות בקרה . השורה המשנית (מוצגת למטה כשורה בחלק העליון) מוצגת רק אם הרווח בשורה הראשונה אינו מספיק כדי להציג את כל הפעולות המוחזרות על ידי אפליקציית המדיה מ- PlaybackStateCompat#getActions() .

איור 4. בקרות השמעה.

יצרני ציוד מקורי יכולים להתאים אישית את האייקונים של פעולות סטנדרטיות, אך עליהם להציג סמלי פעולה מותאמים אישית כפי שהם מסופקים על ידי אפליקציות המדיה.

ווידג'ט מדיה למסך הבית

יישומון זה מיושם כמקטע ב- car-media-common . קטע זה כולל גרסה ממוזערת של מסך ההפעלה המתואר לעיל. כל אותם כללי התאמה אישית ויכולות חלים.

איור 5. ווידג'ט מדיה של מסך הבית.

כפתור בורר האפליקציות המוצג לעיל משתמש בפונקציונליות המתג המתוארת בזרימת משתמש החלפת מקור מדיה .

כדי להשתמש בסמל מקור המדיה הנוכחי עבור לחצן בורר האפליקציות, שים על דגל use_media_source_logo_for_app_selector המוגדר ב- platform/packages/apps/Car/libs/car-media-common/res/values/bools.xml והגדר אותו ל- true . עם שינוי זה, סמל מקור המדיה בצד הנגדי של סרגל הכלים של האפליקציה יוסתר. ההתאמה האישית חלה גם על אפליקציית Media Center ואפליקציית ה-Reference Radio.

איור 6. לחצן בחירת אפליקציית מדיה.

פריסת לחצני הפעלה, השהה ועצירה

ניתן להתאים את פריסת לחצן ההפעלה/השהה/עצירה עבור "עכשיו משחק" ותצוגת בקרות ההשמעה הממוזערות. שתי הפריסות מוגדרות packages/apps/Car/libs/car-media-common/res/layout/ .

כדי להתאים אישית את פריסות הלחצנים, החל שכבות-על בזמן בנייה על play_pause_stop_button_layout.xml ו- minimized_play_pause_stop_button_layout.xml .

סמן את הפריט הנוכחי בתור ההפעלה

המצב של פריט תור ההפעלה הנוכחי מוגדר selected , כך שניתן להתאים אותו באמצעות משאבי מצב כגון רשימות מצבי צבע (ראה משאב רשימת מצבי צבע ) ואפשרויות משיכה של רשימת מצבים (ראה משאבים ניתנים לציור ). כדי להחיל את שינויי הסגנון הדרושים, תוכל לעקוף את חבילות פריסת פריט התור/אפליקציות/Car/Media/res/layout/queue_list_item.xml , או נפרדות

אתה יכול גם להציג סמל ליד פריט תור ההשמעה הנוכחי:

• שכבת-על של show_icon_for_now_playing_queue_list_item דגל בוליאני המוגדר ב- packs/apps/Car/Media/res/layout/queue_list_item.xml , או בנפרד

  כדי להסתיר את טיימר ההפעלה, הגדר את show_time_for_now_playing_queue_list_item ל- false .

• השתמש במצב שניתן לצייר, למשל, חזית או רקע של תצוגת שורש הפריט (ראה packages/apps/Car/Media/res/layout/queue_list_item.xml , או תצוגה נפרדת בהיררכיית התצוגה של הפריט.

איור 7. פריט נוכחי מודגש בתור משחק.