Dodawanie obsługi Androida Auto w aplikacji wstrzymanej

Na urządzeniach z Androidem 15 lub nowszym Android Auto obsługuje uruchamianie aplikacji z obsługiwanych kategorii aplikacji na postoju bezpośrednio na jednostce głównej. Więcej informacji o korzystaniu z aplikacji działających po zaparkowaniu w Androidzie Auto znajdziesz w sekcji Aplikacje działające po zaparkowaniu.

Deklarowanie obsługi Androida Auto

Aby zadeklarować, że Twoja aplikacja obsługuje Androida Auto, musisz dodać ten element<category> do filtra intencji działania w pliku manifestu aplikacji:

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

Zwykle element kategorii android.intent.category.CAR_LAUNCHER można umieścić w tym samym filtrze intencji co element android.intent.category.LAUNCHER, ale w razie potrzeby można go umieścić w innym filtrze.

Wpisy w pliku manifestu dotyczące określonej kategorii

Oprócz powyższego wymagania gry muszą spełniać dodatkowe wymaganie. Zobacz Oznaczanie aplikacji jako gry.

Obsługa typowych rozmiarów ekranu Androida Auto

Aby zapewnić użytkownikom jak najlepsze wrażenia, zalecamy, aby aplikacja była w pełni dostosowana do różnych rozmiarów ekranu. Aby zapewnić wysoką jakość działania aplikacji na różnych samochodach obsługujących Androida Auto, aplikacje nie mogą być znacznie ograniczone do środka ekranu w przypadku ekranów w orientacji poziomej, co jest opisane we wskazówce dotyczącej jakości aplikacji samochodowych DO-2.

Jeśli na przykład aplikacja działa w orientacji pionowej z pillarboxingiem na ekranie w orientacji poziomej, zostanie odrzucona podczas weryfikacji w Sklepie Play. Aplikacja działająca w formacie obrazu w orientacji poziomej z minimalnym pillarboxingiem na ekranie w orientacji poziomej jest dopuszczalna, podobnie jak aplikacja działająca w formacie obrazu w orientacji poziomej z letterboxingiem na ekranie w orientacji pionowej.

Testowanie na podstawie kanonicznych rozmiarów ekranu

Podczas tworzenia i testowania aplikacji na Androida Auto możesz użyć tych konfiguracji jednostki głównej na komputerze, aby sprawdzić, czy aplikacja spełnia powyższe wymagania:

[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
...

Wykrywanie użycia w Androidzie Auto

Jeśli chcesz wykrywać, kiedy aplikacja jest używana w Androidzie Auto (np. na potrzeby analizy), możesz sprawdzić 2 sygnały:

• Stan połączenia zgłoszony przez interfejs CarConnection API. Gdy Android Auto jest połączony, ten symbol będzie wyglądać tak: CONNECTION_TYPE_PROJECTION.
• Identyfikator wyświetlania aktywnego wyświetlacza. Gdy aplikacja jest uruchomiona na wyświetlaczu innym niż wbudowany ekran, np. w Androidzie Auto, ta wartość jest inna niż DEFAULT_DISPLAY.

Poniższy fragment kodu pokazuje, jak połączyć te sygnały, aby wykryć korzystanie z usługi w Androidzie Auto:

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