Appuyer sur une touche de la manette (:down)

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

Déclaration

etat, message_erreur = objet_manette:down(touche)

Paramètres

• touche
  type entier ou texte, peut être un entier de 1 à 32, l’un des noms du tableau ci-dessous, ou "start" ou "menu" ; les chaînes ne distinguent pas les majuscules et minuscules

Numéro	Nom de la touche	Alias
1	a	-
2	b	-
3	x	-
4	y	-
5	left_shoulder	left_bumper, lb, l1
6	right_shoulder	right_bumper, rb, r1
7	left_trigger	lt, l2
8	right_trigger	rt, r2
9	left_stick	l3
10	right_stick	r3
11	l4	left_paddle
12	r4	right_paddle
13	m1	-
14	m2	-
15	m3	-
16	m4	-

Valeur renvoyée

• etat
  type booléen, renvoie true si l’opération réussit ; renvoie false si l’appareil est déconnecté, occupé ou si l’envoi de l’entrée échoue
• message_erreur
  type texte, message d’erreur lorsque l’opération échoue

Description

• Les nombres 1 à 32 représentent les touches numériques ; il ne s’agit pas de codes de touches de jeu uniformes entre appareils. Utilisez de préférence les noms du tableau ci-dessus
• Les nombres 17 à 32 n’ont pas de nom prédéfini et ne produisent un effet que si l’application cible prend en charge les touches étendues correspondantes
• "start" et "menu" sont des alias d’une même entrée de menu et ne correspondent à aucun nombre de 1 à 32
• select, back, options, home, share et les noms des touches du pavé tactile ne sont pas encore pris en charge
• left_trigger et right_trigger ne prennent en charge que l’appui et le relâchement, pas la simulation d’une pression ; menu ne déclenche pas l’action de l’écran d’accueil du système
• Une erreur de type de paramètre, un nom inconnu ou une valeur hors limites est levé comme erreur de paramètre Lua et non renvoyé sous la forme false, error

Exemple

local pad = assert(gamepad.connect())

assert(pad:down("left_shoulder"))
assert(pad:up("left_shoulder"))
assert(pad:down(13))  -- Touche numérique 13
assert(pad:up(13))
assert(pad:disconnect())