טיפול בשגיאות

‫Android Auto ו-Android Automotive‏ (AAOS) מגדירים את מצב ההפעלה ל-STATE_ERROR ומציגים למשתמש הודעת שגיאה מותאמת לשפה שלו. לאחר מכן, האפליקציות יכולות להציג את ההודעה למשתמש.

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

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

הודעות השגיאה צריכות להיות מוצגות למשתמשים, וצריכות להיות מותאמות ללוקאל של המשתמש. לדוגמה, אם התוכן לא זמין באזור של המשתמש, צריך להשתמש ב-ERROR_CODE_NOT_AVAILABLE_IN_REGION.

Kotlin

mediaSession.setPlaybackState(
    PlaybackStateCompat.Builder()
        .setState(PlaybackStateCompat.STATE_ERROR)
        .setErrorMessage(PlaybackStateCompat.ERROR_CODE_NOT_AVAILABLE_IN_REGION, getString(R.string.error_unsupported_region))
        // ...and any other setters.
        .build())

Java

mediaSession.setPlaybackState(
    new PlaybackStateCompat.Builder()
        .setState(PlaybackStateCompat.STATE_ERROR)
        .setErrorMessage(PlaybackStateCompat.ERROR_CODE_NOT_AVAILABLE_IN_REGION, getString(R.string.error_unsupported_region))
        // ...and any other setters.
        .build())

במאמר שימוש בסשן מדיה: מצבים ושגיאות תוכלו לקרוא מידע נוסף על מצבי שגיאה.