הוספת תמיכה ב-Android Auto לאפליקציה שמוגדרת במצב 'חניה'

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

הצהרה על תמיכה ב-Android Auto

כדי להצהיר שהאפליקציה תומכת ב-Android Auto, צריך לכלול את הרכיב הבא של <category> במסנן Intent של פעילות במניפסט של האפליקציה:

<activity ...>
    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        ...
        <category android:name="android.intent.category.CAR_LAUNCHER" />
    </intent-filter>
</activity>

באופן כללי, אפשר למקם את רכיב הקטגוריה android.intent.category.CAR_LAUNCHER באותו מסנן Intent כמו הרכיב android.intent.category.LAUNCHER, אבל אפשר גם למקם אותו במסנן אחר אם רוצים.

רשומות מניפסט ספציפיות לקטגוריה

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

תמיכה בגדלי מסך נפוצים של Android Auto

כדי לספק את חוויית המשתמש הטובה ביותר, מומלץ להפוך את האפליקציה לרספונסיבית לחלוטין לגדלים שונים של מסכים. כדי להבטיח חוויית שימוש איכותית במגוון המכוניות שתומכות ב-Android Auto, האפליקציות לא יכולות להציג פסים שחורים משמעותיים בצדדים במסכים לרוחב, כפי שמתואר בהנחיית האיכות DO-2 לאפליקציות לרכב.

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

בדיקה של גודלי מסך קנוניים

כשאתם מפתחים ובודקים את האפליקציה ל-Android Auto, אתם יכולים להשתמש בהגדרות הבאות של יחידת הראש למחשב (DHU) כדי לוודא שהאפליקציה עומדת בדרישות שלמעלה:

תמונה קטנה לרוחב

[general]
resolution = 800x480
dpi = 160
...

נוף רחב

[general]
resolution = 1920x1080
dpi = 160
marginheight = 596
normalizedpi = true
cropmargins = true
...

לאורך

[general]
resolution = 1920x1080
dpi = 160
marginwidth = 878
normalizedpi = true
cropmargins = true
...

זיהוי שימוש ב-Android Auto

אם אתם רוצים לזהות מתי משתמשים באפליקציה שלכם דרך Android Auto (למשל, למטרות ניתוח), אתם יכולים לבדוק שני אותות:

  • מצב החיבור שמדווח על ידי ה-API של CarConnection. כשהמכשיר מחובר ל-Android Auto, הסמל הזה יהיה CONNECTION_TYPE_PROJECTION.
  • מזהה התצוגה של התצוגה הפעילה. כשהאפליקציה פועלת במסך שהוא לא המסך המובנה, למשל כשמשתמשים בה דרך Android Auto, הערך הוא לא DEFAULT_DISPLAY.

בקטע הקוד הבא אפשר לראות איך לשלב את האותות האלה כדי לזהות שימוש דרך Android Auto:

val displayId = context.display?.displayId ?: DEFAULT_DISPLAY
isRunningOnAndroidAuto = (connectionType == CONNECTION_TYPE_PROJECTION) && (displayId != DEFAULT_DISPLAY)