Menambahkan dukungan untuk Android Auto ke aplikasi parkir

Di perangkat yang menjalankan Android 15 atau yang lebih tinggi, Android Auto mendukung aplikasi yang berjalan dalam kategori aplikasi parkir yang didukung langsung di head unit. Lihat Aplikasi parkir untuk mengetahui informasi selengkapnya tentang pengalaman pengguna aplikasi parkir di Android Auto.

Mendeklarasikan dukungan Android Auto

Untuk mendeklarasikan bahwa aplikasi Anda mendukung Android Auto, Anda harus menyertakan elemen <category> berikut dalam filter intent aktivitas dalam manifes aplikasi:

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

Umumnya, elemen kategori android.intent.category.CAR_LAUNCHER dapat ditempatkan di filter intent yang sama dengan elemen android.intent.category.LAUNCHER, tetapi dapat ditempatkan di filter yang berbeda jika diinginkan.

Entri manifes khusus kategori

Selain persyaratan sebelumnya, game memiliki persyaratan tambahan. Lihat Menandai aplikasi sebagai game.

Mendukung ukuran layar Android Auto umum

Untuk pengalaman pengguna terbaik, sebaiknya buat aplikasi Anda sepenuhnya adaptif ke berbagai ukuran layar. Setidaknya, untuk memastikan pengalaman berkualitas tinggi di berbagai mobil yang mendukung Android Auto, aplikasi tidak boleh memiliki pillarbox yang signifikan di layar lanskap, seperti yang digambarkan dalam pedoman kualitas aplikasi mobil DO-2.

Misalnya, jika aplikasi berjalan dalam rasio aspek potret dengan pillarboxing di layar lanskap, aplikasi akan ditolak selama peninjauan Play Store. Aplikasi yang berjalan dalam rasio aspek lanskap dengan pillarboxing minimal di layar lanskap dapat diterima, begitu juga dengan aplikasi yang berjalan dalam rasio aspek lanskap dengan tampilan lebar di layar potret.

Menguji berdasarkan ukuran layar kanonis

Saat mem-build dan menguji aplikasi untuk Android Auto, Anda dapat menggunakan konfigurasi Desktop Head Unit (DHU) berikut untuk memverifikasi bahwa aplikasi Anda memenuhi persyaratan sebelumnya:

Lanskap Kecil

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

Lanskap Lebar

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

Potret

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

Mendeteksi penggunaan di Android Auto

Jika ingin mendeteksi kapan aplikasi Anda digunakan melalui Android Auto (seperti untuk tujuan analisis), Anda dapat melihat dua sinyal:

  • Status koneksi yang dilaporkan oleh CarConnection API. Saat Android Auto terhubung, ini akan menjadi CONNECTION_TYPE_PROJECTION.
  • ID tampilan dari tampilan aktif. Saat aplikasi Anda berjalan di layar selain layar bawaan, seperti saat digunakan melalui Android Auto, ini adalah nilai selain DEFAULT_DISPLAY.

Cuplikan berikut menunjukkan cara menggabungkan sinyal ini untuk mendeteksi penggunaan melalui Android Auto:

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