Tratar erros

O Android Auto e o Android Automotive (AAOS) definem o estado de reprodução como STATE_ERROR e fornecem uma mensagem de erro localizada para o usuário. Os apps podem mostrar a mensagem ao usuário.

Para resolver um erro, forneça uma mensagem de erro com setErrorMessage.

Consulte PlaybackStateCompat para conferir uma lista dos códigos de erro que podem ser usados ao criar a mensagem de erro para indicar a natureza do problema. Se um usuário precisar interagir com o smartphone para resolver um problema, inclua essa instrução na mensagem de erro.

As mensagens de erro precisam ser voltadas para o usuário e direcionadas à localidade dele. Por exemplo, se o conteúdo não estiver disponível na localidade do usuário, use 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())

Para saber mais sobre estados de erro, consulte Como usar uma sessão de mídia: estados e erros.