문자 입력 (key.input_text)
이 함수는 20260816 이후 버전에서만 사용할 수 있습니다
선언
성공, 오류 정보 = key.input_text(문자 내용 [, 입력 완료 후 Enter 누르기 ])
매개변수
- 문자 내용
입력할 UTF-8 문자열입니다. 빈 문자열일 수 있으며 문자열 안의
"\b"는 백스페이스 동작을 수행합니다 - 입력 완료 후 Enter 누르기 입력을 마친 후 키보드의 Enter 키를 누를지 지정하는 불리언이며 기본값은 false입니다
반환값
- 성공
입력 시뮬레이션 동작을 전송하는 데 성공하면
true, 실패하면false를 반환하는 불리언입니다 - 오류 정보 문자열이며 실패하면 오류 원인을 반환합니다
설명
입력기에서 후보 문자를 선택하는 동작을 시뮬레이션하여 포그라운드 앱에서 포커스를 얻은 입력란에 문자를 입력합니다
이 함수는 시스템 공유 클립보드를 읽거나 수정하지 않습니다
이 함수로는 암호 입력란에 문자를 입력할 수 없습니다. 암호 입력란에는
sys.input_text를 사용하세요
true가 반환되었다는 것은 입력 시뮬레이션 동작이 전송되었다는 뜻일 뿐 대상 입력란이 반드시 문자를 받아들였다는 뜻은 아닙니다
예제
local ok, err = key.input_text("你好，XXTouch 🙂")
assert(ok, err)
--
local ok, err = key.input_text("hello!\b", true)
assert(ok, err)