本頁面由 Cloud Translation API 翻譯而成。

使用電腦版車用運算主機進行測試

電腦車用運算主機 (DHU) 可讓開發機器模擬 Android Auto 車用運算主機，方便您執行及測試 Android Auto 應用程式。DHU 可執行於 Windows、macOS 和 Linux 系統。

安裝 DHU 後，您可以依照「執行 DHU」所述，使用其中一種支援的連線機制將行動裝置連線至 DHU，藉此測試 Android Auto 應用程式。

如要回報錯誤或要求 DHU 相關功能，請使用此 Issue Tracker。

安裝 DHU

請按照下列步驟在開發機器上安裝 DHU：

按照設定裝置端開發人員選項的說明，在搭載 Android 6.0 (API 級別 23) 以上版本的行動裝置上啟用開發人員模式。
在裝置上編譯及安裝應用程式。
在裝置上安裝 Android Auto。如果已安裝 Android Auto，請確認使用的是最新版本。
請在 Android Studio 中開啟 SDK Manager，接著前往「SDK tools」分頁下載「Android Auto Desktop Head Unit Emulator」套件。

SDK Manager 顯示 DHU 2.0 版

DHU 會安裝在 SDK_LOCATION/extras/google/auto/ 目錄中。

如果作業系統是 Linux 或 macOS，請在該目錄中執行下列指令，確保 DHU 二進位檔能順利執行：
```
chmod +x ./desktop-head-unit
```

Linux 適用的其他步驟

如果是在 Linux 系統上執行 DHU 2.x 版，則需要安裝其他程式庫。DHU 二進位檔需要 GLIBC 2.32 以上版本。如要查看 GLIBC 版本的系統，請執行下列指令：

ldd --version

如果是 2.32 以下版本，請更新至 GLIBC 2.32 以上版本。為此，您可能需要將 OS 升級至與 GLIBC 2.32 以上版本相容的版本。

此外，您還必須安裝 libc++1 和 libc++abi1 程式庫。安裝程序會因 Linux 發行版而異，例如，如果使用 Debian Linux 發行版本，則可以使用此指令來安裝程式庫：

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

安裝 DHU 的預先發布版

如要存取 DHU 的預先發布版，您可以使用 Android Studio 的預先發布版或是變更更新管道，以將現有的 Android Studio 安裝更新到 Beta 版。

執行 DHU

安裝 DHU 後，您可以透過 USB 連接行動裝置與工作站，測試 Android Auto 應用程式。請使用配件模式 (DHU 2.x 的建議做法) 或 ADB 通道，將行動裝置連線至開發機器，即可執行 DHU。

使用配件模式建立連線

Android Auto 支援透過 Android Open Accessory (AOA) 通訊協定連線至 DHU 2.x 版。請輸入下列指令：

./desktop-head-unit --usb

根據預設，DHU 會掃描可用 USB 裝置的清單，並嘗試連線至第一部相容的裝置。如要指定特定裝置，請在 --usb 指令中加入裝置 ID，如下所示：

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

使用 ADB 通道建立連線

這種方法需要透過 Android Debug Bridge (adb)，設定與 Android Auto 車用運算主機伺服器的連線。請按照下列步驟，設定通道及執行 DHU：

啟用 Android Auto 開發人員模式 (如果尚未啟用)。
如果車用運算主機伺服器仍未執行，請開啟溢位選單，然後選取「啟動車用運算主機伺服器」，如圖 1 所示。

在裝置上，通知區會顯示前景服務，說明伺服器正在執行，如圖 2 所示。

圖 1。包含開發人員選項的內容選單。

圖 2。說明車用運算主機伺服器正在執行的通知。
在 Android Auto 應用程式中，輕觸「設定」頂端附近的「先前連線的車輛」，並確認已啟用「在 Android Auto 中新增車輛」。
使用 USB 連接行動裝置和開發機器。
確認行動裝置螢幕已解鎖，以便啟動 DHU。
在開發機器上執行下列 adb 指令，將通訊端連線自開發機器的通訊埠 5277，轉送至 Android 裝置上相同編號的通訊埠。這個設定可讓 DHU 透過 TCP 通訊端，連線至在行動裝置上執行的車用運算主機伺服器。
```
adb forward tcp:5277 tcp:5277
```
執行指令 desktop-head-unit.exe (Windows)，或從 SDK_LOCATION/extras/google/auto/ 目錄執行 ./desktop-head-unit (macOS 或 Linux)，即可啟動 DHU。
```
cd SDK_LOCATION/extras/google/auto
desktop-head-unit.exe # Windows
./desktop-head-unit # macOS or Linux
```

