רכיבי המערכת ותהליכי המשתמש

בתרשים הבא תוכלו לראות את הרכיבים שמקיימים אינטראקציה עם מדיה:

איור 1. חלקי המערכת

הרכיבים שמופיעים באיור הזה מתוארים בטבלה:

תהליכי עבודה של משתמשים

השקה של אפליקציית מדיה

התהליך להפעלת מדיה מופיע למטה.

איור 2. השקה של אפליקציית מדיה

כדי להפעיל מדיה, צריך להשתמש בפקודה משתמעת הבאה CAR_INTENT_ACTION_MEDIA_TEMPLATE. Intent יכול לכלול את הפרטים הבאים כתוספות:

• android.car.intent.extra.MEDIA_COMPONENT (אופציונלי). תוספת למחרוזת כדי לייצג את שם הרכיב הקבוע MediaBrowserService באפליקציית המדיה שאליה המדיה צריכה להתחבר. אם לא צוין מדיה, תוצג מדיה אפליקציית המדיה שנבחרה. אנחנו משתמשים ב-Intent הזה נקודות כניסה:

  • ממשק המשתמש של המערכת. משמש לחזרה לממשק המדיה או להתחלת השימוש ומשתמשים בו בפעם הראשונה. במקרה הזה, ייעשה שימוש ב-Intent שלמעלה ללא תוספות כדי לגרום ל'מדיה' להציג את אפליקציית המדיה שנבחרה.

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

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

שילוב מדיה ממרכז האפליקציות ממרכז האפליקציות

אפליקציות מדיה לא מורשות לספק פעילות שמסומנת בהערה קטגוריה אחת (android.intent.category.LAUNCHER). כתוצאה מכך, מרכז האפליקציות (או מקבילה) חייב ליישם לוגיקה מיוחדת כדי לטפל בשילוב של מקור מדיה:

• מרכז האפליקציות חייב לסרוק את המערכת כדי לאתר חבילות MediaBrowserService.SERVICE_INTERFACE עבור חבילות אלה, מרכז האפליקציות מאחזר את סמל השירות הדומה לזה שמשמש לאחזור תגים אחרים פעילויות.

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

  נכון לכתיבה הזו, אף אפליקציה של מקור מדיה לא יכולה לספק פעילות במרכז האפליקציות.

• דוגמה ללוגיקה הזו מופיעה בקוד ה-AOSP AppLauncherUtils#getAllLauncherApps()

אפשרויות להגדרה ולתהליך כניסה

אפליקציות מדיה יכולות לכלול פעילות בהגדרות שמותאמות לרכב. פעילות כזו יכולה להיות משמש להטמעת תהליכי עבודה של משתמשים שלא מטופלים על ידי ממשקי ה-API של Android Media, לדוגמה:

• כניסה
• יציאה
• מעבר בין חשבונות
• תצוגה שהמשתמש מחובר אליה כרגע (אם יש כזה)
• הגדרת שירות

איור 3. תהליך הכניסה לחשבון

אפליקציית המדיה בהצהרה על פעילות ההגדרות הזו עם מסנן Intent הבא:

<activity android:name=".AppSettingsActivity"
          android:exported="true
          android:theme="@style/SettingsActivity"
           android:label="@string/app_settings_activity_title">
   <intent-filter>
       <action android:name="android.intent.action.APPLICATION_PREFERENCES"/>
   </intent-filter>
</activity>

חובה להשתמש בתקשורת עם הלוגיקה הבאה:

• צריך לבדוק שאפליקציית המדיה הנוכחית כוללת פעילות עם מסנן Intent.

• אם כן, צריך לאפשר למשתמש לנווט לפעילות.

• אם חלות הגבלות על חוויית המשתמש (UX) ברכב (לדוגמה, אם הרכב זז), הרווח הזה צריך מושבתת כי פעילות ההגדרות היא לא ממשק משתמש שמותאם לנהגים.

טיפול בשגיאות וכניסה לחשבון

מדיה מקיימת אינטראקציה עם אפליקציות מדיה באמצעות Android Media Session API. כחלק מהשינוי הזה API, המדיה מקבלת PlaybackState אובייקט, שמעביר את המצב הנוכחי של אפליקציית המדיה.

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

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

איור 4. טיפול בשגיאות

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

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

• הודעת שגיאה אחת (PlaybackState) (הוגדרה על ידי אפליקציות מדיה שמשתמשות ברכיב PlaybackStateCompat.Builder#setErrorMessage ) מכיל הסבר קריא לאנשים (לדוגמה, "לא נכנסת לחשבון"). צריך להציג את ההודעה הזאת המשתמש צריך להפעיל אופטימיזציה של הסחות דעת (DO).

• אופציונלי: PlaybackState יכול לכלול את התוספות הבאות (מוגדרות על ידי מדיה) אפליקציות עם PlaybackStateCompat.Builder#setExtras ) עם המקשים הבאים.

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

  • android.media.extras.ERROR_RESOLUTION_ACTION_INTENT הגדרה עם PendingIntent להיות מופעלת כשהמשתמש לוחץ על הלחצן שצוין למעלה. הזה PendingIntent מפנה לפעילות כניסה מותאמת אישית שהוטמעה על ידי אותה אפליקציית מדיה.

• מצב PlaybackState שווה ל- STATE_ERROR. המשמעות היא שלא ניתן לבצע כל פעולה אחרת עד להשלמת תהליך הכניסה.