Gérer les erreurs

Android Auto et Android Automotive OS (AAOS) définissent l'état de lecture sur STATE_ERROR et fournissent un message d'erreur localisé destiné à l'utilisateur. Les applications peuvent ensuite afficher le message pour l'utilisateur.

Pour résoudre une erreur, fournissez un message d'erreur avec setErrorMessage.

Consultez PlaybackStateCompat pour obtenir la liste des codes d'erreur que vous pouvez utiliser lorsque vous concevez le message d'erreur afin d'indiquer la nature de l'erreur. Si un utilisateur doit interagir avec son téléphone pour résoudre un problème, incluez cette instruction dans le message d'erreur.

Les messages d'erreur doivent être destinés à l'utilisateur et ciblés sur ses paramètres régionaux. Par exemple, si le contenu n'est pas disponible dans les paramètres régionaux de l'utilisateur, utilisez 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())

Pour en savoir plus sur les états d'erreur, consultez Utiliser une session multimédia : états et erreurs.