Test mit der Desktop-Haupteinheit

Mit der Desktop-Haupteinheit (DHU) kann Ihr Entwicklungscomputer eine Android Auto-Haupteinheit emulieren, sodass Sie Android Auto-Apps ausführen und testen können. Die DHU läuft auf Windows-, macOS- und Linux-Systemen.

Nachdem Sie die DHU installiert haben, können Sie Ihre Android Auto-Apps testen. Dazu verbinden Sie Ihr Mobilgerät über einen der unterstützten Verbindungsmechanismen, die unter DHU ausführen beschrieben werden.

Hinweis :Wenn du den Test auf einem Mobilgerät mit Android 10 (API-Level 29) oder höher durchführst, musst du dich im Google Play Store anmelden und die Android Auto App aktualisieren, bevor du die DHU zum ersten Mal ausführst. Wenn Sie eine Medien-App erstellen, können Sie Ihre Implementierung der Mediensitzung auch mit der Media Controller Test App testen.

Über die Problemverfolgung können Sie Fehler melden oder Funktionen für die DHU anfordern.

DHU installieren

So installieren Sie die DHU auf Ihrem Entwicklungscomputer:

1. Aktivieren Sie den Entwicklermodus auf einem Mobilgerät mit Android 6.0 (API-Level 23) oder höher, wie unter Entwickleroptionen auf dem Gerät konfigurieren beschrieben.
2. Kompiliere und installiere deine App auf dem Gerät.
3. Installieren Sie Android Auto auf dem Gerät. Wenn Android Auto bereits installiert ist, achten Sie darauf, dass Sie die neueste Version verwenden.
4. Öffnen Sie in Android Studio den SDK-Manager, gehen Sie zum Tab SDK Tools und laden Sie das Paket Android Auto Desktop Head Unit Emulator herunter.

Die DHU wird im Verzeichnis SDK_LOCATION/extras/google/auto/ installiert.

1. Führen Sie auf Linux- oder macOS-Systemen den folgenden Befehl in diesem Verzeichnis aus, damit die DHU-Binärdatei ausführbar ist:

   chmod +x ./desktop-head-unit
   

Hinweis: Die DHU enthält eine libusb-Bibliothek, die in dasselbe Verzeichnis heruntergeladen wird. Diese Bibliothek sollte sich am selben Speicherort wie die ausführbare DHU-Datei befinden, damit sie ordnungsgemäß ausgeführt werden kann.

Zusätzliche Schritte für Linux

Wenn Sie die DHU-Version 2.x auf einem Linux-System ausführen, müssen Sie einige zusätzliche Bibliotheken installieren. Das DHU-Binärprogramm hängt von GLIBC-Version 2.32 oder höher ab. Mit dem folgenden Befehl können Sie die GLIBC-Version Ihres Systems prüfen:

ldd --version

Wenn die Version niedriger als 2.32 ist, aktualisieren Sie GLIBC auf 2.32 oder höher. Möglicherweise müssen Sie das Betriebssystem dann auf eine Version aktualisieren, die mit GLIBC 2.32 oder höher kompatibel ist.

Sie müssen auch die Bibliotheken libc++1 und libc++abi1 installieren. Das Installationsverfahren variiert je nach Linux-Distribution. In Debian-abgeleiteten Linux-Distributionen können Sie die Bibliotheken beispielsweise mit diesem Befehl installieren:

sudo apt-get install libc++1 libc++abi1

Vorabversionen der DHU installieren

Um Zugriff auf Vorabversionen der DHU zu erhalten, kannst du entweder eine Vorschauversion von Android Studio verwenden oder die Update-Version deiner vorhandenen Android Studio-Installation in die Betaversion ändern.

DHU ausführen

Nachdem Sie die DHU installiert haben, können Sie Ihre Android Auto-Apps testen, indem Sie Ihr Mobilgerät und Ihre Workstation über USB verbinden. Führen Sie die DHU aus. Verbinden Sie dazu Ihr Mobilgerät über den Zugriffsmodus (empfohlen für DHU 2.x) oder ADB-Tunneling mit einem Entwicklungscomputer.

Über den Zubehörmodus verbinden

Android Auto unterstützt die Verbindung zu DHU-Version 2.x über das Protokoll Android Open Accessory (AOA) mit dem folgenden Befehl:

./desktop-head-unit --usb

