하드웨어 키보드 연결 해제 (:disconnect)

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

선언

성공 여부, 오류 정보 = 하드웨어 키보드 객체:disconnect()

반환값

• 성공 여부 불리언입니다. 연결 해제에 성공하면 true, 실패하면 false를 반환합니다.
• 오류 정보 문자열이며 연결 해제에 실패하면 오류 정보를 반환합니다.

설명

누른 모든 키를 놓고 해당 하드웨어 키보드 객체의 연결을 해제합니다.

• 이 메서드는 반복해서 호출할 수 있습니다.
• 객체가 현재 전역 하드웨어 키보드인 경우 이 메서드는 전역 키보드 연결도 해제합니다.
• 같은 하드웨어 키보드에서 :press 또는 :send_text 시퀀스를 실행 중이면 이 메서드는 false, "hardware keyboard is busy"를 반환합니다.
• Lua가 하드웨어 키보드 객체를 회수하거나 스크립트가 중지될 때도 XXTouch가 누른 모든 키를 자동으로 놓고 객체 연결을 해제합니다.

예제

local keyboard = assert(key.connect_keyboard())

local success, err = keyboard:disconnect()
assert(success, err)