본문으로 건너뛰기

! 전역 하드웨어 키보드 연결 (key.connect_global_keyboard)

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

선언​

하드웨어 키보드 객체, 오류 정보 = key.connect_global_keyboard([구성 속성])

매개변수​

  • 구성 속성 테이블형 선택 매개변수이며 key.connect_keyboard와 동일한 기본 속성 및 제약 조건을 사용합니다.

반환값​

  • 하드웨어 키보드 객체 연결에 성공하면 하드웨어 키보드 객체를 반환하고, 실패하면 nil을 반환합니다.
  • 오류 정보 문자열이며 연결에 실패하면 오류 정보를 반환합니다.

연결에 실패할 때 두 반환값을 합치면 nil, error입니다.

설명​

전역 하드웨어 키보드를 생성하고 연결합니다. 연결을 기다리는 동안 암묵적으로 실행권을 양보하므로 함수가 반환되기 전에 다른 스레드가 실행 기회를 얻을 수 있습니다.

  • 연결 후 기존 key.press, key.down, key.up, key.send_text 및 key(...):press/down/up의 일반 키보드와 숫자 키패드 입력은 이 객체를 통해 전송됩니다
  • 미디어 키와 제조사 사용자 지정 키는 기존 동작을 유지합니다
  • 전역 하드웨어 키보드가 없으면 기존 인터페이스의 동작은 바뀌지 않습니다.
  • key.down과 이에 대응하는 key.up은 항상 쌍을 유지합니다. 두 호출 사이에 연결 상태가 바뀌어도 입력이 중복되거나 잘못 해제되지 않습니다
  • 한 번에 전역 하드웨어 키보드 하나만 연결할 수 있습니다. 연결이 완료되지 않은 상태에서 다시 호출하거나 이미 전역 하드웨어 키보드가 있는데 다시 연결하면 실패를 반환합니다.

예제​

local keyboard, err = key.connect_global_keyboard({
    Product = "XXTouch Keyboard",
})
assert(keyboard, err)

key.press("A")
key.send_text("Hello")

local current = key.get_global_keyboard()
assert(current == keyboard)

assert(key.disconnect_global_keyboard())