DHU 在開發機器上執行

如果是首次進行行動裝置與 DHU 的連線，請查看行動裝置螢幕，以接受服務條款，並視情況調整權限設定。

啟動 DHU 後，即可使用 DHU 主控台指令執行以及測試應用程式。

指令列選項

車用運算主機伺服器會透過預設通訊埠 5277 進行連線。如要覆寫主機或通訊埠，請使用 --adb=<[localhost:]port> 標記，如以下範例所示：

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

根據預設，DHU 會模擬與 Android Auto 相容的車用運算主機，並提供觸控螢幕使用者介面。如要模擬使用者輕觸動作，請使用滑鼠點選 DHU。如要模擬採用旋轉控制器做為輸入方式的車用運算主機，您可以使用 -i rotary 標記，如以下範例所示：

./desktop-head-unit -i controller

DHU 使用旋轉控制器模式時，即可使用鍵盤快捷鍵模擬控制器作業。詳情請參閱「旋轉控制器」一節。在旋轉控制器模式中，DHU 會忽略滑鼠點選動作。您必須透過模擬的旋轉控制器作業，才能操作 Android Auto。

下表列出 DHU 的其他指令列選項：

選項	說明
`-c`、`--config=FILE`	使用指定的設定 `.ini` 檔。詳情請參閱「設定 DHU」部分。
`-i`、`--input=INPUT`	使用指定的輸入模式，可以是以下任一種：`touch`、`rotary` 或 `hybrid`。
`-a`、`--adb=HOSTPORT`	使用 ADB 傳輸。選填的 `host:port` 或 `port`。預設值為通訊埠 5277。
`-a`、`--usb=DEVICE_ID`	使用 USB AOA 傳輸。選用 `DEVICE_ID`。
`-v`、`--version`	顯示版本資訊。
`-l`、`--licenses`	顯示開放原始碼授權
`-h`、`--headless`	以無頭模式執行，無 UI。
`-t`、`--always_show_window_on_top`	在其他視窗上方顯示 DHU 視窗 (預設為關閉)
`-?`、`--help`	顯示說明資訊。

DHU 使用指南

本節將說明 DHU 支援的功能和使用方式。

請在先前用於啟動 DHU 的終端機視窗中輸入指令。只要使用 ; 分隔指令，即可在同一行執行多個指令。

系統

指令	索引鍵	說明
`help [command]`		顯示完整指令集。如有指定的指令名稱，就會顯示該指令的說明。
`quit` `exit`	`Alt+Q`	結束車用運算主機。
`sleep [seconds]`		休眠一秒鐘。如有指定的延遲時間，休眠長度則為許多 `seconds`。這可用來為包含 `./desktop-head-unit < script.txt` 的車用運算主機編寫指令碼，例如 CI 環境。
`screenshot filename.png`		將螢幕截圖儲存至 `filename.png.`。
`licenses`		顯示 DHU 所使用程式庫的授權。
`keycode keycode`		從「Keycodes」 (按鍵碼) 區所列名單中，擇一作為 `keycode` 傳送。

觸控和觸控板

在已啟用觸控功能或觸控板的情況下，螢幕視窗 (適用於觸控功能) 或觸控板視窗 (適用於觸控板) 中的點選動作皆會註冊為觸控事件。

針對觸控功能，如要模擬多點觸控手勢，請按一下滑鼠右鍵指定第一指的位置，然後點選並按住右鍵來代表第二指。雙指的中心點保持固定；移動滑鼠即可讓它們在中心周圍旋轉、向內及向外旋轉，或是兩者並用。

