Click found image
화면 또는 Aurora agent에서 이미지를 찾아 그 위치를 클릭합니다.
화면 또는 Aurora agent에서 등록된 이미지를 찾아 그 위치를 클릭합니다. 카테고리 공통 입력 필드는 Images 명령어 개요 페이지를 참고하세요.
매개변수
| Argument | Type | Description |
|---|---|---|
| Images | 리스트 | 명령어에서 사용할 이미지 리스트 |
| Select image | 선택 | 사용할 이미지 선택 — 다중 선택 가능 |
| Search for image on | 선택 | 이미지를 찾을 위치 — Entire screen / Foreground window only |
| Tolerance | 숫자 | 픽셀 컬러 매칭 허용 오차 |
| Option | — | 이미지를 찾을 영역 선택 |
반환값
반환값
성공 시 1. 이미지를 찾지 못하면 -26(SECode_NotFound), 리소스 이미지가 화면보다 크면 -125, 입력이 차단되면(UIPI·보안 데스크톱) -2063(UIam_InputBlocked) 등 음수 에러 코드를 반환합니다.
설명
찾을 이미지가 2개 이상일 경우 등록된 순서대로 화면을 검색하며, 가장 먼저 찾은 이미지의 위치를 클릭합니다. 모든 이미지가 화면에 없으면 실패를 반환합니다.
출력 창 표시
실행 결과는 출력 창에 한 줄로 표시됩니다. 문구는 Aurora 표시 언어를 따릅니다(아래는 한국어 UI 예).
| 상황 | 출력 창 예 |
|---|---|
| 이미지 하나를 찾음 | 찾음 'button.png' (120, 340, 64x24) 일치율 97.5% |
| 여러 이미지 중 일부를 찾음 | 2/3개 찾음 (최고 일치율 96.0%) |
| 찾지 못함 | 찾지 못함 (이미지 3개, 최고 일치율 72.4%, 허용 오차 10) |
| 리소스 이미지 파일이 없음 | 리소스 이미지가 없습니다 'button.png' |
| 화면을 캡처하지 못함 | 화면 캡처 실패 (오류 코드) |
| 클릭 | 결과 뒤에 (120, 340) 클릭처럼 클릭한 위치 |
관련 명령어