capture d'écran Android

Affiche l'écran de l'appareil au format PNG.

Utilisation

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]

Options

  • -a,--annotate : détecte et libelle les éléments d'UI sur la capture d'écran avec des cadres de délimitation numérotés (#1, #2, etc.). Cela permet aux agents et aux scripts d'IA de référencer les éléments de l'UI à l'écran par numéro de libellé au lieu de calculer manuellement les coordonnées en pixels.
  • --debug : génère les étapes de détection des caractéristiques intermédiaires pour le réglage des paramètres.
  • --device=PARAM : numéro de série de l'appareil.
  • --distance=PARAM : utilisé avec --annotate. Métrique de distance pour combiner les formes détectées en fonctionnalités d'UI (MIN_EUCLIDEAN ou MIN_ANISOTROPIC). MIN_ANISOTROPIC pondère davantage la séparation verticale sur l'axe Y que la séparation horizontale sur l'axe X (par défaut : MIN_EUCLIDEAN).
  • --edge-thresh-strong=PARAM : utilisé avec --annotate. Seuil élevé (de 0 à 1) pour la détection des contours. Diminuez cette valeur si les contours à peine détectables sont ignorés, ou augmentez-la si la détection est trop bruyante (par défaut : 0.1).
  • --edge-thresh-weak=PARAM : utilisé avec --annotate. Seuil faible (de 0 à 1) pour la détection des contours. Diminuez cette valeur si les contours à peine détectables sont ignorés, ou augmentez-la si la détection est trop bruyante (par défaut : 0.05).
  • --features=PARAM : utilisé avec --annotate. Algorithme utilisé pour regrouper les formes détectées dans les composants d'interface utilisateur (GREEDY ou FH). GREEDY combine les formes plus proches que la distance --threshold en un seul composant. FH utilise --threshold comme paramètre d'échelle de segmentation. Des valeurs plus élevées produisent des caractéristiques moins nombreuses et plus grandes, tandis que des valeurs plus faibles produisent des caractéristiques plus nombreuses et plus petites (par défaut : FH).
  • -h,--help : affiche le message d'aide pour la commande spécifiée.
  • --min-area=PARAM : utilisé avec --annotate. Surface de forme minimale en dp² avant la détection des caractéristiques. Les formes plus petites que ce seuil sont ignorées (par défaut : 5.0).
  • --min-nested-area=PARAM : utilisé avec --annotate. Surface minimale de la caractéristique parente dans dp² requise pour conserver les caractéristiques enfants imbriquées. Augmentez cette valeur si de petits détails à l'intérieur des icônes sont étiquetés comme des éléments distincts (valeur par défaut : 3600.0).
  • --min-rect=PARAM : utilisé avec --annotate. Ratio minimal entre la surface d'une forme et la surface de son cadre de délimitation aligné sur les axes. Les formes situées en dessous de --min-rect et --min-round sont ignorées (par défaut : 0.2).
  • --min-round=PARAM : utilisé avec --annotate. Arrondi minimal de la forme (4 * PI * area / perimeter^2, où 1.0 est un cercle parfait). Les formes situées en dessous de --min-rect et --min-round sont ignorées (par défaut : 0.2).
  • -o,--output=PARAM : écrit la capture d'écran dans le fichier ou le répertoire spécifié.
  • --threshold=PARAM : utilisé avec --annotate. Seuil de regroupement transmis à l'algorithme spécifié dans --features (par défaut : 15).

Options android :

  • --sdk=PARAM : chemin d'accès au SDK Android.
  • -v,--verbose : active la sortie détaillée pour le dépannage.
  • -V,--version : imprime les informations sur la version et quitte.

Description

android screen capture capture une capture d'écran PNG de l'appareil ou de l'émulateur Android connecté.

Si -o, --output est omis, les octets bruts de l'image PNG sont écrits sur la sortie standard.

Annoter des éléments d'interface utilisateur (-a, --annotate)

Transmettez -a, --annotate pour détecter les éléments d'interface utilisateur à l'écran et superposer des cadres de délimitation numérotés (#1, #2, etc.) autour de chaque élément détecté. Le fichier PNG de sortie intègre également des métadonnées de cadre de délimitation afin que android screen resolve puisse traduire les libellés #N en coordonnées d'écran (x, y).

Vous pouvez affiner la sensibilité de la détection à l'aide d'options telles que --edge-thresh-weak, --edge-thresh-strong, --min-area, --min-rect, --min-round, --min-nested-area, --distance, --features et --threshold.

Exemples

Enregistrez une capture d'écran de l'appareil connecté dans ui.png :

android screen capture --output=ui.png

Capturez une capture d'écran annotée avec des cadres de délimitation de l'UI étiquetés pour le ciblage visuel :

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