Menangani error

Android Auto dan Android Automotive (AAOS) menetapkan status pemutaran ke STATE_ERROR dan memberikan pesan error yang dilokalkan dan ditampilkan kepada pengguna. Aplikasi kemudian dapat menampilkan pesan kepada pengguna.

Untuk mengatasi error, Anda memberikan pesan error dengan setErrorMessage.

Lihat PlaybackStateCompat untuk mengetahui daftar kode error yang dapat Anda gunakan saat mendesain pesan error untuk menunjukkan sifat error. Jika pengguna harus berinteraksi dengan ponselnya untuk menyelesaikan masalah, sertakan petunjuk ini dalam pesan error.

Pesan error harus terlihat oleh pengguna dan ditargetkan ke lokalitas pengguna. Misalnya, jika konten tidak tersedia di lokalitas pengguna, gunakan 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())

Untuk mempelajari lebih lanjut status error, lihat Menggunakan sesi media: Status dan error.