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

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

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

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

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

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

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

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

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

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

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

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

تُستخدَم سمة 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>

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

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

• إضافة دعم Android Auto إلى تطبيق الوسائط
• إضافة دعم نظام التشغيل Android Automotive إلى تطبيق الوسائط