getevent

唯讀

直接從核心串流原始輸入事件，或列出每個輸入裝置能回報什麼。

指令: adb shell getevent
指令: 輸入與觸控
風險: 唯讀

語法

getevent [-l] [-t] [-p] [/dev/input/eventN]

旗標與參數

token	意義
-l	印出核心的標籤名稱而不是純十六進位。
-t	在每個事件前面加上核心的單調時間戳。
-p	不串流，改成印出每個裝置的能力後結束。
/dev/input/eventN	只看一個裝置。這同時會讓每行的裝置前綴消失，因為那個前綴只在沒指定裝置時才印。

範例

```
getevent -lp
```
每個輸入裝置及其軸與範圍。它會自己結束。
```
getevent -lt /dev/input/event3
```
帶時間戳觀察一個觸控面板。

輸出怎麼讀

輸出範例

/dev/input/event3: EV_ABS       ABS_MT_TRACKING_ID   ffffffff
/dev/input/event3: EV_SYN       SYN_REPORT           00000000

一行三個欄位：事件 type、事件 code、數值。數值是以無號 32 位元十六進位印出來的，這是這裡最大的陷阱——tracking id 的 `ffffffff` 是 -1，也就是「手指離開」的訊號，而當成無號來讀就變成四十億，看起來像一個再平常不過的新接觸點。`SYN_REPORT` 是影格邊界：在它之前的都是半份封包，畫出來會看到座標只更新一半的手指。

輸出欄位

欄位	意義
EV_ABS / EV_KEY / EV_SYN	事件 type：絕對軸、按鍵，或同步標記。
ABS_MT_SLOT	選擇接下來的軸是在描述哪一個接觸點。
ABS_MT_TRACKING_ID	非負值代表一個接觸點開始；`ffffffff`（-1）代表結束。
ABS_MT_POSITION_X / _Y	以面板自己的單位表示的接觸點位置，不是螢幕像素。
SYN_REPORT	提交：到目前為止這個影格完成了。
SYN_DROPPED	核心的佇列滿了。請丟掉累積的狀態並重新同步。
: value v, min a, max b, fuzz f, flat l, resolution r	能力那一行，也是整份輸出裡唯一的十進位數字。`max` 是含上限的，所以 0 到 1439 的軸有 1440 個位置。

版本與廠商注意事項

軸是黏著的：驅動程式只送有變化的部分，所以一根往橫向移動的手指會保留上一次的縱向位置。要累積而不是取代。
面板座標不是螢幕座標。對應方式是減掉軸的最小值，再乘上「螢幕尺寸 ÷（max − min + 1）」。那個 +1 不是硬湊的修正，而是因為最大值含上限。
某片面板相對於顯示器有沒有旋轉或鏡像安裝，是無法從軸的範圍推出來的，必須在真機上摸一個角落來確認。
加了 `-l` 之後數值可能是單字：按鍵的值會印成 UP、DOWN 或 REPEAT，tool type 會印成 MT_TOOL_FINGER、MT_TOOL_PEN 或 MT_TOOL_PALM。

這個我們有 UI

Android Sensor Tester 會透過 USB 執行這個指令並解析回應——只要 Chromium 系瀏覽器，不必安裝 SDK，也不會上傳任何東西。

開啟 Android Sensor Tester

指令	做什麼
dumpsys sensorservice	手機上的每一個感測器，含廠商、type、取樣率與批次能力，以及一段近期讀數的緩衝。
input text	把一段字串打進目前取得焦點的輸入欄位。
wm size	回報顯示器的解析度，或覆寫它，讓手機假裝自己是另一塊螢幕。

其他輸入與觸控指令

指令	做什麼
input keyevent	按下實體或虛擬按鍵——Home、Back、電源、音量、Enter。

這些行為是在撰寫 Web ADB 工具背後的解析程式時，對照 AOSP、toybox 與核心原始碼查證的。真的會因 Android 版本或廠牌而異的地方，這一頁會直接說明，而不是給你一個在半數手機上都是錯的數字。

常見問題

adb shell 指令要怎麼執行？

在手機上打開開發者選項與 USB 除錯、接上線，然後從裝了 platform-tools 的機器執行 `adb shell <指令>`——或者只執行 `adb shell` 取得互動提示字元，再直接打指令、不用前綴。如果指令會輸出二進位資料（例如截圖），請改用 `adb exec-out` 而不是 `adb shell`：單純的 shell 服務會配一個終端機，而它會改寫換行位元組並毀掉資料。

adb shell 指令需要 root 嗎？

這份參考裡的都不用。它們以 `shell` 使用者身分執行，可以針對自己的 Android 使用者管理套件、讀取大多數 `dumpsys` 服務、寫入設定提供者、注入輸入，以及讀取共用儲存空間。需要 root 的是這份參考刻意避開的事：讀取其他 app 的私有資料（除了對可除錯版本使用 `run-as`）、寫入系統分割區，或直接讀 `/data/anr`。

為什麼在我的手機上輸出看起來不一樣？

不是 Android 版本就是廠商。有些旗標與欄位是從特定版本才有的，那些都在各指令頁註明了。其餘是廠商改動，而受影響最深的是 `dumpsys`：一份 dump 是除錯輸出，它的文字就是那個服務的作者最後印了什麼，而廠商既會改它也會把改動往回移植。請用名稱而不是位置來讀欄位，並把沒見過的格式當成差異而不是失敗。

可以用瀏覽器而不是終端機來跑嗎？

很多指令可以——本站的 Web ADB 工具從 Chromium 系桌面瀏覽器透過 WebUSB 和手機對話，不必安裝 SDK，也不會上傳任何東西。每一頁在有對應工具時都會連過去。有兩個限制值得知道：同一時間只有一個程式能持有 ADB 介面，所以桌面的 `adb server` 要先停掉；而 `adb forward` 與 `adb reverse` 在瀏覽器裡完全無法運作。

比較想按而不是打字？Web ADB Toolkit 會從瀏覽器透過 USB 執行這類指令。或者瀏覽全部指令。

語法