ضبط ملفات البيان

اضبط ملفات بيان تطبيقك لتتكامل مع Android Auto وAndroid Automotive OS (AAOS). لتفعيل إمكانية العثور على خدمة متصفّح الوسائط والاتصال بها من خلال هذه الأنظمة الأساسية، يجب تعريف خدمة متصفّح الوسائط في البيان. حدِّد رموز التطبيقات المطلوبة، بما في ذلك رمز مشغّل التطبيقات ورمز تحديد المصدر الذي تستخدمه مكوّنات واجهة مستخدم النظام، مثل عناصر التحكّم في الوسائط.

لمزيد من المعلومات عن ملفات البيان، اطّلِع على نظرة عامة على بيان التطبيق.

تعريف خدمة متصفّح الوسائط

يتصل كل من Android Auto وAndroid Automotive OS بتطبيقك من خلال خدمة متصفّح الوسائط لتصفّح عناصر الوسائط. عليك الإفصاح عن خدمة متصفّح الوسائط في ملف البيان الخاص بك للسماح لنظامَي Android Auto وAndroid Automotive OS باكتشاف الخدمة والاتصال بتطبيقك.

يوضّح مقتطف الرمز البرمجي هذا كيفية تعريف خدمة متصفّح الوسائط في ملف البيان. يوضّح القسم التالي من هذا الدليل، إنشاء خدمة متصفّح وسائط، عملية تنفيذ الخدمة.

<application>
    ...
    <service android:name=".MyMediaBrowserService"
             android:exported="true">
        <intent-filter>
            <action android:name="android.media.browse.MediaBrowserService"/>
        </intent-filter>
    </service>
    ...
</application>

تحديد رموز التطبيقات

لتمثيل تطبيقك في واجهة مستخدم النظام، حدِّد رموز التطبيق التي يجب أن يستخدمها Android Auto وAndroid Automotive OS. يجب توفير الرمزَين التاليَين:

تحديد رمز مشغّل التطبيقات

يمثّل رمز مشغّل التطبيقات تطبيقك في واجهة مستخدم النظام، مثل مشغّل التطبيقات ولوحة الرموز.

يتم تلقائيًا استخدام السمة android:icon لعنصر <application> في تطبيقك كرمز مشغّل التطبيق:

<application
    ...
    android:icon="@mipmap/ic_launcher"
>

لاستخدام رمز مختلف، اضبط السمة android:icon لعنصر <service> في خدمة متصفّح الوسائط:

<application>
    ...
    <service
        ...
        android:icon="@mipmap/ic_car_launcher"/>
</application>

تحديد رمز تحديد المصدر

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

رمز الإحالة على بطاقة الوسائط

الشكل 1. رمز الإحالة على بطاقة الوسائط

يمكنك تحديد رمز يُستخدَم لتمثيل تطبيقك باستخدام بيان البيانات التالي:

<application>
    ...
    <meta-data
        android:name="androidx.car.app.TintableAttributionIcon"
        android:resource="@drawable/ic_status_icon" />
    ...
</application>

تحديد تصنيف تطبيقك

بشكلٍ تلقائي، يتم استخدام قيمة السمة android:label لعنصر <application> في تطبيقك كاسم معروض لتطبيقك على شاشة السيارة.

لاستخدام اسم معروض مختلف، أو إذا كان تطبيقك يتضمّن خدمات متعددة لتصفّح الوسائط، اضبط السمة android:label لعنصر <service> الخاص بخدمة تصفّح الوسائط.

تحديد لون التمييز في تطبيقك

يستخدم نظاما التشغيل Android Auto وAAOS لون التمييز في تطبيقك لتصميم عناصر التحكّم في التشغيل وعناصر أخرى في واجهة المستخدم.

يتم تلقائيًا استرداد لون التمييز من العنصر colorAccent في مورد الأنماط android:theme الخاص بالعنصر <application> في تطبيقك.

لاستخدام لون تمييز مختلف لتجربة القيادة، أدرِج عنصر <meta-data> لمورد نمط مختلف يحتوي على عنصر colorAccent:

<application>
    ...
    <meta-data
        android:name="com.google.android.gms.car.application.theme"
        android:resource="@style/THEME_NAME"/>
    ...
</application>

الإعدادات الخاصة بالنظام الأساسي

بالإضافة إلى الإعدادات المفصّلة في هذه الصفحة، يُرجى الاطّلاع على الأقسام التالية لمعرفة المتطلبات الخاصة بكل منصة: