Saltar al contenido principal

! Conectar el teclado de hardware global (key.connect_global_keyboard)

Esta función solo está disponible a partir de las versiones posteriores a 20260805

Declaración​

objeto_teclado_hardware, mensaje_error = key.connect_global_keyboard([atributos_configuración])

Parámetros​

  • Atributos de configuración Tipo tabla, parámetro opcional; utiliza los mismos atributos predeterminados y restricciones que key.connect_keyboard.

Valores devueltos​

  • Objeto de teclado de hardware Objeto de teclado de hardware; se devuelve cuando la conexión tiene éxito y se devuelve nil cuando falla.
  • Mensaje de error Tipo texto; devuelve el mensaje de error cuando la conexión falla.

Cuando la conexión falla, los dos valores devueltos juntos son nil, error.

Descripción​

Crea y conecta el teclado de hardware global. Durante la espera de conexión se cede implícitamente; antes de que la función devuelva el control, otros hilos pueden tener la oportunidad de ejecutarse.

  • Después de conectarlo, las teclas del teclado normal y del teclado numérico de las interfaces existentes key.press, key.down, key.up, key.send_text y key(...):press/down/up se introducen mediante este objeto
  • Las teclas multimedia y las teclas personalizadas del fabricante conservan su comportamiento original
  • Si no hay un teclado de hardware global, el comportamiento de las interfaces existentes no cambia.
  • key.down y el key.up correspondiente permanecen emparejados; aunque el estado de conexión cambie entre ambas llamadas, no se producen entradas duplicadas ni liberaciones incorrectas
  • Solo se puede conectar un teclado de hardware global a la vez. Una llamada adicional mientras la conexión anterior no ha terminado o cuando ya existe un teclado global devuelve un fallo.

Ejemplo​

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())