Standardmäßig durchsucht das DHU die Liste der verfügbaren USB-Geräte und versucht, eine Verbindung zum ersten kompatiblen USB-Gerät herzustellen. Wenn Sie eine Ausrichtung auf ein bestimmtes Gerät vornehmen möchten, fügen Sie die Geräte-ID in den Befehl --usb ein:

./desktop-head-unit --usb=[DEVICE_ID]

Hinweis: Unter Windows erfordert diese Funktion möglicherweise die Installation des WinUSB-Treibers auf Ihrem Mobilgerät und kann die ADB-Verbindung beeinträchtigen. Wenn das Mobilgerät von der DHU nicht erkannt und keine Verbindung dazu hergestellt werden kann, führen Sie adb kill-server aus, bevor Sie die DHU starten, oder verwenden Sie die alternative Verbindungsmethode wie im folgenden Abschnitt beschrieben.

Über ADB-Tunneling verbinden

Für diese Methode muss eine Verbindung zum Android Auto-Server für Infotainmentsystem über Android Debug Bridge (adb) eingerichtet werden. Führen Sie die folgenden Schritte aus, um das Tunneling einzurichten und die DHU auszuführen:

1. Aktivieren Sie den Android Auto-Entwicklermodus, falls noch nicht geschehen.

2. Wenn der Server für das Infotainmentsystem noch nicht ausgeführt wird, öffne das Dreipunkt-Menü und wähle Server für Infotainmentsystem starten aus (siehe Abbildung 1).

   Auf dem Gerät wird im Benachrichtigungsbereich ein Dienst im Vordergrund angezeigt, der darauf hinweist, dass der Server ausgeführt wird (siehe Abbildung 2).

   

   Abbildung 1: Kontextmenü mit Entwickleroptionen.

   

   Abbildung 2: Benachrichtigung, dass der Server für das Infotainmentsystem ausgeführt wird.

3. Tippen Sie in der Android Auto App oben in den Einstellungen auf Zuletzt verbundene Autos und prüfen Sie, ob Neue Autos zu Android Auto hinzufügen aktiviert ist.

4. Verbinden Sie das Mobilgerät über USB mit dem Entwicklungscomputer.

5. Der Bildschirm des Mobilgeräts muss entsperrt sein, damit die DHU gestartet werden kann.

6. Führen Sie auf dem Entwicklungscomputer den folgenden adb-Befehl aus, um Socket-Verbindungen vom Port 5277 des Entwicklungscomputers an dieselbe Portnummer auf dem Android-Gerät weiterzuleiten. Mit dieser Konfiguration kann die DHU über einen TCP-Socket eine Verbindung zum Server der Haupteinheit herstellen, der auf dem Mobilgerät ausgeführt wird.

   adb forward tcp:5277 tcp:5277
   

7. Starten Sie die DHU über das Verzeichnis SDK_LOCATION/extras/google/auto/ mit dem Befehl desktop-head-unit.exe unter Windows oder ./desktop-head-unit unter macOS oder Linux:

   cd SDK_LOCATION/extras/google/auto
   desktop-head-unit.exe # Windows
   ./desktop-head-unit # macOS or Linux
   

1. Wenn Sie das Mobilgerät zum ersten Mal mit der DHU verbinden, akzeptieren Sie die Nutzungsbedingungen auf dem Bildschirm des Mobilgeräts und passen Sie die Berechtigungseinstellungen nach Bedarf an.

Nachdem die DHU gestartet wurde, können Sie Ihre Anwendung mit DHU-Konsolenbefehlen ausführen und testen.

Befehlszeilenoptionen

Standardmäßig wird der Server für das Infotainmentsystem über Port 5277 verbunden. Verwenden Sie das Flag --adb=<[localhost:]port>, wie im folgenden Beispiel gezeigt, um den Host oder Port zu überschreiben:

./desktop-head-unit --adb=5999

Standardmäßig emuliert die DHU ein mit Android Auto kompatibles Infotainmentsystem mit einer Touchscreen-Benutzeroberfläche. Berührungen von Nutzern durch Klicken auf die DHU mit der Maus simulieren. Um Haupteinheiten zu emulieren, die einen Drehregler für die Eingabe verwenden, können Sie das Flag -i rotary verwenden, wie im folgenden Beispiel gezeigt:

./desktop-head-unit -i controller

