Fehler verarbeiten

In Android Auto und Android Automotive OS (AAOS) wird der Wiedergabestatus auf STATE_ERROR gesetzt und eine lokalisierte Fehlermeldung für den Nutzer angezeigt. Die Apps können die Nachricht dann dem Nutzer anzeigen.

Um einen Fehler zu beheben, geben Sie mit setErrorMessage eine Fehlermeldung aus.

Eine Liste der Fehlercodes, die Sie beim Entwerfen der Fehlermeldung verwenden können, um die Art des Fehlers anzugeben, finden Sie unter PlaybackStateCompat. Wenn ein Nutzer mit seinem Smartphone interagieren muss, um ein Problem zu beheben, fügen Sie diese Anleitung in die Fehlermeldung ein.

Fehlermeldungen müssen für Nutzer bestimmt sein und auf die Sprache des Nutzers ausgerichtet sein. Wenn Inhalte beispielsweise nicht in der Sprache des Nutzers verfügbar sind, verwenden Sie 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())

Weitere Informationen zu Fehlerstatus finden Sie unter Mediensitzung verwenden: Status und Fehler.