エラーを処理する

Android Auto と Android Automotive OS（AAOS）は、再生状態を STATE_ERROR に設定し、ユーザー向けのローカライズされたエラー メッセージを表示します。アプリは、このメッセージをユーザーに表示できます。

エラーに対処するには、setErrorMessage を使用してエラー メッセージを表示します。

エラー メッセージを設計してエラーの内容を示す際に使用できるエラーコードの一覧については、PlaybackStateCompatをご覧ください。問題を解決するためにユーザーがスマートフォンを操作する必要がある場合は、その手順をエラー メッセージに含めてください。

エラー メッセージはユーザー向けであり、ユーザーのロケールを対象とする必要があります。たとえば、ユーザーのロケールでコンテンツを利用できない場合は、 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())

エラー状態の詳細については、 メディア セッションの使用: 状態とエラーをご覧ください。