Wenn sich die DHU im Dreh-Controller-Modus befindet, können Sie mithilfe von Tastenkombinationen Controller-Vorgänge simulieren. Weitere Informationen finden Sie im Abschnitt Dreh-Controller. Im Rotary-Controller-Modus ignoriert die DHU Mausklicks. Sie müssen Android Auto mit den simulierten Drehcontrollern betreiben.

Weitere Befehlszeilenoptionen für DHU sind in der folgenden Tabelle aufgeführt:

Option	Beschreibung
-c, --config=FILE	Verwenden Sie die angegebene Konfigurationsdatei .ini. Weitere Informationen findest du im Abschnitt DHU konfigurieren.
-i, --input=INPUT	Verwenden Sie den angegebenen Eingabemodus. Entweder touch, rotary oder hybrid.
-a, --adb=HOSTPORT	Verwenden Sie ADB-Transport. Optional: host:port oder port. Die Standardeinstellung ist Port 5277.
-a, --usb=DEVICE_ID	Verwenden Sie AOA-USB-Transport. Optional: DEVICE_ID.
-v, --version	Versionsinformationen anzeigen.
-l, --licenses	Open-Source-Lizenzen anzeigen.
-h, --headless	Ausführung im monitorlosen Modus ohne Benutzeroberfläche.
-t, --always_show_window_on_top	DHU-Fenster über anderen Fenstern anzeigen (standardmäßig deaktiviert)
-?, --help	Hilfeeintrag anzeigen.

DHU-Nutzerhandbuch

In diesem Abschnitt werden die von der DHU unterstützten Funktionen und ihre Verwendung beschrieben.

Befehle werden in das Terminalfenster eingegeben, in dem Sie DHU gestartet haben. Mehrere Befehle können in derselben Zeile ausgeführt werden. Trennen Sie sie dazu durch ;.

System

Befehl	Schlüssel	Beschreibung
help [command]		Vollständigen Befehlssatz anzeigen. Wenn ein Befehlsname angegeben ist, rufen Sie die Hilfe zu diesem Befehl auf.
quit exit	Alt+Q	Schließen Sie das Infotainmentsystem.
sleep [seconds]		Schlaf eine Sekunde lang. Wenn eine Verzögerung angegeben ist, wird in den Ruhemodus für so viele seconds versetzt. Dies kann verwendet werden, um Skripts für das Infotainmentsystem mit ./desktop-head-unit < script.txt zu erstellen, z. B. in einer CI-Umgebung.
screenshot filename.png		Screenshot in filename.png. speichern
licenses		Lizenzen der in der DHU verwendeten Bibliotheken anzeigen.
keycode keycode		Senden Sie keycode, einen der im Abschnitt Keycodes aufgeführten Namen.

Touchpad und Touchpad

Wenn „Touchpad“ oder „Touchpad“ aktiviert ist, wird das Klicken in das Anzeigefenster, bei Touch- oder Touchpad-Fenster, als Touch-Ereignis registriert.

Simulieren Sie für Touchscreen die Multi-Touch-Funktion, indem Sie mit der rechten Maustaste auf die Position des ersten Fingers klicken und dann die rechte Taste für den zweiten Finger anklicken und halten. Der Mittelpunkt der beiden Finger bleibt unverändert. Wenn Sie die Maus bewegen, können Sie sie um die Mitte drehen, auseinander- und zusammenziehen oder beides.

Klicken Sie bei einem Touchpad auf die linke Taste und halten Sie die Maustaste gedrückt, um zwischen verschiedenen UI-Elementen auf dem Bildschirm zu scrollen. Durch Klicken auf die rechte Schaltfläche wird das fokussierte Element ausgewählt.

Befehl	Schlüssel	Beschreibung
tap x y		Simuliert ein Berührungsereignis an den angegebenen Koordinaten.

Drehsteuerung

Die DHU unterstützt Drehregler. Wenn es aktiviert ist, werden die folgenden Aktionen unterstützt:

• Auf dem Steuerkreuz nach oben, unten, links und rechts klicken
• Im und gegen den Uhrzeigersinn drehen
• Drehen einer Rotation (fünf Schritte auf einmal)
• Auf dem Controller nach unten und dann klicken

Die Befehle und Tastenkombinationen sind in der folgenden Tabelle aufgeführt.

Ein Scrollrad auf einer Maus sendet dpad rotate-Befehle und die mittlere Maustaste, normalerweise das Scrollrad, sendet dpad click-Befehle.

