处理错误

Android Auto 和 Android Automotive (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())

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