Gérer les erreurs

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

Pour résoudre une erreur, vous 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 pour 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 visibles par l'utilisateur et ciblés en fonction de 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.