Beachten Sie, dass die meisten Autos einen Touchscreen haben. Einige Autos haben nur Drehregler, andere wiederum einen hybriden Touch-Controller. Autos bieten auch ein Touchpad, das zum Schwenken von Karten und zur Texteingabe verwendet werden kann. Berücksichtigen Sie diese unterschiedlichen Konfigurationen, wenn Sie verschiedene Infotainmentsysteme von Fahrzeugen simulieren.

Befehl	Schlüssel	Beschreibung
dpad {up|down|left|right}	Pfeiltasten	Bewegen Sie den Schieberegler.
dpad {ur|dl|ul|dr}		Bewegen Sie den Schieberegler.
dpad soft {left|right}	Umschalttaste + Pfeiltasten	Bei einigen Drehreglern verfügbare Seitentasten drücken.
dpad click	Zurück	Drehregler drücken
dpad back	Rücktaste	Drücke die Zurück-Taste, die unter einigen Drehreglern verfügbar ist.
dpad rotate left	1	Drehregler gegen den Uhrzeigersinn drehen (links).
dpad rotate right	2	Drehen Sie den Drehregler im Uhrzeigersinn (nach rechts).
dpad flick left	Umschalttaste + 1	Drehen Sie den Regler schnell gegen den Uhrzeigersinn.
dpad flick right	Umschalttaste + 2	Drehregler im Uhrzeigersinn drehen.
dpad 0-9*#+	Ziffernblock

Mikrofon

Die DHU unterstützt die Verwendung eines Mikrofons für die Spracheingabe oder zum Abspielen einer vorab aufgezeichneten Stimme. Der Einfachheit halber sind die folgenden Audiodateien für gängige Sprachbefehle in der DHU enthalten. Diese Sounddateien befinden sich im Verzeichnis SDK_LOCATION/extras/google/auto/voice/.

Dateiname	Text
navhome.wav	Zeig mir den Weg nach Hause.
navwork.wav	Zeig mir den Weg zur Arbeit.
navsoh.wav	Zeig mir den Weg zum Opernhaus Sydney.
navgoogle.wav	Rufen Sie 1600 Amphitheatre Parkway, California, USA auf.
exitnav.wav	Beenden Sie die Navigation.
howlong.wav	Wie lange dauert es, bis ich dort ankomme?
showtraffic.wav	Verkehrslage anzeigen.
showalternateroute.wav	Alternative Routen anzeigen.
pause.wav	Musik pausieren.
nextturn.wav	Wann muss ich das nächste Mal abbiegen?

Verwenden Sie den folgenden Befehl, um eine einzelne .wav-Datei in der DHU-Eingabeaufforderung auszuführen:

mic play /path/to/filename.wav

In der folgenden Tabelle sind weitere mikrofonbezogene Befehle aufgeführt:

Befehl	Schlüssel	Beschreibung
mic begin	M	Aktivieren Sie das Mikrofon, indem Sie ein Klicken auf die Taste am Lenkrad simulieren, und warten Sie auf eine Eingabe vom Computermikrofon.
mic play filename.wav		Aktiviere das Mikrofon und gib die angegebene WAV-Dateiaufnahme wieder. Hinweis: Sie hören die WAV-Datei, die abgespielt wird, nicht, aber Sie hören die Antwort von Android Auto.
mic repeat		Wiederholen Sie die letzte mit mic play verwendete Aufnahme.
mic reject {on|off}		Hier können Sie die Ablehnung von Mikrofonanfragen aktivieren oder deaktivieren. Wenn diese Option aktiviert ist, werden alle Mikrofonanfragen abgelehnt.

Sensoren

Die DHU unterstützt mit den folgenden Befehlen die Simulation von Änderungen in den Sensordaten des Fahrzeugs. Um Sensordaten zu simulieren und an Android Auto zu senden, müssen die entsprechenden Sensoren beim Starten der DHU mit der Konfigurationsdatei .ini aktiviert werden.

