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

. keywords_public: Android Auto, Android Automotive OS, AAOS, Manifest, Media Browser Service, App Icons, Car UI, Manifest Configuration, Media App, Car Development

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

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

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

يتصل Android Auto وAAOS بتطبيقك من خلال خدمة متصفّح الوسائط لتصفّح عناصر الوسائط. عليك الإفصاح عن خدمة متصفّح الوسائط في ملف البيان الخاص بك للسماح لنظامَي 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>

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

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