!30: 문자 인식 요청 — Aurora Protocol

EUT와 무관한 부가 기능으로, 입력한 이미지의 특정 영역 문자를 인식해서 반환하는 명령입니다. 응답 명령은 !99: 또는 !31:입니다.

요청 (클라이언트 → 서버)

형식

!30:path,Option,X,Y,Width,Height,CompareText\0

인자	설명
Image file path	인식할 이미지 파일의 절대경로
Option	`0` 영문·숫자 인식 · `1` 숫자만 인식
X	인식할 영역의 시작 X 좌표
Y	인식할 영역의 시작 Y 좌표
Width	X에서부터의 너비
Height	Y에서부터의 높이
Compare text	인식된 문자열과 비교할 문자열

인자는 정확히 7개여야 합니다. 경로나 비교 문자열 안에 쉼표가 있으면 \,로 씁니다(예: Hello\, world → Hello, world). 그 밖의 역슬래시는 경로 그대로 전달됩니다.

응답 (서버 → 클라이언트)

먼저 !99:로 명령 수신 결과를 응답합니다.

응답

!99:10 NG · 1 OK · <0 에러.

!99:1이 전달된 다음 !31:으로 인식 결과가 전달됩니다. !99:0 이거나 에러가 반환되면 !31:은 전송되지 않습니다.

예제

→  !30:c:\image\a0.png,0,10,10,100,23,TestString
←  !99:1
←  !31:1,TestString,1

Player는 !99:1 응답 뒤에 지정한 영역의 문자를 실제로 인식해 비교 문자열과 대조하고, 결과를 !31:으로 보냅니다. 이미지 경로는 절대경로를 쓰거나, 상대 경로이면 프로젝트의 스크립트 리소스 폴더 기준으로 찾습니다. 인식 실패나 불일치 시에는 같은 폴더에 인식 영역을 빨간 사각형으로 표시한 <이름>_fail.<확장자> 이미지가 저장됩니다.