← 메인으로 돌아가기

API 문서 개요

이 페이지는 기존 홈 내부 섹션에 묻혀 있던 API 문서를 크롤 가능한 독립 URL로 분리한 개요 페이지입니다. 검색 엔진과 심사 봇이 직접 접근해도 핵심 범주와 대표 함수, 사용 방향을 바로 확인할 수 있습니다.

입력 제어

탭, 더블 탭, 스와이프, 드래그, 키 입력 같은 기본 액션을 제공합니다. UI 자동화의 대부분은 이 계층에서 시작합니다.

  • tap(x, y), double_tap(x, y, interval)
  • swipe(x1, y1, x2, y2, duration), drag(...)
  • key_press(key), text_input(text)
if tap(540, 1180):
    print("start tapped")

이미지 매칭과 OCR

화면 캡처, 템플릿 탐색, 픽셀 검사, OCR 판독을 통해 좌표 고정 없이 동작하는 자동화를 구성할 수 있습니다.

  • capture(), match_template(template, threshold)
  • wait_template(...), match_and_tap(...)
  • ocr_text(), check_pixel_color(...)
result = match_template("battle_button.png", 0.85)
if result:
    tap(result["center"][0], result["center"][1])

상태 관리와 유틸리티

변수 저장, 시간 제어, 로그 출력, 조건 분기 보조 함수로 복잡한 루프를 안정적으로 관리할 수 있습니다.

  • 반복 실행 전 대기, 타임아웃, 재시도 흐름 구성
  • 스크립트 변수와 상태값 저장
  • 디버그 로그와 조건 판정 도우미

디바이스 및 실행 흐름

에뮬레이터 연결 상태, 화면 해상도, 실행 대상 환경을 읽고 자동화 흐름에 반영할 수 있습니다.

  • 장치 연결과 캡처 상태 점검
  • 화면 비율 차이를 고려한 안전한 자동화 로직 구성
  • 실행 전 준비 상태 확인과 실패 복구 시나리오 설계

상세 사용 예시는 홈의 기능 소개, 빠른 시작 가이드, 그리고 앱 내부 예제 스크립트와 함께 참고하는 것이 가장 빠릅니다.