Befehl	Beschreibung
fuel [percentage]	Stellen Sie den Kraftstoffstand auf die angegebene Prozentzahl ein oder deaktivieren Sie den Kraftstoffstand (ohne Wert übergeben).
range [km]	Legen Sie den Bereich auf die angegebenen Kilometer fest oder deaktivieren Sie die Bereichsdaten (ohne Wert übergeben).
lowfuel [{on|off}]	Stellen Sie den Sensor für eine spritsparende Warnung ein oder deaktivieren Sie den Sensor, wenn kein Wert übergeben wird.
accel [x] [y] [z]	Legen Sie für den Beschleunigungsmesser die angegebenen x-, y- und z-Werte (m/s^2) fest oder deaktivieren Sie die Daten des Beschleunigungsmessers, wenn Sie keine Parameter übergeben haben. Übergeben Sie bei Bedarf NAN, um optionale Parameter zu überspringen.
compass bearing [pitch] [roll]	Stellen Sie den Kompass auf die angegebenen Neigungs-, Neigungs- und Wurfwerte (Grad) ein. Übergeben Sie bei Bedarf NAN, um optionale Parameter zu überspringen.
gyro [x] [y] [z]	Stellen Sie das Gyroskop auf die angegebene x-, y- und z-Drehgeschwindigkeit (rad/s) ein oder deaktivieren Sie die Gyroskopdaten, wenn keine Parameter übergeben wurden. Übergeben Sie bei Bedarf NAN, um optionale Parameter zu überspringen.
location lat long [accuracy] [altitude] [speed] [bearing]	Legen Sie für den Standort die angegebenen Breiten- und Längenwerte zusammen mit den optionalen Werten für Genauigkeit (m), Höhe (m), Geschwindigkeit (m/s) und Ausrichtung (Grad) fest. Übergeben Sie bei Bedarf NAN, um optionale Parameter zu überspringen.
odometer km [current_trip_km]	Legen Sie den Kilometerstand auf die angegebenen Kilometer fest und geben Sie optional einen aktuellen Kilometerwert an.
speed [speed]	Legen Sie die Fahrzeuggeschwindigkeit auf den angegebenen Wert (m/s) fest oder deaktivieren Sie den Sensor, wenn kein Wert übergeben wird.
tollcard {insert|remove}	Fügen Sie eine Mautkarte ein oder entfernen Sie sie.
gps_satellite number_in_use [[azimuth] [elevation] [prn] [snr] [used_in_fix]]	Legen Sie für den GPS-Satellitensensor den angegebenen Wert für die Verwendung zusammen mit der optionalen Liste für den Azimut (Grad innerhalb von 0 bis 360 Bereich), die Höhe (Grad innerhalb von 0 bis 90 Bereich), prn (Pseudozufallsrauschen), snr (dB) und die feste Verwendung (true oder false) fest.
parking_brake engaged	Stelle den Feststellbremssensor auf true oder false ein.
gear gear_value	Setzen Sie den Zahnradsensor auf den angegebenen Wert (z. B. 0 für neutral, 100 für das Auto, 101 für Park und 102 für rückwärts).

Tag- und Nachtmodus

Die DHU unterstützt mit den folgenden Befehlen und Tastenkombinationen den Wechsel zwischen Tag- und Nachtmodus:

Befehl	Schlüssel	Beschreibung
day	Umschalttaste + N	Aktiviere den Tag-Modus – helle Helligkeit, vollständige Farbe.
night	Strg + N	Nachtmodus aktivieren – geringe Helligkeit, hoher Kontrast
daynight nightday	N	Tag- oder Nachtmodus umschalten.

Fokussierung auf das Management

Die DHU unterstützt mit den folgenden Befehlen die Simulation, ob Android Auto den Fokus auf das Infotainmentsystem legt:

Befehl	Beschreibung
focus video {on|off|toggle}	Aktivieren oder deaktivieren Sie den Videofokus auf dem Infotainmentsystem. Wenn du den Videofokus deaktivierst, wird simuliert, dass die Haupteinheit in den nativen Modus wechselt.
focus audio {on|off|toggle}	Aktivieren oder deaktivieren Sie den Audiofokus am Infotainmentsystem. Wenn du den Audiofokus deaktivierst, wird simuliert, dass die Haupteinheit ihre eigene Audioquelle abspielt.
focus nav {on|off|toggle}	Navigationsfokus auf dem Infotainmentsystem aktivieren oder deaktivieren. Wenn du den Navigationsfokus deaktivierst, wird simuliert, dass die Haupteinheit ihr eigenes Navigationssystem ausführt.

Einschränkungen und Fahrstatus

Die DHU unterstützt die Simulation bestimmter Einschränkungen während der Fahrt, wie das Deaktivieren der Tastatur und das Ablehnen von Telefonkonfigurationen mithilfe der folgenden Befehle:

Befehl	Schlüssel	Beschreibung
restrict none		Alle Einschränkungen deaktivieren.
restrict all	Umschalttaste + U	Alle Einschränkungen aktivieren, z. B. „Fahren simulieren“.

