پشتیبانی از Android Auto را به برنامه پارک شده خود اضافه کنید

در دستگاه‌های دارای Android 15 یا بالاتر، Android Auto از اجرای برنامه‌ها در دسته‌های برنامه پارک شده پشتیبانی‌شده مستقیماً روی واحد اصلی پشتیبانی می‌کند. برای اطلاعات بیشتر درباره تجربه کاربری برنامه پارک شده در Android Auto، به برنامه‌های پارک شده مراجعه کنید.

پشتیبانی از Android Auto را اعلام کنید

برای اعلام اینکه برنامه شما از Android Auto پشتیبانی می‌کند، باید عنصر <category> زیر را در فیلتر هدف یک فعالیت در مانیفست برنامه خود قرار دهید:

<activity ...>
    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        ...
        <category android:name="android.intent.category.CAR_LAUNCHER" />
    </intent-filter>
</activity>

به طور کلی، عنصر دسته android.intent.category.CAR_LAUNCHER را می توان در همان فیلتر هدف با عنصر android.intent.category.LAUNCHER قرار داد، اما در صورت تمایل می تواند در فیلتر دیگری قرار گیرد.

ورودی های مانیفست مخصوص دسته

علاوه بر نیاز قبلی، بازی ها یک نیاز اضافی نیز دارند. به علامت گذاری برنامه خود به عنوان یک بازی مراجعه کنید.

سایزهای معمول صفحه نمایش Android Auto را پشتیبانی کنید

برای بهترین تجربه کاربری، توصیه می کنیم برنامه خود را کاملاً با اندازه های مختلف صفحه نمایش تطبیق دهید . حداقل، برای اطمینان از تجربه با کیفیت بالا در انواع ماشین‌هایی که از Android Auto پشتیبانی می‌کنند، برنامه‌ها نباید به‌طور قابل توجهی روی صفحه‌نمایش‌های افقی ستون‌بندی شوند، همانطور که در دستورالعمل کیفیت برنامه ماشین DO-2 ثبت شده است.

برای مثال، اگر برنامه‌ای با نسبت ابعاد عمودی با ستون‌باکسینگ روی صفحه‌نمایش افقی اجرا شود، در طول بررسی فروشگاه Play رد می‌شود. برنامه‌ای که با نسبت ابعاد افقی اجرا می‌شود با حداقل ستون‌بوکسینگ روی صفحه‌نمایش افقی قابل قبول است، همانطور که برنامه‌ای که با نسبت ابعاد افقی اجرا می‌شود و جعبه نامه روی صفحه عمودی اجرا می‌شود.

تست در برابر اندازه صفحه نمایش متعارف

هنگام ساختن و آزمایش برنامه خود برای Android Auto، می‌توانید از پیکربندی‌های Desktop Head Unit (DHU) زیر استفاده کنید تا تأیید کنید که برنامه شما با شرایط قبلی مطابقت دارد:

منظره کوچک

[general]
resolution = 800x480
dpi = 160
...

چشم انداز وسیع

[general]
resolution = 1920x1080
dpi = 160
marginheight = 596
normalizedpi = true
cropmargins = true
...

پرتره

[general]
resolution = 1920x1080
dpi = 160
marginwidth = 878
normalizedpi = true
cropmargins = true
...

تشخیص میزان مصرف در Android Auto

اگر می خواهید تشخیص دهید که چه زمانی از برنامه شما از طریق Android Auto استفاده می شود (مانند اهداف تجزیه و تحلیل)، می توانید به دو سیگنال نگاه کنید:

  • وضعیت اتصال گزارش شده توسط CarConnection API. وقتی Android Auto متصل است، CONNECTION_TYPE_PROJECTION خواهد بود.
  • شناسه نمایشگر نمایشگر فعال. وقتی برنامه شما روی نمایشگری غیر از صفحه داخلی اجرا می‌شود، مانند زمانی که از طریق Android Auto استفاده می‌شود، این مقداری غیر از DEFAULT_DISPLAY است.

قطعه زیر نحوه ترکیب این سیگنال ها را برای تشخیص استفاده از طریق Android Auto نشان می دهد:

val connectionType = ...
val displayId = context.display.displayId
isRunningOnAndroidAuto = connectionType == CONNECTION_TYPE_PROJECTION and displayId != DEFAULT_DISPLAY