좌표 선택 요청 (LCC.assist.pick_point)

선언

result, err, task = LCC.assist.pick_point(options)

매개변수

• options
  테이블 타입으로, 수동 지원 요청 설정을 나타냅니다. 필드에 대한 자세한 내용은 일반 매개변수 및 반환 객체를 참조하십시오. 이 함수는 자동으로 type = "point" 값을 설정합니다.

반환 값

• result
  테이블 타입 또는 nil 형태로, 성공 시 기기의 물리적 좌표인 x 및 y가 포함됩니다.
• err
  문자열 형태 또는 nil 형태로, 실패 시 오류 설명이 반환됩니다.
• task
  테이블 타입 또는 nil 형태로, 마지막 작업의 상태를 나타냅니다.

설명

사용자가 스크린샷에서 “어디를 탭해야 하는지” 판단하고, 스크립트가 받은 좌표를 곧바로 탭할 수 있는 상황에 사용합니다.
result.x 및 result.y는 기기의 물리적 좌표로, touch.tap(result.x, result.y)에서 직접 사용할 수 있습니다.
잘라낸 이미지가 전달될 경우 반드시 imageRect도 함께 전달해야 하며, 중앙 제어 서버가 스크린샷 내의 좌표를 기기의 물리적 좌표로 변환해 줍니다.

예시

local result, err = LCC.assist.pick_point({
    title = "확인 버튼 선택",
    text = "스크린샷에서 확인 버튼의 중앙을 선택하세요",
    screenshotLocalPath = XXT_SCRIPTS_PATH .. "/screen.png",
    timeout = 180,
})

if result then
    touch.tap(result.x, result.y)
end

잘라낸 이미지 예시:

local result, err = LCC.assist.pick_point({
    title = "버튼 선택",
    text = "잘라낸 이미지에서 확인 버튼을 선택하세요",
    screenshotLocalPath = XXT_SCRIPTS_PATH .. "/button-crop.png",
    imageRect = { left = 120, top = 360, width = 300, height = 160 },
})