Kombi-Instrument

Die DHU unterstützt die Emulation eines Kombi-Instruments. Dieser Cluster befindet sich normalerweise hinter dem Lenkrad und zeigt während der Navigation zur nächsten Abbiegung grundlegende Informationen an, z. B. den Namen der nächsten Straße oder einen Abbiegepfeil, die Entfernung oder die Zeit. Außerdem werden Informationen zu laufenden Telefonanrufen angezeigt.

Dies kann über den Eintrag instrumentcluster im Abschnitt [general] der Konfigurationsdatei oder über die Einträge navcluster oder phonecluster aktiviert werden, um jedes Feature separat zu steuern.

[general]
...
instrumentcluster = true

Cluster-Anzeige

Einige Fahrzeuge haben Cluster-Displays, auf denen detaillierte visuelle Informationen wie Kartenkacheln angezeigt werden können. Ab Version 2.1 der DHU (derzeit über den Update-Kanal Android Studio Beta verfügbar) können Sie eine solche Anzeige auf Ihrem Entwicklungscomputer emulieren.

Dazu können Sie eine Konfigurationsdatei mit dem Abschnitt [display] des Clusters verwenden. [display]-Abschnitte unterstützen dieselben Videokonfigurationsoptionen wie die Hauptanzeige, die im Abschnitt [general] der Datei konfiguriert ist.

Abbildung 3: Der Hauptbildschirm beim Ausführen der DHU mit einer sekundären Clusteranzeige.

Abbildung 4. Der Clusterbildschirm beim Ausführen der DHU mit einer sekundären Clusteranzeige.

...

# The display name following the colon can be whatever you like.
[display:cluster]
# Setting the displaytype as cluster is what lets the DHU know how to handle it.
displaytype = cluster
resolution = 800x480
dpi = 160
...

Diese Konfiguration kann entweder direkt einer vorhandenen .ini-Datei hinzugefügt oder wiederverwendet werden. Dazu speichern Sie sie in einer separaten Datei und übergeben beim Starten der DHU mehrere Konfigurationsdateien. Wenn Sie mehrere Konfigurationsdateien verwenden, werden frühere Definitionen eines bestimmten Werts überschrieben.

# Launch your landscape configuration with your cluster display configuration
./desktop-head-unit -c landscape.ini -c cluster.ini

# Launch the portait configuration with the same cluster display configuration
./desktop-head-unit -c portrait.ini -c cluster.ini

Medienwiedergabestatus

Die DHU unterstützt eine Anzeige mit zusätzlichen Informationen, die den Status der Medienwiedergabe anzeigt, z. B. welcher Titel abgespielt wird.

Dies kann mithilfe des Eintrags playbackstatus im Abschnitt [general] aktiviert werden.

[general]
...
playbackstatus = true

Schlüsselcodes

Die DHU bietet eine Reihe von Standardschlüsselcodes, die die Tastenkombinationen simulieren, die allgemein in Fahrzeugen verfügbar sind. Der Keycode home kann beispielsweise so in der DHU-Eingabeaufforderung ausgelöst werden:

keycode home

In der folgenden Tabelle sind weitere verfügbare Schlüsselcodes aufgeführt:

Keycode	Beschreibung
home	Wechseln Sie zum Startbildschirm.
back	Zurück
call endcall	Starten oder beenden Sie einen Anruf.
search	Suche starten.
media_play_pause media_play media_pause	Medien wiedergeben oder pausieren
media_next media_previous	Zum nächsten oder vorherigen Medientrack wechseln
media	Rufe die Standard-Medien-App auf.
navigation	Standardmäßige Navigations-App aufrufen.
tel	Öffnen Sie die Standard-Telefon-App.

DHU konfigurieren

Die DHU unterstützt eine .ini-Konfigurationsdatei, um den Eingabemodus zwischen Touchscreen und Dreh-Controller zu ändern und die Framerate, Auflösung und DPI festzulegen, die die Haupteinheit vom Smartphone anfordert.

Der Standardspeicherort für die Konfigurationsdatei ist ~/.android/headunit.ini. Wenn Sie die Konfiguration des Infotainmentsystems in Ihrem System ändern möchten, können Sie diese Datei bearbeiten.

Mit dem Flag -c können Sie auch eine Konfigurationsdatei angeben, die geladen werden soll:

./desktop-head-unit -c /path/to/config.ini