若是觸控板，只要點選並按住左側按鈕，即可在畫面上的不同 UI 元素之間捲動。如要選取聚焦元素，請點選右鍵。

指令	索引鍵	說明
`tap x y`		在指定的座標模擬觸控事件。

旋轉控制器

DHU 支援旋轉控制器功能。啟用這項功能時，系統會支援以下動作：

點選 D-Pad 的上、下、左、右按鈕
順時針與逆時針旋轉
執行旋轉轉動手腕動作 (一次五個步驟)
點選控制器的向下和返回按鈕

下表為指令和按鍵繫結。

滑鼠滾輪會傳送 dpad rotate 指令，按一下滑鼠中間的鍵 (通常是滾輪) 則會傳送 dpad click 指令。

請注意，大多數車輛都設有觸控式螢幕。有些車輛只有旋轉控制器，有些則同時提供觸控功能和控制器。車輛也支援觸控板，可用於平移地圖和輸入文字。模擬不同的車用運算主機時，請注意這些不同的設定。

指令	索引鍵	說明
`dpad {up\|down\|left\|right}`	`方向鍵`	移動旋轉控制器。
`dpad {ur\|dl\|ul\|dr}`		移動旋轉控制器。
`dpad soft {left\|right}`	`Shift + 方向鍵`	按下某些旋轉控制器提供的側邊按鈕。
`dpad click`	`返回`	按下旋轉控制器。
`dpad back`	`Backspace`	按下部分旋轉控制器下方會提供的返回按鈕。
`dpad rotate left`	`1`	以逆時針方向轉動旋轉控制器 (左)。
`dpad rotate right`	`2`	以順時針方向轉動旋轉控制器 (右)。
`dpad flick left`	`Shift+1`	以逆時針方向快速轉動旋轉控制器。
`dpad flick right`	`Shift+2`	以順時針方向快速轉動旋轉控制器。
`dpad 0-9*#+`	`數字鍵`

麥克風

DHU 支援使用麥克風進行語音輸入，或播放預錄的語音檔案。為了方便起見，DHU 包含以下常見語音指令的音檔。這些音檔位於 SDK_LOCATION/extras/google/auto/voice/ 目錄。

檔案名稱	Text
`navhome.wav`	導航回家。
`navwork.wav`	導航到公司。
`navsoh.wav`	前往雪梨歌劇院。
`navgoogle.wav`	導航到美國加州圓形劇場園道 (Amphitheatre Parkway) 1600號。
`exitnav.wav`	結束導航。
`howlong.wav`	「需要多久才會抵達？」
`showtraffic.wav`	顯示路況。
`showalternateroute.wav`	顯示替代路線。
`pause.wav`	暫停播放音樂。
`nextturn.wav`	下次何時要轉彎？

如要在 DHU 提示中執行個別 .wav 檔案，請使用下列指令：

mic play /path/to/filename.wav

下表為其他麥克風相關指令：

指令	索引鍵	說明
`mic begin`	`M`	啟用麥克風，模擬點選方向盤按鈕的動作，然後等待來自電腦麥克風的輸入內容。
`mic play filename.wav`		啟用麥克風，然後播放指定 WAV 錄音檔。注意：您不會聽到系統播放 WAV 檔案，但會聽到 Android Auto 的回應。
`mic repeat`		重複播放最近一次與 `mic play` 搭配使用的錄音檔。
`mic reject {on\|off}`		啟用或停用針對麥克風要求的拒絕功能。如果開啟這項功能，所有麥克風要求都會遭到拒絕。

感應器

如需 DHU 模擬車輛感應器資料的變化，請使用下列指令。如要模擬感應器資料，並將資料傳送至 Android Auto，請務必在啟動 DHU 時，透過 .ini 設定檔案啟用相對應的感應器。

