Gestire gli errori

Android Auto e Android Automotive (AAOS) impostano lo stato di riproduzione su STATE_ERROR e forniscono un messaggio di errore localizzato visibile all'utente. Le app possono quindi mostrare il messaggio all'utente.

Per risolvere un errore, fornisci un messaggio di errore con setErrorMessage.

Consulta la sezione PlaybackStateCompat per un elenco dei codici di errore che puoi utilizzare quando progetti il messaggio di errore per indicare la natura dell'errore. Se un utente deve interagire con il proprio smartphone per risolvere un problema, includi questa istruzione nel messaggio di errore.

I messaggi di errore devono essere rivolti all'utente e mirati alle impostazioni internazionali dell'utente. Ad esempio, se i contenuti non sono disponibili nelle impostazioni internazionali dell'utente, utilizza 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())

Per saperne di più sugli stati di errore, consulta la sezione Utilizzo di una sessione multimediale: stati ed errori.