在 Android RetroArch 同時使用觸控 overlay 與實體控制器
先關閉 overlay 驗證實體控制器，再拔除控制器驗證 overlay。兩者重新啟用後，決定 overlay 要保持顯示、顯示實體輸入，或用僅限核心／遊戲的 override 隱藏。兩者都進入 RetroArch 輸入路徑，但圖像、觸控區、自動設定與核心 remap 是不同層。
請依此順序操作
- 01
記錄 RetroArch 套件與版本、核心、控制器名稱和連線、overlay preset、方向與目前設定路徑。
- 02
關閉 overlay，重新連線控制器，確認自動設定訊息，測試一款合法遊戲的必要輸入與選單操作。
- 03
拔除控制器，啟用 overlay，測試可見按鈕、觸控區、多點觸控、旋轉與返回選單。
- 04
重新連線控制器，確認一次實體按鍵只產生一次遊戲動作，未觸碰的 overlay 按鈕不會啟動。
- 05
選擇顯示方式：保留觸控、調整透明度、顯示實體輸入，或儲存隱藏 overlay 的最小核心／遊戲 override。
- 06
完整重啟同一遊戲，再測試另一款，確認範圍、hotkey、對應與觸控版面沒有外溢。
診斷表
| 症狀 | 可能層級 | 下一步檢查 |
|---|---|---|
| 控制器正常；觸控失效 | Preset、觸控區或方向 | 單獨測試 overlay |
| 觸控正常；控制器失效 | Android 偵測或自動設定 | 單獨測試控制器 |
| 按一次出現兩個動作 | 重複 bind、hotkey 或 remap | 檢查 RetroPad 與 remap |
| 重啟後 overlay 回來 | Override 範圍或路徑 | 檢查目前設定 |
Overlay 同時是圖像與輸入地圖
Libretro overlay 由圖像和觸控區設定組成。看得到 PNG 不代表觸控區、多點觸控、縮放或方向正確。
先在沒有控制器時測試，將觸控幾何與 Android 裝置列舉、控制器設定檔分開。
實體控制器會經過 RetroPad
RetroArch 以自動設定或手動 bind 將硬體對應至虛擬 RetroPad，再由核心／遊戲 remap 改變機器收到的輸入。
不要為修控制器編輯觸控區，也不要為修幾何替換正常設定檔。儲存前先記錄故障層。
儲存範圍最小的顯示規則
固定使用控制器的機台可用核心／遊戲 override 隱藏 overlay，而不刪除手機的全域觸控設定。
保留選單入口與擁有者復原路徑；若沒有控制器或 hotkey，隱藏 overlay 會讓執行中的模擬看似卡住。
控制器與 overlay 設定不會授權遊戲或第三方圖像。僅使用有權使用與散布的 ROM、BIOS、CHD、圖像、音效及設定檔。