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

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

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

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

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

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

<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. يجب توفير الرمزَين التاليَين:

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

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

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

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

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

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

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

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

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

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

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