설치·연결·인식 문제 해결
문제가 발생하면 실행 중인 자동화를 먼저 중지하고, 한 번에 한 가지 설정만 바꿔 다시 확인하세요. 아래 절차는 원인을 구분하기 위한 점검이며 모든 환경에서의 해결을 보장하지 않습니다.
다운로드 링크가 열리지 않거나 설치 파일이 실행되지 않습니다
공식 릴리스 페이지에 접근할 수 있는지 먼저 확인하세요. 릴리스 페이지가 열리면 pqp-setup.exe를 선택합니다. GitHub 자체에 접근할 수 없다면 파일 문제와 네트워크 접근 문제를 구분해야 합니다.
파일을 일부만 받았거나 손상이 의심되면 해시 비교 방법을 확인하세요. 운영체제 경고나 보안 프로그램이 실행을 막는다면 정확한 경고 내용을 기록해 문의하세요. 보안 기능을 해제하거나 출처를 알 수 없는 재배포 파일을 사용하지 마세요.
장치 목록에 에뮬레이터가 나타나지 않습니다
- 에뮬레이터가 실행 중이고 Android 화면까지 표시되는지 확인합니다.
- pqp에서 장치 목록을 새로고침합니다. 여러 인스턴스를 켰다면 원하는 인스턴스를 구분합니다.
- 최근에 에뮬레이터 버전이나 연결 설정을 바꿨는지 확인합니다.
- 여전히 나타나지 않으면 pqp 버전, 에뮬레이터 제품·버전, 장치 목록에 보이는 내용을 함께 기록합니다.
연결 포트나 장치 설정을 추정해서 무작위로 변경하지 마세요. 제품별 설정 위치가 다르므로 에뮬레이터의 공식 안내도 확인하세요.
장치는 연결됐지만 미리보기가 검거나 멈춰 있습니다
먼저 실제 에뮬레이터 창에서 화면이 정상적으로 바뀌는지 확인하세요. 실제 창도 멈췄다면 에뮬레이터 상태를 먼저 해결해야 합니다. 실제 창만 정상이라면 선택한 인스턴스와 pqp의 미리보기가 같은 장치인지 확인합니다.
문의를 위해 화면 캡처 방식을 변경했다면 변경 전·후 상태를 기록하세요. 장치 재연결 전에는 실행 중인 규칙을 중지하고 저장하지 않은 작업을 보존하세요.
이미지 매칭이나 OCR 결과가 잘못됩니다
- 이미지 미검출: 템플릿을 만든 화면과 현재 화면의 해상도·배율·테마·언어가 같은지 비교합니다.
- 엉뚱한 위치 검출: 유사한 아이콘이나 배경이 포함됐는지 확인하고 검색 영역을 좁힙니다. 임계값만 무조건 낮추면 오검출이 늘 수 있습니다.
- OCR 오인식: 글자 영역이 잘리지 않았는지, 화면 전환 중인지, 대비가 충분한지 원본 캡처에서 확인합니다.
- 입력 위치 어긋남: 장치 해상도를 바꾼 뒤 이전 좌표를 사용하고 있지 않은지 확인합니다.
스크립트가 함수 오류를 내거나 반복됩니다
API 문서에서 사용하는 언어의 예제와 매개변수를 확인하세요. Python, Lua, JavaScript의 문법과 일부 함수 이름은 다릅니다. 다른 언어의 예제를 그대로 붙여 넣지 마세요.
오류가 시작되는 최소 동작만 남겨 재현하고, 오류 메시지와 함수 이름을 기록합니다. 계속 실행되는 규칙은 먼저 중지하고 종료 조건 및 대기 시간을 확인하세요. API 문서와 설치 버전 사이에 차이가 의심되면 버전을 함께 알려 주세요.
해결되지 않을 때 문의에 포함할 내용
- pqp 버전, Windows 버전, 에뮬레이터 제품명과 버전
- 기대했던 결과와 실제 결과
- 문제를 재현하는 짧은 순서와 오류 메시지
- 문제가 발생한 화면의 캡처와 최근 변경한 설정
스크린샷과 로그를 보내기 전에 라이선스 키, 토큰, 계정 정보, 대화 내용 같은 민감한 정보를 가려 주세요. Discord 문의에서 내용을 전달할 수 있습니다. Discord 로그인이나 계정이 필요할 수 있습니다.