android screen resolve

以視覺方式指定 UI 元素。將註解螢幕截圖中的定界框座標代入字串,並將所有 #N 例項替換為標示 N 的定界框中心座標。

用量

android screen resolve [-h] [--screenshot=PARAM] [--string=PARAM]

選項

  • -h,--help:顯示指定指令的說明訊息。
  • --screenshot=PARAM - 使用 android screen capture --annotate 擷取的螢幕截圖。
  • --string=PARAM - 要代入座標的字串。

android 選項:

  • --sdk=PARAM - Android SDK 的路徑。
  • -v,--verbose - 啟用詳細輸出功能,以利進行疑難排解。
  • -V,--version - 列印版本資訊並結束。

說明

android screen resolve 會將註解螢幕截圖 (使用 android screen capture --annotate 擷取) 中的視覺標籤預留位置 (#N) 轉譯為對應的畫面中心座標 (x y)。

這樣一來,AI 代理和自動化指令碼就能參照註解圖片中的編號標籤,產生 adb shell input 指令 (例如輕觸和滑動),不必手動計算像素座標。

範例

如果 ui.png 中的標籤 5 以座標 (500, 1000) 為中心,則執行:

android screen resolve --screenshot=ui.png --string="input tap #5"

輸出 input tap 500 1000。