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 등)를 사용하여 스크린샷의 UI 요소를 감지하고 라벨을 지정합니다. 이를 통해 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