پیکربندی فایل های مانیفست

فایل های مانیفست برنامه خود را برای ادغام با Android Auto و Android Automotive OS (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>

پیکربندی پلتفرم خاص

علاوه بر پیکربندی که در این صفحه توضیح داده شده است، بخش‌های زیر را برای الزامات پلتفرم خاص مشاهده کنید: