DiPlay 比亞迪 HUD 與儀表：韌體、地圖與 ADB

抬頭顯示 HUD

已驗證 DiLink 5.1／Android 13 指紋為 BYD-AUTO/IVI/IVI:13/TP1A.220624.014/eng.build20260722.221155:user/release-keys。還核對原廠接收服務版本與證書，不能由此推斷其他韌體已啟用。

地圖應用程式必須提供結構化導航中繼資料。已有箭頭、下一轉向距離與道路名的實車確認，但不是全部地圖應用程式均受支援。

CarPlay 儀表地圖

1. 在支援的韌體開啟 Settings → BYD navigation，啟用 CarPlay map on dashboard。只有應用程式能看到儀表投影顯示時才出現開關。
2. 實測 DiLink 5.0／Android 12 中，在儀表方向盤選單選擇 Full screen navi 或 Small screen navi。Turn on by navi 只顯示箭頭。
3. 準確 DiLink 5.1 配置可使用 Automatic map setup 設定可選主題／卡片跟隨。執行應用程式為當前安裝檔顯示的命令，再點擊 Check and enable；基礎連線不依賴該權限。

可見性與殘留導航

DiPlay 在背景執行時可在中控顯示懸浮地圖，支援拖曳與雙指縮放。需啟用儀表地圖並授予懸浮視窗權限；使用情況存取權限可將其限制在主畫面。

路線結束、斷連、關閉輸出和過期導航會清理 HUD。強制停止／結束程序可能讓最後一條指示殘留，直到下次啟動。不能把殘留指示當成實時路線；一次只執行一個畫面連動應用程式。

0.2.9 地圖、歌曲與小工具

儀表歌曲顯示需要網路 ADB。導航小工具需要支援標準 Android 小工具的啟動器，比亞迪原生主畫面不接受任意 Android 小工具。

可選即時地圖分享及開發者啟動器範例要求 Android 11+。分享預設關閉，啟用後任何本機應用程式都可要求地圖。

選擇桌面顯示方式

沒有卡片：檢查開關、浮動視窗權限、CarPlay 是否連線、儀表地圖及目前是否在桌面。覆蓋所有應用程式表示缺少 Usage Access。第三方桌面須設為預設桌面。嵌入地圖回覆 disabled 時檢查分享開關，顯示 waiting 時檢查 CarPlay／儀表串流；桌面嵌入地圖時浮動卡片會隱藏。

即時地圖分享預設關閉；啟用後，任何本機應用程式都能請求地圖。關閉分享會立即釋放既有嵌入地圖；重新啟用需要桌面傳送新的 ATTACH，舊檢視不會自動重新連線。DiPlay 重新啟動後也需要重新整合。

1. 導航小工具：在支援的桌面小工具清單新增 CarPlay navigation。安裝後先開啟一次 DiPlay；未導航時顯示 No route 屬正常狀態。
2. 浮動地圖：啟用 CarPlay map on instrument cluster 和 Dashboard map on the centre screen，授予「顯示在其他應用程式上層」及 Usage Access，連線 CarPlay 後返回桌面。輕點進入 CarPlay，拖曳移動，雙指縮放。
3. 嵌入地圖：在 Android 11+ 使用已整合 DiPlay 的桌面，啟用 Share the live map with other launchers 和儀表地圖，由桌面請求連線。原始碼範例供開發者參考，不是 APK 內建桌面。

• DiPlay 需要 ADB 嗎？基礎 CarPlay 與可選 BYD 功能

0.2.10 的變更與複查

網路 ADB 電池讀取依車輛協定選擇 CAN／CANFD。新增可儲存的桌面地圖鏡像顯示／隱藏開關，不關閉儀表地圖（PR #123／#133）。

CarPlay 歌曲資訊、播放進度與縮小後的專輯封面透過 Android 媒體工作階段提供給相容桌面（PR #82）。

上游報告 Linux 529 項測試通過，無失敗或略過；本機執行 528 項測試，有一項 macOS 綁定測試略過。簽章發布建置及 lint 通過，仍有 lint 警告。簽章與 0.2.9 一致；本次沒有新增實車驗證。

0.2.11 的變化與待驗證項目

自訂儀表轉向卡片提供三種大小，位置以 2% 調整。未知箭頭留白，過期導航清除；iPhone 原始影片中的轉向卡片無法獨立移動（PR #155）。

歌曲增量更新省略歌手時保留原歌手，不再反覆發布未變更的資訊／封面。Android 9 音訊 API 修正解決具體相容性缺陷，不能證明 #163 的所有原因皆已修復（PR #161／#162／#173）。

需於實際裝置檢查遙控／旋鈕、轉向卡片位置、舊車機欄位與 ADB 拒絕／失聯、熱點自動啟動、僅限本應用程式的有線網路、頻道選擇、重新連線與長時間音樂播放。

0.2.12 的變化與待驗證項目

虛擬 16:9 地圖支援無實體儀表的相容桌面。實驗性 DiLink 3／4 路徑加入限定儀表處理與可重試原廠狀態復原，DiLink 5／5.1 仍優先。未宣稱 DiLink 3 擋風玻璃 HUD 或已驗證 DiLink 4 HUD 配置（PR #171／#182／#187／#213）。

自訂轉向卡片新增 30%–95% 大小、透明度與手機提供的到達資訊。未知／過期導航會清除。支援的儀表內容可即時切換並核對送達，不相容布局仍需重新連線（PR #193／#232）。

僅歌曲變更時顯示的卡片展示新資訊五秒，並保護計時器歸屬。新封面等待期間保留舊封面，確認傳輸失敗後清除過期封面；未完成傳輸沒有新增逾時（PR #215／#228）。

需複測修復後的 DiLink 3／4 儀表路徑、掃描復原、方向盤模式與韌體相關熱點啟動。普遍卡頓、通話／Siri／麥克風、iOS 15 啟動與顏色／主題問題仍需目前裝置新證據。

0.2.13 的變更與驗證範圍

固定 Dock 位置可即時切換，切入或切出自動模式仍需重新連線。可選方形畫布旋轉及分割視窗保留影像／觸控映射，但增加解碼負載。實驗性側欄預設關閉，旋轉或分割畫面變化時關閉（PR #245/#246/#277/#284）。

改善 DiLink 4 原生儀表投放和畫面控制；貢獻者確認僅涵蓋 2022 海豹／DiLink 4／Android 10。DiLink 3 投放核對回覆並保護復原；轉向卡仍兩分鐘到期，新增 125% 地圖比例及限定電池／方向盤服務復原。DiLink 3 通話按鍵與儀表通話卡獨立且預設關閉，復原使用原廠閒置值，並非先前狀態快照（PR #243/#260/#265/#285/#296/#297/#304/#306）。

需在目標韌體重測 Android 9 P2P、車型專屬儀表復原、熱點修復及通話／音訊。音樂緩衝仍需實機暫停、跳轉、導航、通話及 Siri 檢查；貢獻者設定不能證明完整簽章版已驗證。