請求文字回覆 (LCC.assist.ask_text)

聲明

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

參數

• options
  表格型，人工輔助請求設定。欄位見 通用參數與傳回物件。本函數會自動設定 type = "text"。

回傳值

• result
  表格型或 nil；成功時通常為 { kind = "text-reply", text = "..." }。
• err
  字串型或 nil；失敗時傳回錯誤描述。
• task
  表格型或 nil；最後一次任務狀態。

說明

用於驗證碼、簡訊驗證碼、密碼等「由人工提供一段文字，腳本就能繼續」的情境。
不要把文字回覆用於「需要使用者判斷下一步該怎麼做」的情境；這類情況應使用 request_control()。

範例

local result, err = LCC.assist.ask_text({
    title = "輸入驗證碼",
    text = "請查看截圖中的驗證碼並輸入",
    screenshotLocalPath = XXT_SCRIPTS_PATH .. "/captcha.png",
    timeout = 120,
})

if result then
    sys.input_text(result.text, false)
else
    nLog("輔助失敗", err)
end