指令	說明
`fuel [percentage]`	將燃油量設為指定的百分比，或在沒有值傳入的情況下，停用燃油量。
`range [km]`	將範圍設為指定的公里數，或在沒有值傳入的情況下，停用範圍資料。
`lowfuel [{on\|off}]`	設定低油量警告感應器，或在沒有值傳入的情況下，停用感應器。
`accel [x] [y] [z]`	將加速計設為指定的 x、y 和 z 值 (m/s^2)，或在沒有參數傳入的情況下，取消設定加速計資料。視需要傳入 NAN 值，即可略過選用參數。
`compass bearing [pitch] [roll]`	設定指南針的指定軸承、俯仰角和旋轉角 (以度為單位)。視需要傳入 NAN 值，即可略過選用參數。
`gyro [x] [y] [z]`	將陀螺儀設為指定的 x、y 和 z 旋轉速度 (rad/s)，或在沒有參數傳入的情況下，取消設定陀螺儀資料。視需要傳入 NAN 值，即可略過選用參數。
`location lat long [accuracy] [altitude] [speed] [bearing]`	設定位置的指定經緯度值，以及選用精確度 (m)、高度 (m)、速度 (m/s) 和方位角 (以度為單位)。視需要傳入 NAN 值，即可略過選用參數。
`odometer km [current_trip_km]`	將里程表設定為指定公里數，以及選用目前行程公里數的值。
`speed [speed]`	將車輛速度設為指定的值 (m/s)，或在沒有值傳入的情況下，停用感應器。
`tollcard {insert\|remove}`	插入或移除付費卡。
`gps_satellite number_in_use [[azimuth] [elevation] [prn] [snr] [used_in_fix]]`	將 GPS 衛星感應器設為使用中的指定數值，搭配選用的方位角 (0 到 360 之間的度數)、高度 (0 到 90 之間的度數)、prn (偽隨機雜訊)、Snr (dB) 清單，並用於修正 (`true` 或 `false`)。
`parking_brake engaged`	將停車煞車感應器設為 `true` 或 `false`。
`gear gear_value`	將齒輪感應器設為指定值 (例如 `0` 代表中性、`100` 代表行車、`101` 代表停車，而 `102` 代表倒車)。

日間模式和夜間模式

DHU 可使用下列指令和按鍵繫結，模擬日間模式和夜間模式的切換情形：

指令	索引鍵	說明
`day`	`Shift+N`	啟用日間模式：高亮度、全彩。
`night`	`Ctrl+N`	啟用夜間模式：低亮度、高對比度。
`daynight` `nightday`	`N`	切換日間或夜間模式。

焦點管理

DHU 可使用下列指令，模擬 Android Auto 的焦點是否在車用運算主機上：

指令	說明
`focus video {on\|off\|toggle}`	啟用或停用車用運算主機上的視訊焦點。關閉視訊焦點後，即可模擬車用運算主機進入原生模式的情況。
`focus audio {on\|off\|toggle}`	啟用或停用車用運算主機上的音訊焦點。關閉音訊焦點後，即可模擬車用運算主機播放自己音訊來源的情況。
`focus nav {on\|off\|toggle}`	啟用或停用車用運算主機上的瀏覽焦點。關閉導覽焦點後，即可模擬車用運算主機執行自己的導航系統。

限制和行車狀態

DHU 可使用下列指令，模擬行車期間的特定限制，例如停用鍵盤和拒接來電設定：

指令	索引鍵	說明
`restrict none`	`U`	停用所有限制。
`restrict all`	`Shift+U`	啟用所有限制，例如用來模擬行車狀態。

儀表板

DHU 可模擬儀表板。這種儀表板通常位於方向盤後方，會在導航期間顯示距離或時間、下個轉彎路口的基本資訊，例如下個路口的名稱或轉彎箭頭。儀表板也會顯示有關進行中通話的資訊。

DHU 的儀表板視窗，顯示導航和通話狀態資訊

如需啟用這項功能，請使用設定檔 [general] 區段中的 instrumentcluster 項目，或者透過 navcluster 或 phonecluster 項目分別控管這兩項功能。

[general]
...
instrumentcluster = true

儀表板螢幕

部分車輛配備的儀表板螢幕可以顯示豐富的視覺資訊，例如地圖圖磚。從 DHU 2.1 版開始 (目前可透過 Android Studio Beta 版更新管道取得)，您可以在開發機器上模擬這類顯示畫面。

只要使用含有儀表板 [display] 區段的設定檔即可。[display] 區段支援的影片設定選項，與該檔案 [general] 區段中設定的主要顯示畫面相同。

