Android-Bildschirmaufnahme

Gibt den Gerätebildschirm als PNG aus.

Nutzung

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]

Optionen

  • -a,--annotate: Erkennt und kennzeichnet UI-Elemente auf dem Screenshot mit nummerierten Begrenzungsrahmen (#1, #2 usw.). So können KI-Agents und ‑Scripts anhand der Labelnummer auf UI-Elemente auf dem Bildschirm verweisen, anstatt Pixelkoordinaten manuell zu berechnen.
  • --debug: Gibt Zwischenschritte der Feature-Erkennung für die Parameteroptimierung aus.
  • --device=PARAM – Die Seriennummer des Geräts.
  • --distance=PARAM – Wird mit --annotate verwendet. Distanzmesswert zum Kombinieren erkannter Formen in UI-Elemente (MIN_EUCLIDEAN oder MIN_ANISOTROPIC). Bei MIN_ANISOTROPIC wird die vertikale Trennung auf der Y-Achse stärker gewichtet als die horizontale Trennung auf der X-Achse (Standard: MIN_EUCLIDEAN).
  • --edge-thresh-strong=PARAM – Wird mit --annotate verwendet. Hoher Grenzwert (0 bis 1) für die Kantenerkennung. Verringern Sie diesen Wert, wenn kaum erkennbare Kanten ignoriert werden, oder erhöhen Sie ihn, wenn die Erkennung zu viele Störungen aufweist (Standardwert: 0.1).
  • --edge-thresh-weak=PARAM – Wird mit --annotate verwendet. Schwacher Grenzwert (0 bis 1) für die Kantenerkennung. Verringern Sie diesen Wert, wenn kaum erkennbare Kanten ignoriert werden, oder erhöhen Sie ihn, wenn die Erkennung zu viele Störungen aufweist (Standardwert: 0.05).
  • --features=PARAM – Wird mit --annotate verwendet. Algorithmus, der verwendet wird, um erkannte Formen in UI-Elemente (GREEDY oder FH) zu gruppieren. Mit GREEDY werden Formen, die näher als --threshold sind, in einem einzelnen Element kombiniert. Bei FH wird --threshold als Parameter für die Segmentierungsskala verwendet. Höhere Werte führen zu weniger, größeren Merkmalen und niedrigere Werte zu mehr, kleineren Merkmalen (Standard: FH).
  • -h,--help – Zeigt die Hilfemeldung für den angegebenen Befehl an.
  • --min-area=PARAM – Wird mit --annotate verwendet. Mindestformfläche in dp² vor der Erkennung von Merkmalen. Formen, die kleiner als dieser Schwellenwert sind, werden ignoriert (Standard: 5.0).
  • --min-nested-area=PARAM – Wird mit --annotate verwendet. Mindestfläche des übergeordneten Features in dp², die erforderlich ist, um verschachtelte untergeordnete Features beizubehalten. Erhöhen Sie diesen Wert, wenn kleine Details in Symbolen als separate Elemente gekennzeichnet werden (Standard: 3600.0).
  • --min-rect=PARAM – Wird mit --annotate verwendet. Das Mindestverhältnis der Fläche einer Form zur Fläche des achsenparallelen Begrenzungsrahmens. Formen unterhalb von --min-rect und --min-round werden ignoriert (Standard: 0.2).
  • --min-round=PARAM – Wird mit --annotate verwendet. Mindestrundheit der Form (4 * PI * area / perimeter^2, wobei 1.0 ein perfekter Kreis ist). Formen unterhalb von --min-rect und --min-round werden ignoriert (Standard: 0.2).
  • -o,--output=PARAM: Speichert den Screenshot in der angegebenen Datei oder im angegebenen Verzeichnis.
  • --threshold=PARAM – Wird mit --annotate verwendet. Der Grenzwert für die Gruppierung, der an den in --features angegebenen Algorithmus übergeben wird (Standardwert: 15).

android-Optionen:

  • --sdk=PARAM: Pfad zum Android SDK.
  • -v,--verbose: Aktiviert die ausführliche Ausgabe zur Fehlerbehebung.
  • -V,--version – Gibt Versionsinformationen aus und beendet den Vorgang.

Beschreibung

Mit android screen capture wird ein PNG-Screenshot des verbundenen Android-Geräts oder ‑Emulators aufgenommen.

Wenn -o, --output weggelassen wird, werden die Roh-PNG-Bildbytes in die Standardausgabe geschrieben.

UI-Elemente mit Anmerkungen versehen (-a, --annotate)

Übergeben Sie -a, --annotate, um UI-Elemente auf dem Bildschirm zu erkennen und nummerierte Begrenzungsrahmen (#1, #2 usw.) um jedes erkannte Element zu legen. In die ausgegebene PNG-Datei werden auch Metadaten für Begrenzungsrahmen eingebettet, damit android screen resolve #N-Labels in (x, y)-Koordinaten auf dem Bildschirm übersetzen kann.

Sie können die Erkennungsempfindlichkeit mit Optionen wie --edge-thresh-weak, --edge-thresh-strong, --min-area, --min-rect, --min-round, --min-nested-area, --distance, --features und --threshold anpassen.

Beispiele

Speichere einen Screenshot des verbundenen Geräts in ui.png:

android screen capture --output=ui.png

Erstellen Sie einen Screenshot mit Anmerkungen und Begrenzungsrahmen für die Benutzeroberfläche für das visuelle Targeting:

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