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

يضبط 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())

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