Obsługa błędów

Android Auto i Android Automotive (AAOS) ustawiają stan odtwarzania na STATE_ERROR i wyświetlają użytkownikowi zlokalizowany komunikat o błędzie. Aplikacje mogą wtedy wyświetlić użytkownikowi komunikat.

Aby rozwiązać problem, wyświetl komunikat o błędzie z symbolem setErrorMessage.

Listę kodów błędów, których możesz użyć podczas projektowania komunikatu o błędzie, aby wskazać charakter błędu, znajdziesz w artykule PlaybackStateCompat. Jeśli użytkownik musi wykonać jakąś czynność na telefonie, aby rozwiązać problem, umieść tę instrukcję w komunikacie o błędzie.

Komunikaty o błędach muszą być widoczne dla użytkownika i dostosowane do jego ustawień regionalnych. Jeśli na przykład treść nie jest dostępna w języku użytkownika, użyj 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())

Więcej informacji o stanach błędów znajdziesz w artykule Korzystanie z sesji multimedialnej: stany i błędy.