Das folgende Snippet zeigt eine Beispielkonfiguration:

[general]
touch = true
touchpad = false
controller = false
instrumentcluster = false
resolution = 800x480
dpi = 160
framerate = 30
fueltypes = unleaded,electric,hydrogen
evconnectors = supercharger

Beispielkonfigurationsdateien mit verschiedenen Einstellungen für Haupteinheit, die Sie testen können, befinden sich im Ordner SDK_LOCATION/extras/google/auto/config/. Für erweiterte Anwendungsfälle können Sie sich die folgenden unterstützten Einstellungen ansehen.

Eingabekonfiguration

In der folgenden Tabelle sind die Optionen für die Eingabekonfiguration aufgeführt:

Name	Standard	Typ	Beschreibung
inputmode	default	String	Definieren Sie den Eingabemodus. Mit den Optionen touch, rotary und hybrid können Sie die Unterstützung für Touchscreen und Drehknopf aktivieren bzw. deaktivieren und je nach Bedarf Standard-Keycodes festlegen. default richtet sich nach den Optionen touch und controller.
controller	false	Boolesch	Aktiviert die Eingabe des Drehreglers. Wird ignoriert, außer inputmode ist default.
touch	true	Boolesch	Touchscreen aktivieren Wird ignoriert, es sei denn, inputmode ist default.
touchpad	false	Boolesch	Touchpad aktivieren.
touchpadnavigation	false	Boolesch	Aktiviert das Touchpad für die UI-Navigation.
touchpadtapasselect	false	Boolesch	Bei „true“ ist ein Tippen auf das Touchpad ein ausgewähltes Ereignis.
touchpaduiabsolute	false	Boolesch	Wenn touchpadnavigation den Wert true hat, kannst du festlegen, ob Berührungen als absolute oder Gesten behandelt werden sollen.

Videokonfiguration

Android Auto unterstützt drei Videoauflösungen:

• 480p (Standardeinstellung: 800 x 480)
• 720p: 1280 x 720
• 1080p: 1920 x 1080

Zur Unterstützung anderer Seitenverhältnisse kann das Infotainmentsystem bei Bedarf einen Rand zum Letterbox-Bild (Pillarbox-Format) festlegen. Für einen Bildschirm mit 1.000 × 600 Pixeln legen Sie beispielsweise die Auflösung auf 720p (1.280 × 720) und einen marginwidth von 280 und einen marginheight von 120 fest. Dies hat den Effekt, dass am linken und rechten Rand ein Rand von 140 Pixel und oben und unten ein Rand von 60 Pixeln hinzugefügt wird.

Die folgende Beispielkonfiguration emuliert einen typischen 6"-Bildschirm (750 x 450):

[general]
...
resolution = 800x480
marginwidth = 50
marginheight = 30

Und die folgende Beispielkonfiguration emuliert einen sehr breiten Bildschirm:

[general]
...
resolution = 1280x720
marginwidth = 0
marginheight = 220

In der folgenden Tabelle sind weitere Optionen für die Videokonfiguration aufgeführt:

Name	Standard	Typ	Beschreibung
resolution	800x480	String	Eine der folgenden Optionen: 800x480, 1280x720, 1920x1080.
dpi	160	Ganzzahl
normalizedpi	false	Boolesch	Bei true die DHU-Fenstergröße verringern, um größere DPI-Werte zu berücksichtigen. Wenn false, größere DPI-Werte zu größeren Fenstern führen, was keine realen Bildschirme imitiert, aber bei der Prüfung visueller Inhalte hilft.
realdpi	160	Ganzzahl	Wird in der Videokonfiguration verwendet.
framerate	30	Ganzzahl	Wird in der Videokonfiguration verwendet.
marginheight	0	Ganzzahl	Wird in der Videokonfiguration verwendet.
marginwidth	0	Ganzzahl	Wird in der Videokonfiguration verwendet.
margins	0,0,0,0	String	Wird in der Videokonfiguration verwendet. Überschreibt marginwidth und marginheight, sofern vorhanden. Das Format ist „oben“, „unten“, „links“ und „rechts“.
contentinsets	0,0,0,0	String	Wird in der Videokonfiguration verwendet. Das Format ist „oben“, „unten“, „links“ und „rechts“.
stablecontentinsets	0,0,0,0	String	Wird in der Videokonfiguration verwendet. Die Standardeinstellung ist der Wert contentinsets. Das Format ist „oben“, „unten“, „links“ und „rechts“.
cropmargins	false	Boolesch	Wenn margins, marginheight oder marginwidth angegeben ist, werden die Ränder aus dem angezeigten Video durch einen true-Wert für diese Einstellung entfernt. Dies spiegelt besser wider, was der Endnutzer sieht.
pixelaspectratio	1.0	Frei schwebend	Wird in der Videokonfiguration verwendet.

