Capture screen — Aurora Agent Commands

Aurora Agent가 실행 중인 장치의 화면 이미지를 받아 파일로 저장합니다. 저장한 이미지는 실행 결과 화면과 리포트에 해당 명령어의 장치 이미지로 표시됩니다. 공통 필드와 장치 등록 방법은 Aurora agent 명령어 개요를 참고하세요.

매개변수

Argument	Type	Description
Aurora agent alias	선택	화면을 받을 Aurora agent 장치 별칭
File name to save	문자열	저장할 파일 경로 또는 파일 이름 — 변수 사용 가능
Select the region to save	체크	체크 시 아래 좌표 영역만 잘라 저장
...	—	장치 화면을 받아 마우스 드래그로 저장 영역을 지정
Left / Top / Right / Bottom	숫자	저장 영역 좌표 — 0보다 작은 값은 자동으로 0으로 변경
Get device screen	—	장치 화면 미리 보기·수동 제어 창 열기
Delay	숫자	명령어 실행 후 대기 시간 (Milliseconds)
Description	텍스트	명령어 설명 (선택)

반환값

성공 시 1, 실패 시 0, 오류 시 음수 코드가 mReturnValue에 저장됩니다.

파일 이름을 지정한 경우 파일 저장 성공 여부가 반환값입니다. 파일 이름이 비어 있으면 화면 수신 결과만 반환되고 파일은 저장되지 않습니다.

설명

화면 수신은 최대 8초까지 대기하며, 초과하면 timeout 오류로 처리됩니다.
파일 경로 규칙
- 확장자가 없으면 .bmp 가 자동으로 붙습니다.
- 폴더 없이 파일 이름만 지정하면 프로젝트의 Report 폴더에 저장됩니다. 다른 위치에 저장하려면 전체 경로를 입력하세요.
- 저장 형식은 확장자와 관계없이 BMP 인코딩입니다. .png 등 다른 확장자를 지정해도 내용은 BMP로 기록됩니다.
Select the region to save 를 체크하고 좌표를 지정하면, 전체 화면을 받은 뒤 해당 영역만 잘라서 저장합니다. 영역이 비어 있으면(폭 또는 높이가 0) 전체 화면이 저장됩니다.
스크립트 목록에는 Take a screenshot on the '<alias>', save it as '<파일명>' (ROI l,t,r,b) 형식으로 표시됩니다.

... 버튼을 누르면 장치의 현재 화면이 열리고, 마우스로 영역을 드래그하면 Left / Top / Right / Bottom 값이 자동으로 채워집니다. 장치에 접속할 수 없으면 The Aurora agent is not connected. 메시지가 표시됩니다.

장치 화면에서 이미지를 찾아 판정하려면 파일로 저장하는 대신 Images 명령어의 Search for image on 에서 Aurora agent 별칭을 선택하는 방법이 더 편리합니다. Android 장치의 화면 캡처는 Capture screenshot in Android를 사용하세요.