...

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

您可以直接將這項設定加入現有 .ini 檔案，或是放在獨立的檔案中，並在啟動 DHU 時傳送多個設定檔，重複使用這項設定。使用多個設定檔時，指定值的較新定義會覆寫較舊定義。

# 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

媒體播放狀態

DHU 可顯示媒體播放狀態的額外資訊，例如播放中曲目的名稱。

DHU 的媒體播放狀態視窗顯示播放資訊

您可以使用 [general] 區段中的 playbackstatus 項目啟用這項功能。

[general]
...
playbackstatus = true

按鍵碼

DHU 提供一組預設按鍵碼，可模擬車輛常見的快速鍵組合。例如，DHU 提示會觸發 home 按鍵碼，如下所示：

keycode home

下表為其他可用的按鍵碼：

按鍵碼	說明
`home`	前往主畫面。
`back`	返回
`call endcall`	撥打電話或結束通話。
`search`	觸發搜尋。
`media_play_pause` `media_play` `media_pause`	播放或暫停媒體。
`media_next` `media_previous`	前往下一首或上一首媒體曲目。
`media`	前往預設媒體應用程式。
`navigation`	前往預設導航應用程式。
`tel`	前往預設電話應用程式。

設定 DHU

DHU 支援 .ini 設定檔，可變更觸控和旋轉控制器之間的輸入模式，以及設定車用運算主機向手機要求的影格速率、解析度和 DPI。

設定檔的預設位置為 ~/.android/headunit.ini。如果要在系統中變更車用運算主機的設定，請修改這個檔案。

您也可以使用 -c 標記，指定要載入的設定檔：

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

以下程式碼片段為設定範例：

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

設定檔範例位於 SDK_LOCATION/extras/google/auto/config/ 資料夾中，示範您可以測試的不同車用運算主機設定。如要進一步瞭解進階用途，請參閱以下支援的設定。

輸入設定

下表為輸入設定選項：

姓名	預設	類型	說明
`inputmode`	`default`	字串	定義輸入模式。`touch`、`rotary` 和 `hybrid` 選項可啟用或停用觸控螢幕和旋轉功能，並可視情況設定預設按鍵碼。`default` 會依循 `touch` 和 `controller` 選項。
`controller`	`false`	布林值	啟用旋轉控制器輸入功能。忽略不看，除非 `inputmode` 為 `default`。
`touch`	`true`	布林值	啟用觸控螢幕。除非 `inputmode` 為 `default`，否則會遭到忽略。
`touchpad`	`false`	布林值	啟用觸控板。
`touchpadnavigation`	`false`	布林值	啟用觸控板，即可用於 UI 導覽。
`touchpadtapasselect`	`false`	布林值	設為 true 時，輕觸觸控板將作為選取事件。
`touchpaduiabsolute`	`false`	布林值	如果 `touchpadnavigation` 為 `true`，就會設定觸控動作是否應視為絕對值或手勢。

影片設定

Android Auto 支援三種影片解析度：

480p (800x480，這是預設值)
720p (1280x720)
1080p (1920x1080)

如要支援其他顯示比例，可以視需要在車用運算主機中指定上下黑邊 (左右黑邊)。舉例來說，如要使用 1000x600 的螢幕，請將解析度設為 720p (1280x720)，並將 marginwidth 和 marginheight 分別設為 280 和 120。如此一來，左右兩側邊界就會增加 140 px，上下兩側邊界則增加 60 px。

以下範例設定模擬常見的 6 吋螢幕 (750x450)：

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

以下範例設定模擬相當寬的螢幕：

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

下表為其他影片設定選項：

