处理错误

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())

如需详细了解错误状态，请参阅 使用媒体会话：状态和错误。