Park edilmiş uygulamanıza Android Auto desteği ekleme

Android 15 veya sonraki sürümlerin yüklü olduğu cihazlarda Android Auto, desteklenen park edilmiş uygulama kategorilerindeki uygulamaların doğrudan ana birimde çalıştırılmasını destekler. Android Auto'da park halindeyken kullanılabilen uygulamaların kullanıcı deneyimi hakkında daha fazla bilgi için Park halindeyken kullanılabilen uygulamalar bölümüne bakın.

Android Auto desteğini beyan etme

Uygulamanızın Android Auto'yu desteklediğini beyan etmek için uygulamanızın manifest dosyasındaki bir etkinliğin intent filtresine aşağıdaki <category> öğesini eklemeniz gerekir:

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

Genellikle android.intent.category.CAR_LAUNCHER kategori öğesi, android.intent.category.LAUNCHER öğesiyle aynı intent filtresine yerleştirilebilir ancak tercih edilirse farklı bir filtreye de yerleştirilebilir.

Kategoriye özel manifest girişleri

Oyunlar için yukarıdaki koşula ek olarak başka bir koşul daha vardır. Uygulamanızı oyun olarak işaretleme başlıklı makaleyi inceleyin.

Yaygın Android Auto ekran boyutlarını destekleme

En iyi kullanıcı deneyimi için uygulamanızı farklı ekran boyutlarına tam uyumlu hale getirmenizi öneririz. Android Auto'yu destekleyen çeşitli arabalarda yüksek kaliteli bir deneyim sunmak için uygulamalar, DO-2 araba uygulaması kalite yönergesinde belirtildiği gibi yatay ekranlarda önemli ölçüde dikey kenar boşlukları bırakmamalıdır.

Örneğin, bir uygulama yatay ekranda dikey en boy oranında ve dikey kenar boşluklarıyla çalışıyorsa Google Play Store incelemesi sırasında reddedilir. Yatay ekranda minimum dikey karartma ile yatay en boy oranında çalışan bir uygulama kabul edilebilir. Aynı şekilde, dikey ekranda yatay karartma ile yatay en boy oranında çalışan bir uygulama da kabul edilebilir.

Standart ekran boyutlarına göre test etme

Uygulamanızı Android Auto için oluşturup test ederken, uygulamanızın yukarıdaki şartları karşıladığını doğrulamak için aşağıdaki Masaüstü Ana Birimi (DHU) yapılandırmalarını kullanabilirsiniz:

Küçük Yatay

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

Geniş Yatay

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

Dikey

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

Android Auto'da kullanımı algılama

Uygulamanızın Android Auto üzerinden ne zaman kullanıldığını tespit etmek istiyorsanız (ör. analiz amacıyla) iki sinyale bakabilirsiniz:

  • CarConnection API'si tarafından bildirilen bağlantı durumu. Android Auto bağlıyken bu simge CONNECTION_TYPE_PROJECTION olur.
  • Etkin ekranın ekran kimliği. Uygulamanız, yerleşik ekran dışında bir ekranda (ör. Android Auto üzerinden kullanıldığında) çalışıyorsa bu değer DEFAULT_DISPLAY dışında bir değerdir.

Aşağıdaki snippet'te, Android Auto üzerinden kullanımı algılamak için bu sinyallerin nasıl birleştirileceği gösterilmektedir:

val displayId = context.display?.displayId ?: DEFAULT_DISPLAY
isRunningOnAndroidAuto = (connectionType == CONNECTION_TYPE_PROJECTION) && (displayId != DEFAULT_DISPLAY)