Wait for images
지정된 이미지들이 화면에 출현하거나 소멸할 때까지 대기합니다.
이미지가 화면에 출현(appear) 하거나 소멸(disappear) 할 때까지 흐름을 대기시킵니다. 카테고리 공통 입력 필드는 Images 명령어 개요 페이지를 참고하세요.
매개변수
| Argument | Type | Description |
|---|---|---|
| Images | 리스트 | 명령어에서 사용할 이미지 리스트 |
| Select image | 선택 | 사용할 이미지 선택 |
| Search for image on | 선택 | 이미지를 찾을 위치 — Entire screen / Foreground window only |
| Tolerance | 숫자 | 픽셀 컬러 매칭 허용 오차 |
| Find all images in the list | 체크 | 체크 시 리스트의 모든 이미지를 확인 |
| Duration | 숫자 | 동작 대기 시간 — -1 이면 무한 대기 |
| Option | 선택 | 대기 조건 — Wait for image to appear / Wait for image to disappear |
| Search on specified subregion | — | 이미지를 찾을 영역 선택 |
반환값
반환값
조건이 충족되면 1. 지정한 시간 안에 충족되지 않으면 -25(SECode_Timeout), 기다리는 중 실행을 멈추면 -5(SECode_ForceStop) 등 음수 에러 코드를 반환합니다.
설명
Images 의 이미지들이 화면에 존재하거나 존재하지 않을 경우, Option 설정에 따라 대기 종료 조건을 판단합니다.
Duration 이 -1 이면 영원히 대기합니다. 자동 흐름에서 사용할 때는 적절한 타임아웃을 지정하는 것이 안전합니다.
출력 창 표시
실행 결과는 출력 창에 한 줄로 표시됩니다. 문구는 Aurora 표시 언어를 따릅니다(아래는 한국어 UI 예).
| 상황 | 출력 창 예 |
|---|---|
| 이미지 하나를 찾음 | 찾음 'button.png' (120, 340, 64x24) 일치율 97.5% |
| 여러 이미지 중 일부를 찾음 | 2/3개 찾음 (최고 일치율 96.0%) |
| 찾지 못함 | 찾지 못함 (이미지 3개, 최고 일치율 72.4%, 허용 오차 10) |
| 리소스 이미지 파일이 없음 | 리소스 이미지가 없습니다 'button.png' |
| 화면을 캡처하지 못함 | 화면 캡처 실패 (오류 코드) |
| 대기 시간 | 결과 뒤에 (1.5초, 3회 시도)처럼 걸린 시간과 시도 횟수 |
관련 명령어