مكونات النظام وتدفقات المستخدم

يوضح الرسم التخطيطي التالي المكونات التي تتفاعل مع الوسائط:

الشكل 1. مكونات النظام

يتم توضيح العناصر في هذا الشكل في الجدول:

تدفقات المستخدم

إطلاق تطبيق الوسائط

تظهر عملية تشغيل الوسائط أدناه.

الشكل 2. إطلاق تطبيق الوسائط

يجب تشغيل الوسائط باستخدام النظام الضمني التالي CAR_INTENT_ACTION_MEDIA_TEMPLATE يمكن أن يتضمّن هذا الغرض المعلومات التالية على أنّها إضافية:

• android.car.intent.extra.MEDIA_COMPONENT (اختياري). إضافة سلسلة لتمثيل اسم المكون المسطَّح MediaBrowserService في تطبيق الوسائط الذي تتصل به الوسائط. سيتم عرض الوسائط في حال عدم توفيرها تطبيق الموسيقى المحدد حاليًا. يتم استخدام هذا الغرض من العناصر التالية نقاط الدخول:

  • واجهة مستخدم النظام: يُستخدَم هذا الإذن للرجوع إلى تجربة الوسائط أو البدء. للمرة الأولى. في هذه الحالة، سيتم استخدام Intent أعلاه بدون لكي تتمكن الوسائط من عرض تطبيق الوسائط المحدد حاليًا.

  • الشاشة الرئيسية و"مساعد Google" و"مركز الإشعارات": يمكن للمستخدمين انتقِل إلى "الوسائط" لعرض تطبيق الوسائط المحدَّد حاليًا. في جميع الحالات، يتم تشغيل الهدف الضمني بدون إضافات.

  • مشغّل التطبيقات: عندما يختار المستخدمون تطبيق وسائط من مشغّل التطبيقات، يشمل الغرض أعلاه CAR_EXTRA_MEDIA_COMPONENT إضافي يتضمّن تطبيق الوسائط المحدَّد. يصنف الوسائط هذا الحدث على أنه التطبيق المحدد ويتصل به. لمعرفة التفاصيل، يُرجى الاطّلاع على القسم أدناه "التطبيق" دمج مشغّل التطبيقات مع دمج الوسائط

دمج مشغّل التطبيقات مع الوسائط

لا يُسمح لتطبيقات الوسائط بتوفير أي نشاط يحتوي على تعليقات توضيحية مع الفئة android.intent.category.LAUNCHER. وبالتالي، فإن مشغّل التطبيقات (أو مماثلة) أن تنفذ منطقًا خاصًا لمعالجة دمج مصدر الوسائط:

• يجب أن يفحص مشغّل التطبيقات النظام بحثًا عن الحِزم التي يتم تنفيذها. MediaBrowserService.SERVICE_INTERFACE بالنسبة إلى هذه الحِزم، يجلب "مشغّل التطبيقات" رمز الخدمة المشابه لذلك المستخدَم لجلب والأنشطة السابقة.

• يجمع مشغّل التطبيقات بعد ذلك هذه الحِزم مع الحِزم التي تنفّذها. android.intent.category.LAUNCHER نشاطًا إذا قدم أحد التطبيقات تنفيذ MediaBrowserService ونشاط مشغّل التطبيقات، تأخذ الخدمة الأسبقية.

  اعتبارًا من هذه الكتابة، لا يمكن لأي تطبيق مصدر وسائط توفير نشاط مشغّل التطبيقات.

• يمكن العثور على مثال على هذا المنطق في رمز AOSP على AppLauncherUtils#getAllLauncherApps()

خيارات الضبط وخطوات تسجيل الدخول

يمكن أن تتضمّن تطبيقات الوسائط نشاطًا في الإعدادات المحسَّن للمركبة. يمكن أن يكون مثل هذا النشاط المستخدمة لتنفيذ مسارات المستخدمين التي لم يتم التعامل معها من خلال واجهات برمجة تطبيقات Android Media، على سبيل المثال:

• تسجيل الدخول
• تسجيل الخروج
• تبديل الحسابات
• عرض المستخدم الذي سجّل دخوله حاليًا (إن وُجد)
• إعدادات الخدمة