姓名	預設	類型	說明
`resolution`	`800x480`	字串	只能設定為`800x480`、`1280x720` 或 `1920x1080` 之一。
`dpi`	`160`	整數
`normalizedpi`	`false`	布林值	設為 `true` 時，DHU 視窗大小就會縮減，藉此容納較大的 DPI 值。設為 `false` 時，視窗大小會隨著 DPI 值增加而放大，雖然無法模擬實際的顯示畫面，但有助於檢查影像內容。
`realdpi`	`160`	整數	用於影片設定。
`framerate`	`30`	整數	用於影片設定。
`marginheight`	`0`	整數	用於影片設定。
`marginwidth`	`0`	整數	用於影片設定。
`margins`	`0,0,0,0`	字串	用於影片設定。覆寫 `marginwidth` 和 `marginheight` (如有)。格式為上、下、左、右。
`contentinsets`	`0,0,0,0`	字串	用於影片設定。格式為上、下、左、右。
`stablecontentinsets`	`0,0,0,0`	字串	用於影片設定。預設為 `contentinsets` 的值。格式為上、下、左、右。
`cropmargins`	`false`	布林值	如果 `margins`、`marginheight` 或 `marginwidth` 有設置指定值，在此設定使用 `true` 值，則會移除播放影片中的邊界。這更能反映使用者看到的畫面。
`pixelaspectratio`	`1.0`	浮點數	用於影片設定。

感應器設定

如要模擬感應器資料，並將資料傳送至 Android Auto，請務必使用下列選項啟用相對應的感應器。如未啟用感應器，系統會忽略所有使用 DHU 指令傳送至該感應器的資料。這項設定必須設置在 [sensors] 區段，而非其他大多數設定使用的 [general] 區段。

[general]
touch = true
...

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

姓名	預設	類型	說明
`accelerometer`	`false`	布林值	啟用加速計感應器資料。
`compass`	`false`	布林值	啟用指南針感應器資料。
`driving_status`	`false`	布林值	啟用行車狀態感應器資料。
`fuel`	`false`	布林值	啟用燃料感應器資料。
`gyroscope`	`false`	布林值	啟用陀螺儀感應器資料。
`location`	`false`	布林值	啟用車輛位置感應器資料。
`night_mode`	`false`	布林值	啟用夜間模式感應器資料。
`odometer`	`false`	布林值	啟用里程計感應器資料。
`speed`	`false`	布林值	啟用速度感應器資料。
`toll_card`	`false`	布林值	啟用付費卡感應器資料。
`gps_satellite`	`false`	布林值	啟用 GPS 衛星感應器資料。
`parking_brake`	`false`	布林值	啟用停車煞車感應器資料。
`gear`	`false`	布林值	啟用齒輪感應器資料。

其他設定選項

下表為其他設定選項：

姓名	預設	類型	說明
`instrumentcluster`	`false`	布林值	啟用儀表板。新增視窗至 UI，即可顯示導航和手機狀態。
`navcluster`	`false`	布林值	啟用儀表板。新增視窗至 UI，即可顯示導航狀態。
`phonecluster`	`false`	布林值	啟用儀表板。新增視窗至UI，即可顯示手機狀態。
`playbackstatus`	`false`	布林值	啟用播放狀態。新增視窗至 UI，即可顯示播放狀態訊息。
`driverposition`	`left`	字串	只能設為以下任一種：`left`、`center` 或 `right`。
`windowleft`		整數	設定主視窗的左側位置。
`windowtop`		整數	設定主視窗的頂部位置。
`fueltypes`	`unleaded`	字串	包含下列一或多個項目，格式為以半形逗號分隔的清單： `unleaded` `leaded` `diesel-1` `diesel-2` `biodiesel` `e85` `lpg` `cng` `lng` `hydrogen` `electric` `other` `unknown`
`evconnectors`		字串	包含下列零或多個項目，格式為以半形逗號分隔的清單： `j1772` `mennekes` `chademo` `combo-1` `combo-2` `roadster` `hpwc` `gbt` `supercharger` `other` `unknown` 只有在 `fueltypes` 包含 `electric` 的情況下，才需要設定這個選項。

疑難排解

DHU 首次連線時，偶爾會顯示空白畫面。如要解決這個問題，請按照下列步驟操作：

關閉 DHU。
按照「執行 DHU」所述的步驟 5 操作，先關閉再重新啟動車用運算主機伺服器。
重新啟動 DHU。
授予手機畫面上要求的任何其他權限。DHU 可能會再次關閉。
必要時，請重新啟動 DHU。

總覽

使用 Android Automotive OS 模擬器進行測試