전역 하드웨어 키보드 연결 해제 (key.disconnect_global_keyboard)

이 함수는 20260805 이후 버전에서만 사용할 수 있습니다

선언

성공 여부, 오류 정보 = key.disconnect_global_keyboard()

반환값

• 성공 여부 불리언입니다. 연결 해제에 성공하거나 현재 전역 하드웨어 키보드가 없으면 true, 실패하면 false를 반환합니다.
• 오류 정보 문자열이며 연결 해제에 실패하면 오류 정보를 반환합니다.

설명

누른 모든 키를 놓고 현재 전역 하드웨어 키보드의 연결을 해제합니다. 연결 해제 후 기존 키 인터페이스는 연결 전 동작으로 돌아갑니다.

• 이 함수는 반복해서 호출할 수 있으며 현재 전역 하드웨어 키보드가 없어도 성공을 반환합니다.
• 전역 하드웨어 키보드가 :press 또는 :send_text 시퀀스를 실행 중일 때 연결을 해제하면 false, "hardware keyboard is busy"를 반환합니다.
• 이미 key.down으로 누른 키는 연결 해제 시 놓입니다. 이후 이에 대응하는 key.up은 입력을 다시 전송하지 않습니다.

예제

local success, err = key.disconnect_global_keyboard()
assert(success, err)