الشكل 3. مسار تسجيل الدخول

تم الإعلان عن نشاط "الإعدادات" هذا من خلال تطبيق الوسائط باستخدام فلتر الأهداف التالي:

<activity android:name=".AppSettingsActivity"
          android:exported="true
          android:theme="@style/SettingsActivity"
           android:label="@string/app_settings_activity_title">
   <intent-filter>
       <action android:name="android.intent.action.APPLICATION_PREFERENCES"/>
   </intent-filter>
</activity>

يجب أن تنفذ الوسائط المنطق التالي:

• تحقَّق من أنّ تطبيق الوسائط المحدَّد حاليًا يتضمّن نشاطًا فلتر الأهداف

• إذا كان الأمر كذلك، فاسمح للمستخدم بالانتقال إلى النشاط.

• إذا كانت قيود تجربة المستخدم في السيارة سارية (على سبيل المثال، عندما تتحرك السيارة)، فيجب أن تكون هذه الوظيفة أن يتم إيقافها لأنّ نشاط الإعدادات ليس واجهة مستخدم محسَّنة لبرنامج التشغيل.

حدث خطأ أثناء المعالجة ويجب تسجيل الدخول

تتفاعل الوسائط مع تطبيقات الوسائط من خلال واجهة برمجة التطبيقات Android Media Session API. وكجزء من هذه العملية واجهة برمجة التطبيقات، تتلقى الوسائط PlaybackState والذي يعبر عن الوضع الحالي لتطبيق الوسائط.

تبدأ عملية تسجيل الدخول عند إجراء تغيير على تطبيق الوسائط. PlaybackState إلى STATE_ERROR, بما في ذلك رمز خطأ معيّن (راجِع التفاصيل أدناه). عندما يكون هذا ستعرض الوسائط وصف الخطأ وسمة للانتقال إلى نشاط تسجيل الدخول عن طريق تطبيق الوسائط

ويمكن للتطبيقات استخدام هذا التدفق نفسه للإشارة إلى حالات خطأ أخرى (على سبيل المثال، حدث خطأ في اتصال الخادم).

الشكل 4. خطأ أثناء المعالجة

كجزء من معالجة أخطاء PlaybackState العادية، يجب أن تبحث الوسائط عن مصدر الإدخال التالي.

• رمز خطأ واحد (PlaybackState) يساوي PlaybackStateCompat#ERROR_CODE_AUTHENTICATION_EXPIRED يشير هذا إلى أن تطبيق الوسائط يتطلب تسجيل الدخول لمتابعة تشغيله. يمكن أن تكون رموز الخطأ الأخرى الأمر الذي قد يشير إلى أنواع أخرى من حالات الخطأ.

• رسالة الخطأ PlaybackState (تضبطها تطبيقات الوسائط باستخدام PlaybackStateCompat.Builder#setErrorMessage ) تحتوي على شرح يمكن لشخص عادي قراءته (مثل "لم يتم تسجيل دخولك."). يجب عرض هذه الرسالة لـ المستخدم ويجب أن يؤدي إلى تحسين تشتيت الانتباه (DO).

• يمكن أن يتضمن PlaybackState بشكل اختياري الميزات الإضافية التالية (تم ضبطها حسب الوسائط التطبيقات التي تستخدم PlaybackStateCompat.Builder#setExtras ) بالمفاتيح التالية.

  • android.media.extras.ERROR_RESOLUTION_ACTION_LABEL قم بتعيينها على سلسلة يحتوي على رسالة يمكن لشخص عادي قراءتها ليتم عرضها على الزر الذي يضغط عليه المستخدم لبدء تدفق تسجيل الدخول.

  • android.media.extras.ERROR_RESOLUTION_ACTION_INTENT الضبط باستخدام PendingIntent يتم تشغيلها عندما ينقر المستخدم على الزر المذكور أعلاه. هذا النمط PendingIntent يشير إلى نشاط تسجيل دخول مخصَّص ينفِّذه تطبيق الوسائط نفسه.

• ولاية PlaybackState تساوي STATE_ERROR تشير هذه الرسالة إلى أنّه لا يمكن إجراء أي عملية أخرى إلى أن تكتمل عملية تسجيل الدخول.