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 距離よりも近いシェイプを 1 つの機能に結合します。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