DiPlay 需要 ADB 嗎？基礎 CarPlay 與可選 BYD 功能
逐項確認權限
| 功能 | ADB 要求 | 範圍 |
|---|---|---|
| 基礎 USB／無線 CarPlay | 不要求 | 普通應用程式權限，以及相容的車載系統硬體 |
| 已驗證抬頭顯示 HUD | 不要求執行時啟動指令碼 | 準確原廠韌體／接收服務及地圖中繼資料 |
| 基礎儀表地圖 | 是否需要取決於具體設定 | 應用程式可見投影顯示及受支援韌體 |
| DiLink 5.1 自動主題／卡片跟隨 | 受影響韌體須一次性 Usage Access 授權 | 使用當前安裝檔顯示的命令 |
| DiLink 5.0 地圖流暫停／電池 | 可選車載系統 ADB | 受支援廠商屬性及 Check ADB access |
| 0.2.8 輪速／停車影片 | 可選車載系統 ADB | 預設關閉；隧道未驗證；影片僅 P 擋 |
| 儀表歌曲／歌手／播放狀態 | 網路 ADB | 支援的 BYD 屬性；透過 Check ADB access 授權 |
| 中控浮動地圖 | 顯示在其他應用程式上層 | 可透過設定或 ADB 授權；須啟用儀表地圖 |
| 卡片只在桌面顯示 | Usage Access | 缺少時可能覆蓋其他應用程式 |
先完成什麼
先連線基礎 CarPlay，再開啟車輛整合。如果韌體要求透過 ADB 才能安裝 APK，這是安裝限制，而不是 DiPlay 執行要求。
自動地圖引導會顯示當前安裝檔的命令。HUD Test 套件命令不能直接視為公開版本命令。
公開套件指令：adb shell appops set com.shihab.diplay SYSTEM_ALERT_WINDOW allow；adb shell appops set com.shihab.diplay GET_USAGE_STATS allow。測試套件使用 com.shihab.diplay.hudtest，執行前核對實際安裝套件名稱。
進階功能的限制
可選車載系統 ADB 使用本機 5555 埠 adbd，需從 Check ADB access 明確觸發金鑰許可，不支援 TLS 無線除錯配對。停車後按需啟用。
電池功能需要在識別階段有資料；連線後資料才就緒時，使用 Check ADB access／Apply and reconnect。輪速資料可傳送不代表隧道定位已驗證。停車影片需要有效擋位讀取，離開 P 擋即關閉。
網路 ADB 電池讀取依車輛協定選擇 CAN／CANFD。新增可儲存的桌面地圖鏡像顯示／隱藏開關，不關閉儀表地圖（PR #123／#133）。
0.2.10 的變更與複查
選用影片增加進度跳轉及前後十秒按鈕。需網路 ADB 與有效 P 檔讀數；離開 P 檔或讀數失效即關閉播放，仍不支援 FairPlay 影片（PR #129）。
上游報告 Linux 529 項測試通過，無失敗或略過；本機執行 528 項測試，有一項 macOS 綁定測試略過。簽章發布建置及 lint 通過，仍有 lint 警告。簽章與 0.2.9 一致；本次沒有新增實車驗證。
0.2.11 的變化與待驗證項目
位置設定中的「進階車輛資料」保留 DiLink 5.0 預設模式，新增明確選用的舊車機偵測。有界唯讀探測需要已授權網路 ADB；僅接受的欄位啟用對應電池、輪速與停車影片控制項（PR #158／#173）。
可選的車機內建熱點自動啟動預設關閉。在支援的 BYD 韌體上確認 DiPlay 自身套件權限，並保留熱點名稱與密碼（PR #164／#173）。
可選停車影片仍需有效 P 檔，離開 P 檔或讀值失效即關閉。無線車輛／位置資料改由 Wi-Fi iAP2 連線承擔；不能證明隧道導航採用輪速（PR #157）。
精確位置權限獲准前不回報位置；變更設定會重新連線目前工作階段。車輛控制項統一位於位置 → 進階車輛資料，獨立 BYD ADB 卡片控制熱點啟動。舊車機儲存欄位需接受後才能成為執行讀值。
0.2.12 的變化與待驗證項目
熱點啟動檢查實際 AP 介面，AirPlay 未連接時採有限重試。可選熱點自動啟動仍預設關閉；備援需韌體支援命令、已授權本機 ADB 與實際就緒狀態，不能僅以命令成功判斷（PR #229／#235）。
修正 Apple 裝置的 USB 接入匹配。可選無障礙輔助僅確認 DiPlay 自身的系統 USB 授權對話框，排除其他應用程式與對話框；仍需正常 USB 授權（PR #170／#224）。
符合條件的 Android 10 熱點／Wi-Fi Direct 工作階段可選用已授權本機 ADB 暫停用戶端掃描。同一區域網路模式除外；暫停時無法自動加入已儲存網路。復原標記與重試會恢復掃描，重新開啟也會復原；不是普遍卡頓修正（PR #225）。
虛擬 16:9 地圖支援無實體儀表的相容桌面。實驗性 DiLink 3／4 路徑加入限定儀表處理與可重試原廠狀態復原，DiLink 5／5.1 仍優先。未宣稱 DiLink 3 擋風玻璃 HUD 或已驗證 DiLink 4 HUD 配置（PR #171／#182／#187／#213）。
需複測修復後的 DiLink 3／4 儀表路徑、掃描復原、方向盤模式與韌體相關熱點啟動。普遍卡頓、通話／Siri／麥克風、iOS 15 啟動與顏色／主題問題仍需目前裝置新證據。
0.2.13 的變更與驗證範圍
無線優先使用可用 IPv4，以限定介面的 IPv6 備援；自動頻道不保證頻段或消除卡頓。介面 mDNS 不再依賴未使用的 NSD 服務；交接備援必須已有影像幀。實驗性熱點加入修復要求 Android 13+、使用者設定的純 5 GHz 熱點、支援的 API、已授權本機 ADB，並在中斷連線後明確確認（PR #251/#258/#283/#309/#313）。
改善 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 檢查；貢獻者設定不能證明完整簽章版已驗證。
本页依据公开项目文档及参考社区指南整理，保留实测边界与原始证据。资料快照不代表最新修复状态。