getevent

読み取りのみ

カーネルから生の入力イベントを流し読みします。各入力デバイスが何を報告できるかの一覧も取れます。

コマンド: adb shell getevent
コマンド: 入力とタッチ
リスク: 読み取りのみ

構文

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

フラグと引数

トークン	意味
-l	素の 16 進ではなくカーネルのラベル名を印字します。
-t	各イベントにカーネルの monotonic なタイムスタンプを付けます。
-p	流し読みせず、各デバイスの能力を印字して終了します。
/dev/input/eventN	デバイスを 1 つに絞ります。同時に各行のデバイス接頭辞が消えます。接頭辞はデバイス指定がなかったときだけ印字されるからです。

使用例

```
getevent -lp
```
すべての入力デバイスとその軸・範囲。自分で終了します。
```
getevent -lt /dev/input/event3
```
タッチパネル 1 つをタイムスタンプ付きで見ます。

出力の読み方

出力例

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

1 行 3 フィールド：イベント type、イベント code、値。値は符号なし 32 ビットの 16 進で印字され、これがここ最大の罠です。tracking id の `ffffffff` は -1、つまり「指が離れた」という合図で、符号なしとして読むと 40 億という、ごく普通の新しい接触に見えます。`SYN_REPORT` はフレームの境界です。その前は部分的なパケットで、それを描くと座標が半分だけ更新された指が表示されます。

出力フィールド

フィールド	意味
EV_ABS / EV_KEY / EV_SYN	イベントの type：絶対軸、キー、同期の印。
ABS_MT_SLOT	続く軸がどの接触を指すかを選びます。
ABS_MT_TRACKING_ID	0 以上の値で接触が始まり、`ffffffff`（-1）で終わります。
ABS_MT_POSITION_X / _Y	パネル自身の単位での接触位置。画面のピクセルではありません。
SYN_REPORT	コミット：ここまでのフレームが完成しました。
SYN_DROPPED	カーネルのキューが溢れました。溜めた状態を捨てて再同期してください。
: value v, min a, max b, fuzz f, flat l, resolution r	能力の行で、出力全体の中で唯一の 10 進の数値です。`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・カーネルのソースに突き合わせて確認しています。バージョンやメーカーで本当に挙動が変わるところは、世界の半分の端末で間違いになる数値を出す代わりに、そう書いてあります。

よくある質問

adb shell のコマンドはどう実行しますか？

端末で開発者向けオプションと USB デバッグを有効にし、ケーブルを繋いだうえで、platform-tools を入れた機械から `adb shell <コマンド>` を実行します。`adb shell` だけを実行すれば対話プロンプトが出て、接頭辞なしで打てます。スクリーンショットのようにバイナリを出力するコマンドでは `adb shell` ではなく `adb exec-out` を使ってください。素のシェルサービスは端末を割り当て、それが改行のバイトを書き換えてデータを壊します。

adb shell のコマンドに root は必要ですか？

このリファレンスにあるものには不要です。すべて `shell` ユーザーとして動き、自分の Android ユーザー向けのパッケージ管理、ほとんどの `dumpsys` サービスの読み取り、設定プロバイダへの書き込み、入力の注入、共有ストレージの読み取りができます。root が必要なのはこのリファレンスがあえて避けていること、つまり他のアプリのプライベートデータの読み取り（debuggable なビルドに対する `run-as` を除く）、システムパーティションへの書き込み、`/data/anr` の直接読み取りです。

自分の端末では出力が違って見えるのはなぜ？

Android のバージョンか、メーカーのどちらかです。一部のフラグやフィールドは特定のリリースから入ったもので、それはコマンドごとに注記しています。残りはメーカーによる改変で、いちばん影響が大きいのは `dumpsys` です。ダンプはデバッグ出力で、そのテキストはサービスの作者が最後に印字した内容そのもの、しかもメーカーはそれを変えて自分の変更をバックポートします。フィールドは位置ではなく名前で読み、見慣れない形は失敗ではなく差分として扱ってください。

端末ではなくブラウザから実行できますか？

多くのコマンドは可能です。このサイトの Web ADB ツール群は、Chromium 系のデスクトップブラウザから WebUSB で端末と話し、SDK のインストールも不要、どこにもアップロードしません。各ページは、該当するツールがあればそこへリンクしています。知っておく価値のある制限が 2 つあります。ADB インターフェイスを保持できるプログラムは同時に 1 つだけなので、デスクトップの `adb server` は先に止める必要があります。そして `adb forward` と `adb reverse` はブラウザでは一切動きません。

打つより押したい場合は、Web ADB Toolkit がこの種のコマンドをブラウザから USB 経由で実行します。あるいは全コマンドを見る。

構文