Déconnecter le clavier matériel global (key.disconnect_global_keyboard)

Cette fonction est disponible uniquement dans les versions postérieures à 20260805

Déclaration

Succès, message d’erreur = key.disconnect_global_keyboard()

Valeur de retour

• Succès Type booléen, renvoie true si la déconnexion réussit ou si aucun clavier matériel global n’est présent ; renvoie false en cas d’échec.
• Message d’erreur Type texte, message d’erreur renvoyé lorsque la déconnexion échoue.

Description

Relâche toutes les touches et déconnecte le clavier matériel global actuel. Après la déconnexion, les interfaces de touches existantes retrouvent leur comportement antérieur à la connexion.

• Cette fonction peut être appelée plusieurs fois ; elle renvoie également un succès lorsqu’aucun clavier matériel global n’est présent.
• Si le clavier matériel global exécute une séquence :press ou :send_text, la déconnexion renvoie false, "hardware keyboard is busy".
• Les touches déjà enfoncées par key.down sont relâchées lors de la déconnexion ; l’appel ultérieur correspondant à key.up n’envoie aucune nouvelle entrée.

Exemple

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