! Simuler la saisie de texte (key.send_text)
La fonction de clavier matériel décrite sur cette page est disponible uniquement dans les versions postérieures à 20260805
Déclaration
key.send_text(texte [, délai par touche, délai de la touche Shift])
Paramètres
- Texte
Type texte, texte à saisir, limité aux lettres anglaises, chiffres, espaces, caractères ASCII ainsi qu’à
"\b","\r"et"\t". - Délai par touche Type entier, délai entre chaque touche, en millisecondes ; aucun délai par défaut, la saisie s’effectue à la vitesse maximale du périphérique.
- Délai de la touche Shift
Type entier, en millisecondes ; les lettres majuscules et certains symboles spéciaux nécessitent de maintenir Shift, par exemple
@correspond àShift + 2.
Description
Cette fonction permet de forcer la simulation de la saisie au clavier lorsque
sys.input_textest invalide.
- Après la connexion du clavier matériel global, le texte est saisi via cet objet ; sans clavier matériel global, le comportement reste inchangé.
- Le clavier matériel génère les touches et les combinaisons avec Shift selon la disposition de clavier américain actuelle de Lua ; les caractères finaux restent soumis à la disposition du clavier du système cible.
- La saisie via le clavier matériel préserve les touches déjà enfoncées avant l’appel ; en cas d’échec de l’envoi, aucune nouvelle tentative automatique avec l’ancien mode de saisie n’est effectuée.
Exemple
key.send_text("AbC12#") -- Saisir le texte aussi rapidement que possible
--
key.send_text("AbC12#", 300) -- Attendre 0,3 seconde entre chaque touche