Aller au contenu principal

! Créer et connecter un objet de souris matérielle (mouse.connect)

Cette fonction est disponible à partir des versions postérieures au 20260805

Déclaration​

objet_souris, message_erreur = mouse.connect([ proprietes ])

Paramètres​

  • proprietes type table, paramètre facultatif servant à définir les propriétés de la souris matérielle

Valeur renvoyée​

  • objet_souris objet de souris matérielle, renvoyé lorsque la création réussit ; en cas d’échec, nil est renvoyé
  • message_erreur type texte, raison de l’échec de la création

Description​

Chaque appel crée un objet de souris indépendant ; l’état des touches et le cycle de vie de la connexion de chaque objet sont indépendants. Une réussite signifie que l’objet peut être utilisé ; la réponse de l’application cible dépend toujours d’iOS et de l’application. Cette fonction cède le thread d’exécution Lua actuel pendant l’attente de la connexion.

proprietes peut être omis. Voici les propriétés configurables courantes et leurs valeurs par défaut :

{
    VendorID = 0x5858,
    ProductID = 0x0006,
    VersionNumber = 1,
    Product = "XXTouch Mouse",
    Manufacturer = "XXTouch",
    Transport = "USB",
}

Vous pouvez également définir SerialNumber et LocationID ; l’effet des autres propriétés n’est pas garanti. Transport ne modifie que la manière dont iOS ou l’application cible identifie la souris. La valeur "BluetoothLowEnergy" n’établit aucune connexion Bluetooth, diffusion ou association, et ne fait pas apparaître la souris dans la liste Bluetooth des autres appareils. En cas d’échec de l’envoi d’une opération de souris, l’objet libère automatiquement toutes les touches et se déconnecte ; il ne réessaie pas avec une entrée tactile.

Exemple​

local m, err = mouse.connect({
    Product = "XXTouch Mouse",
})
assert(m, err)

assert(m:move(100, 0))
assert(m:down("left"))
assert(m:move(100, 50))
assert(m:up("left"))
assert(m:click("right", 60))
assert(m:click(13))
assert(m:scroll(0, 10))

m:disconnect()