! 텍스트 타이핑 시뮬레이션 (key.send_text)

이 페이지에서 설명하는 하드웨어 키보드 기능은 20260805 이후 버전에서만 사용할 수 있습니다

선언

key.send_text(텍스트 [, 키별 지연, Shift 키 지연])

매개변수

• 텍스트 입력할 문자열입니다. 영문자, 숫자, 공백, 반각 문자와 "\b", "\r", "\t"만 사용할 수 있습니다.
• 키별 지연 각 키 입력 사이의 지연 시간을 밀리초 단위로 지정하는 정수입니다. 기본값은 지연 없음이며 장치 성능이 허용하는 최대 속도로 입력합니다.
• Shift 키 지연 밀리초 단위의 정수입니다. 대문자나 일부 특수 기호는 Shift를 누른 상태로 입력해야 합니다. 예를 들어 @는 Shift + 2입니다.

설명

sys.input_text가 작동하지 않을 때 이 함수를 사용하면 키보드 타이핑을 강제로 시뮬레이션할 수 있습니다.

• 전역 하드웨어 키보드를 연결하면 해당 객체를 통해 텍스트가 입력됩니다. 전역 하드웨어 키보드가 없을 때는 기존 동작을 유지합니다.
• 하드웨어 키보드는 현재 Lua의 미국식 키보드 매핑에 따라 키와 Shift 조합을 생성합니다. 최종 문자는 대상 시스템의 키보드 배열에도 영향을 받습니다.
• 하드웨어 키보드로 입력할 때는 호출 전에 이미 눌려 있던 키를 보호합니다. 전송에 실패해도 다른 입력 방식으로 자동 재시도하지 않습니다.

예제

key.send_text("AbC12#") -- 가능한 한 빠르게 텍스트 입력
--
key.send_text("AbC12#", 300) -- 각 키 입력 후 0.3초 지연