Sensorkonfiguration

Um Sensordaten zu simulieren und an Android Auto zu senden, müssen die entsprechenden Sensoren über die folgenden Optionen aktiviert werden. Wenn ein Sensor nicht aktiviert ist, werden alle Daten, die mithilfe der DHU-Befehle für diesen Sensor gesendet werden, ignoriert. Diese Konfiguration muss in einen [sensors]-Abschnitt und nicht in den [general]-Abschnitt eingefügt werden, der für die meisten anderen Konfigurationen verwendet wird.

[general]
touch = true
...

[sensors]
location = true
fuel = true
...

Name	Standard	Typ	Beschreibung
accelerometer	false	Boolesch	Aktiviert die Sensordaten des Beschleunigungsmessers.
compass	false	Boolesch	Kompasssensordaten aktivieren.
driving_status	false	Boolesch	Fahrstatus-Sensordaten aktivieren.
fuel	false	Boolesch	Kraftstoffsensordaten aktivieren.
gyroscope	false	Boolesch	Gyroskopsensordaten aktivieren.
location	false	Boolesch	Daten von Fahrzeugstandortsensoren aktivieren.
night_mode	false	Boolesch	Nachtmodus-Sensordaten aktivieren.
odometer	false	Boolesch	Daten des Kilometerstandssensors aktivieren.
speed	false	Boolesch	Geschwindigkeitssensordaten aktivieren.
toll_card	false	Boolesch	Sensordaten für Mautkarten aktivieren.
gps_satellite	false	Boolesch	GPS-Satellitensensordaten aktivieren.
parking_brake	false	Boolesch	Daten zum Feststellbremssensor aktivieren.
gear	false	Boolesch	Getriebesensordaten aktivieren.

Verschiedene Konfigurationsoptionen

In der folgenden Tabelle sind weitere Konfigurationsoptionen aufgeführt:

Name	Standard	Typ	Beschreibung
instrumentcluster	false	Boolesch	Kombi-Instrument aktivieren. Fügt der Benutzeroberfläche ein Fenster für die Navigation und den Telefonstatus hinzu.
navcluster	false	Boolesch	Kombi-Instrument aktivieren. Fügt der UI ein Fenster für die Anzeige des Navigationsstatus hinzu.
phonecluster	false	Boolesch	Kombi-Instrument aktivieren. Fügt der Benutzeroberfläche ein Fenster mit dem Telefonstatus hinzu.
playbackstatus	false	Boolesch	Wiedergabestatus aktivieren Fügt der UI ein Fenster hinzu, in dem Meldungen zum Wiedergabestatus angezeigt werden können.
driverposition	left	String	Entweder left, center oder right.
windowleft		Ganzzahl	Legen Sie die linke Position des Hauptfensters fest.
windowtop		Ganzzahl	Legen Sie die oberste Position des Hauptfensters fest.
fueltypes	unleaded	Strings	Eines oder mehrere der folgenden Elemente in einer durch Kommas getrennten Liste: unleaded leaded diesel-1 diesel-2 biodiesel e85 lpg cng lng hydrogen electric other unknown
evconnectors		Strings	Null oder mehr der folgenden Elemente in einer durch Kommas getrennten Liste: j1772 mennekes chademo combo-1 combo-2 roadster hpwc gbt supercharger other unknown Nur festgelegt, wenn fueltypes electric enthält.

Fehlerbehebung

Manchmal wird beim ersten Verbinden ein leerer Bildschirm angezeigt. So können Sie das Problem umgehen:

1. Schließen Sie die DHU.
2. Führen Sie Schritt 5 aus, der unter DHU ausführen beschrieben wird, um den Head Unit-Server zu beenden und neu zu starten.
3. Starten Sie die DHU noch einmal.
4. Gewähren Sie alle zusätzlichen Berechtigungen, die auf dem Smartphone-Display angefordert werden. Die DHU wird möglicherweise noch einmal heruntergefahren.
5. Starten Sie die DHU neu, falls erforderlich.