Android 螢幕截圖

將裝置螢幕輸出為 PNG。

用量

android screen capture [-ah] [--debug] [--device=PARAM] [--distance=PARAM] [--edge-thresh-strong=PARAM] [--edge-thresh-weak=PARAM] [--features=PARAM] [--min-area=PARAM] [--min-nested-area=PARAM] [--min-rect=PARAM] [--min-round=PARAM] [--output=PARAM] [--threshold=PARAM]

選項

  • -a,--annotate - 偵測螢幕截圖中的 UI 元素，並以編號的邊界方塊標示 (#1、#2 等)。這樣一來，AI 代理程式和指令碼就能透過標籤編號參照畫面上的 UI 元素，不必手動計算像素座標。
  • --debug - 輸出參數微調的中間特徵偵測步驟。
  • --device=PARAM - 裝置序號。
  • --distance=PARAM - 搭配 --annotate 使用。將偵測到的形狀合併為 UI 功能 (MIN_EUCLIDEAN 或 MIN_ANISOTROPIC) 的距離指標。MIN_ANISOTROPIC 會比 x 軸上的水平間隔更重視 y 軸上的垂直間隔 (預設值：MIN_EUCLIDEAN)。
  • --edge-thresh-strong=PARAM - 搭配 --annotate 使用。邊緣偵測的強烈門檻 (0 至 1)。如果系統忽略幾乎無法偵測的邊緣，請降低這個值；如果偵測結果過於雜亂，請提高這個值 (預設值：0.1)。
  • --edge-thresh-weak=PARAM - 搭配 --annotate 使用。邊緣偵測的門檻較低 (0 至 1)。如果系統忽略幾乎無法偵測的邊緣，請降低這個值；如果偵測結果過於雜亂，請提高這個值 (預設值：0.05)。
  • --features=PARAM - 搭配 --annotate 使用。此演算法用於將偵測到的形狀分組為 UI 功能 (GREEDY 或 FH)。GREEDY 會將距離小於 --threshold 的形狀合併為單一功能。FH 會使用 --threshold 做為區隔比例參數，值越高產生的特徵越少且越大，值越低產生的特徵越多且越小 (預設值：FH)。
  • -h,--help：顯示指定指令的說明訊息。
  • --min-area=PARAM - 搭配 --annotate 使用。dp² 中形狀的最小面積，用於特徵偵測。系統會忽略小於這個門檻的形狀 (預設值：5.0)。
  • --min-nested-area=PARAM - 搭配 --annotate 使用。如要保留巢狀子項特徵，dp² 中必須有最低面積的父項特徵。如果圖示內的小細節被標示為個別元素，請提高這個值 (預設值：3600.0)。
  • --min-rect=PARAM - 搭配 --annotate 使用。形狀面積與軸對齊定界框面積的最小比率。系統會忽略 --min-rect 和 --min-round 下方的形狀 (預設為 0.2)。
  • --min-round=PARAM - 搭配 --annotate 使用。形狀圓度下限 (4 * PI * area / perimeter^2，其中 1.0 是正圓)。系統會忽略 --min-rect 和 --min-round 下方的形狀 (預設為 0.2)。
  • -o,--output=PARAM - 將螢幕截圖寫入指定的檔案或目錄。
  • --threshold=PARAM - 搭配 --annotate 使用。傳遞至 --features 中指定演算法的分組門檻 (預設值：15)。

android 選項：

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

說明

android screen capture 會擷取已連線 Android 裝置或模擬器的 PNG 螢幕截圖。

如果省略 -o, --output，原始 PNG 圖片位元組會寫入標準輸出。

標註 UI 元素 (-a, --annotate)

傳遞 -a, --annotate，即可偵測畫面上的 UI 元素，並在每個偵測到的元素周圍疊加編號的周框 (#1、#2 等)。輸出 PNG 時，系統也會嵌入定界框中繼資料，因此 android screen resolve 可以將 #N 標籤轉換為螢幕 (x, y) 座標。

您可以使用 --edge-thresh-weak、--edge-thresh-strong、--min-area、--min-rect、--min-round、--min-nested-area、--distance、--features 和 --threshold 等選項，微調偵測靈敏度。

範例

將已連結裝置的螢幕截圖儲存至 ui.png：

android screen capture --output=ui.png

擷取附註的螢幕截圖，並標示出視覺目標的 UI 邊界方塊：

android screen capture --annotate --output=ui_annotated.png