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

מערכות ההפעלה Android Auto ו-Android Automotive OS‏ (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())

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