メインコンテンツへ移動

座標の選択を依頼する (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 },
})