이 페이지는 편의를 위해 영어에서 번역되었습니다. 영어 원문이 가장 정확한 버전이며, 둘이 다를 경우 영어 원문이 우선합니다.

화면의 텍스트를 매크로로 읽는 방법

Windows 매크로 안의 화면 OCR: 어떤 창에서든 숫자, 상태, 이름을 읽은 다음 그 값으로 무엇을 할지 정하세요.

2026년 9월 18일 업데이트 · 화면 텍스트 읽기는 Myna Recorder의 Pro 요금제에 포함되며, 새 계정은 모두 7일 동안 무료로 체험할 수 있습니다.

1. read_text가 하는 일

대부분의 매크로 도구는 클릭하고 입력할 수는 있어도 화면에 무엇이 쓰여 있는지는 알지 못합니다. read_text는 화면의 사각형 영역을 읽어 변수에 담고, 그 값은 다른 곳에 입력하거나, 비교하거나, 메시지에 쓸 수 있습니다.

total = read_text(region=(820, 400, 180, 40), single_line=True)
message_box("The order total was ${total}")

2. 영역 고르기

항상 region=(x, y, width, height)를 지정하세요. 데스크톱 전체를 읽으면 그림이 축소되어 평범한 인터페이스 텍스트를 읽을 수 없게 됩니다. 원하는 입력란 크기의 영역이면 빠르고 정확합니다. single_line=True는 읽은 내용을 한 줄로 합치며, 숫자나 이름을 읽을 때 원하는 동작입니다. 영역의 각 숫자는 변수나 덧셈식이어도 되므로, wait_for로 찾은 일치 위치를 따라 영역을 정할 수 있습니다.

3. 세 가지 판독기

engine=설명크레딧 사용내보낸 프로그램에 포함
"builtin"기본값. 내 컴퓨터에서 실행됩니다.아니요예
"tesseract"두 번째 로컬 판독기. 기본 제공 판독기보다 잘 읽는 화면도 있고 못 읽는 화면도 있으며, page_mode=로 그림을 줄로 나누는 방식을 조절할 수 있습니다. 거의 맞는데 틀리게 읽을 때 시도해 보세요.아니요예
"ai"저희 서버의 전사 모델. 두 로컬 판독기가 모두 잘못 읽는 텍스트에 씁니다.예아니요

엔진은 단계마다 고르므로, 한 매크로에서 무료 판독기는 모든 곳에, AI 판독기는 중요한 입력란 하나에만 쓸 수 있습니다.

4. 결과 정리해서 쓰기

total = read_text(region=(820, 400, 180, 40)).to_number()
if total < 1000:
    notify("Total looks low: ${total}")

메서드는 읽은 값을 정리합니다. 가장 많이 쓰게 될 것은 .to_number()입니다. 빈 영역은 빈 문자열을 저장하고 실행은 계속되므로, 작성한 조건을 값이 있을 때뿐 아니라 비어 있을 때도 테스트하세요. '변수' 패널은 실행 중에 모든 변수를 실시간으로 보여 주며, 판독기가 실제로 무엇을 돌려줬는지 가장 빨리 확인하는 방법입니다.

5. 대신 AI에게 물어야 할 때

read_text는 옮겨 적기만 합니다. 화면을 보고 판단하려면 ask_ai를 쓰세요. "빨간 행이 몇 개인가요?", "오류 대화 상자가 있나요?" 같은 질문입니다. 역할은 세 가지입니다. "count"는 개수와 각 대상의 위치를 돌려주므로 매크로가 그것을 클릭할 수 있고, "explain"은 로그나 알림에 쓸 문장을 돌려주고, "read"는 고른 모델로 텍스트를 옮겨 적습니다. 같은 이유로 작은 영역을 주세요. 모델은 데스크톱 전체에서 대상을 셀 수는 있어도 그 위치까지 찾아내지는 못할 수 있습니다. 호출할 때마다 크레딧이 들고, 한 번의 실행에서 AI 호출은 60회로 제한됩니다. 자세한 내용은 설명서에 있습니다.

6. 매크로 실행 중에 텍스트 감시하기

단계는 놓인 자리에서 한 번 읽습니다. 'AI에게 묻기'로 설정한 감시 행은 실행 내내, 또는 '감시 시작'을 누른 뒤 혼자서 지켜보다가, 답이 나타나거나 사라질 때 발동합니다. 팝업을 띄우거나, 스크린샷과 함께 Telegram이나 Discord로 메시지를 보내거나, 매크로를 중지할 수 있습니다. 모든 루프에 그런 단계를 넣지 않고도 새벽 3시에 뜬 "세션이 만료되었습니다" 배너를 알 수 있는 방법입니다.

7. 비용, 요금제, 내보내기

  • 화면 텍스트 읽기와 ask_ai는 Pro 요금제에 포함되며, Pro 요금제에는 매월 3,000크레딧도 함께 제공됩니다. 두 로컬 판독기는 크레딧을 전혀 쓰지 않습니다.
  • engine="ai", ask_ai, AI 감시 행은 크레딧을 쓰며 프로그램으로 내보내기를 막습니다. 기본 제공 판독기나 Tesseract 판독기로 읽는 매크로는 판독기를 파일 안에 넣은 채 문제없이 내보낼 수 있습니다.
  • 요금제와 크레딧 팩은 요금제 페이지에 있습니다.