معالجة الأخطاء

يضبط كلّ من 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())

لمزيد من المعلومات عن حالات الخطأ، يُرجى الاطّلاع على استخدام جلسة وسائط: الحالات والأخطاء.