Aller au contenu principal

! 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_text est 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