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 - 使用带编号的边界框（#1、#2 等）检测并标记屏幕截图中的界面元素。这样一来，AI 智能体和脚本就可以通过标签编号引用屏幕上的界面元素，而无需手动计算像素坐标。
  • --debug - 输出用于参数调优的中间特征检测步骤。
  • --device=PARAM - 设备序列号。
  • --distance=PARAM - 与 --annotate 搭配使用。用于将检测到的形状合并为界面特征（MIN_EUCLIDEAN 或 MIN_ANISOTROPIC）的距离指标。MIN_ANISOTROPIC 会为 y 轴上的垂直分离赋予比 x 轴上的水平分离更高的权重（默认值：MIN_EUCLIDEAN）。
  • --edge-thresh-strong=PARAM - 与 --annotate 搭配使用。用于边缘检测的强阈值（0 至 1）。如果系统忽略了几乎检测不到的边缘，请降低此值；如果检测到的边缘过于杂乱，请提高此值（默认值：0.1）。
  • --edge-thresh-weak=PARAM - 与 --annotate 搭配使用。边缘检测的弱阈值（0 至 1）。如果系统忽略了几乎检测不到的边缘，请降低此值；如果检测到的边缘过于杂乱，请提高此值（默认值：0.05）。
  • --features=PARAM - 与 --annotate 搭配使用。用于将检测到的形状分组为界面功能（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 图片字节会写入标准输出。

为界面元素添加注释 (-a, --annotate)

传递 -a, --annotate 以检测屏幕上的界面元素，并在每个检测到的元素周围叠加带编号的边界框（#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

捕获带有注释的屏幕截图，其中包含用于视觉定位的界面边界框标签：

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