수동 지원
LCC.assist는 장치 스크립트가 중앙 제어 서버에 수동 지원 요청을 보내는 데 사용합니다. 스크립트는 스크린샷과 설명을 첨부하고, 사람이 결과를 제출할 때까지 블로킹 상태로 기다린 뒤 실행을 계속할 수 있습니다.
요청 유형
| 유형 | API | 적합한 상황 | 일반적인 스크립트 처리 방식 |
|---|---|---|---|
| 텍스트 답변 | LCC.assist.ask_text() | 인증 코드, 문자 메시지 코드, 암호, 일회용 토큰 | result.text를 현재 입력란에 입력 |
| 좌표 선택 | LCC.assist.pick_point() | 그래픽 버튼이나 비정상 팝업 버튼처럼 사람이 누를 위치를 판단해야 하는 경우 | touch.tap(result.x, result.y)를 직접 호출 |
| 수동 원격 제어 | LCC.assist.request_control() | 슬라이더, 사람 여부 확인, 로그인, 보안 검증, 권한 팝업 등 불안정한 절차 | 수동 원격 제어가 끝난 뒤 다시 캡처하여 계속 판단 |
작업자에게 표시하는 설명은 구체적이고 실행 가능해야 하며, “추가 정보” 같은 추상적인 설명은 사용하지 마세요. “원격 제어로 현재 검증을 완료한 뒤 완료를 클릭해 주세요”, “스크린샷의 인증 코드를 입력해 주세요”, “확인 버튼 중앙을 선택해 주세요”처럼 작성하는 것이 좋습니다.
스크린샷 출처
지원 요청에는 여러 방식으로 이미지를 첨부할 수 있습니다.
screenshotLocalPath: 기기의 로컬 이미지 경로입니다. SDK가 중앙 제어의 임시 리소스로 업로드합니다.screenshotPath: 이미지가 이미 중앙 제어 서버의files루트 디렉터리에 있으면 상대 경로를 직접 전달합니다.screenshotImage: XXTouchImageObject입니다. SDK가 data URL로 변환하므로 먼저 파일로 저장할 필요가 없습니다.screenshotImageData: PNG/JPEG 이미지 바이너리 데이터입니다. SDK가 data URL로 변환합니다.input.imageSrc: 스크립트에 이미data:image/...,http(s)://...또는/api/...이미지 주소가 있으면input에 넣어 프런트엔드 표시용으로 그대로 전달할 수 있습니다.
SDK는 input.imageSrc를 덮어쓰지 않습니다. input.imageSrc도 경로 기반 스크린샷도 전달하지 않은 경우에만 SDK가 screenshotImage 또는 screenshotImageData를 input.imageSrc로 변환합니다.
수명 주기
요청 상태는 pending(대기), active(처리 중), submitted(결과 제출 완료), cancelled(취소), expired(만료)입니다. submitted 상태에서만 사용자가 제공한 결과를 받을 수 있습니다.
LCC.assist.request()의 대기 시간이 초과되면 해당 요청의 취소를 시도합니다. 스크립트가 정상 종료될 때는 현재 인스턴스의 미완료 요청 취소를 시도합니다. 중앙 제어를 다시 시작하면 작업과 결과가 보존되지 않으므로 나중에 사용할 결과는 별도로 저장하세요.
중앙 제어가 기기의 중지 상태를 받으면 해당 기기에서 pending / active 상태인 lua-script 지원 요청을 취소합니다. 이 일괄 취소는 다른 기기, 다른 출처 또는 제출된 결과에는 영향을 주지 않습니다.
자동 업로드된 스크린샷은 중앙 제어가 시작될 때 정리됩니다. 장기적으로 재사용할 이미지는 직접 관리하는 리소스 경로에 별도로 저장하고, 자동 생성된 screenshotPath를 영구 파일 참조로 사용하지 마세요.
요청 결과가 제출되거나 요청이 취소 또는 만료되면 인라인 이미지는 보존되지 않습니다.