تطبيقات الوسائط المتوافقة مع Car App Library

يمكن لمطوّري تطبيقات الموسيقى استخدام "مكتبة تطبيقات السيارات" (CAL) لإنشاء واجهة المستخدم الخاصة بتطبيقاتهم. تقدّم هذه المكتبة بديلاً عن الطريقة التقليدية لتقديم البيانات من خلال MediaBrowserService كي يتم عرضها في CarMediaApp.

تتيح تطبيقات الوسائط المستندة إلى CAL للمطوّرين تخصيص واجهة المستخدم لتتوافق مع هوية علامتهم التجارية. على عكس تطبيقات CAL، لا تسمح تطبيقات الوسائط التقليدية التي تستخدم MediaBrowserService وCarMediaApp للمطوّرين بتخصيص تصميم واجهة المستخدم، بل يتحكّم المصنّع الأصلي للجهاز في هذا التصميم.

يمكن للمطوّرين إنشاء تطبيق وسائط يستند إلى نماذج ويتوافق مع Android Auto ونظام التشغيل Android Automotive (AAOS).

الدمج

يتطلّب توفير الدعم لتطبيقات الوسائط المستندة إلى قوالب CAL دمجها مع النظام الأساسي.

المتطلبات الأساسية

تتيح ميزة "عناصر التحكّم البديلة في التطبيقات" للتطبيقات تشغيل الصوت في الخلفية مع توفير عناصر تحكّم محسّنة للحدّ من التشتيت للتحكّم في هذا الصوت.

• تتوفّر ميزة "عناصر التحكّم البديلة في التطبيقات" في الإصدار Car-apps-release-14 والإصدارات الأحدث.

  • يتيح هذا الإذن للتطبيقات تشغيل الصوت في الخلفية
  • يتيح إمكانية التحكّم في التطبيقات التي لا تستخدم MediaBrowserService من خلال بطاقة وسائط النظام.

• يجب أن توضّح المنصة توافقها مع com.android.car.background_audio_while_driving.

التغييرات في النظام الأساسي

يجب أن يستوفي CarMediaApp المنصة الشروط التالية:

• لديك الإذن بتفعيل نشاط تطبيق وسائط CAL. الاطّلاع على مثال الرمز البرمجي
• تشغيل نشاط CAL بدلاً من "مركز الوسائط" على الأجهزة التي تتوافق مع ميزة android.software.car.templates_host.media الاطّلاع على مثال الرمز البرمجي

يجب أن يستوفي "مشغّل تطبيقات السيارة" على المنصة الشروط التالية:

• عرض رمز تطبيق واحد فقط في Car Launcher بعد أن يفعّل CarMediaApp نشاط CAL لتطبيق وسائط
• ابحث عن البث PACKAGE_CHANGED وأعِد تحميل قائمة التطبيقات. الاطّلاع على مثال الرمز البرمجي

يجب أن تتضمّن بطاقة الوسائط أو التطبيق المصغّر على المنصة ما يلي:

• عرض الصوت الذي يتم تشغيله في بطاقة الوسائط

إعدادات التصميم

يجب أن تعلن المنصة عن توفيرها الدعم android.software.car.templates_host.media:

<permissions>
    <!-- Declare support for templated applications. -->
    <feature name="android.software.car.templates_host" />

    <!-- This feature indicates that the system supports apps that use the
    Car App Library Media category -->
    <feature name="android.software.car.templates_host.media"/>
</permissions>

اختبار

تتيح منصة الاختبار استخدام تطبيقات الوسائط المستندة إلى CAL من خلال TestMediaCalApp. ‫TestMediaCalApp هو تطبيق وسائط تم إنشاؤه باستخدام Car App Library، ويعرضه Templates Host على المنصة.

1. ثبِّت TestMediaCalApp.apk.

2. افتح التطبيق المسمّى Test Media3 CAL App على مشغّل التطبيقات:

   

   الشكل 1: اختبار تطبيق Media3 CAL على "مشغّل تطبيقات السيارة"

3. بعد تشغيل التطبيق، ارجع إلى مشغّل التطبيقات ولاحظ أنّه تم تغيير اسم التطبيق إلى Test Media CAL App. يجب ألا يظهر التطبيق السابق الذي يحمل الاسم Test Media3 CAL App بعد الآن:

   

   الشكل 2: اختبار تطبيق Media CAL على "مشغّل تطبيقات السيارة"

4. افتح تطبيق Test Media CAL وشغِّل أي أغنية من خلال النقر على أغنية في قائمة التشغيل:

   

   الشكل 3: عرض قائمة التشغيل الذي يعرضه App Host

5. لاحظ أنّه تم فتح طريقة عرض "يتم الآن تشغيل" (MediaPlaybackTemplate):

   

   الشكل 4: عرض "التعرّف التلقائي على الموسيقى" الذي يعرضه App Host.

6. لاحظ أنّ البيانات الوصفية الخاصة بالمحتوى قيد التشغيل تظهر في تطبيق الوسائط المصغّر على الشاشة الرئيسية:

   

   الشكل 5. بطاقة الوسائط