Gamepad-Taste drücken (:down)

Diese Methode ist erst in Versionen nach 20260805 verfügbar.

Deklaration

Status, Fehlermeldung = Gamepad-Objekt:down(Taste)

Parameter

• Taste Ganzzahl oder Textwert; es können ganze Zahlen von 1 bis 32, die Tastenbezeichnungen aus der folgenden Tabelle oder "start" und "menu" übergeben werden. Bei Zeichenfolgen wird die Groß-/Kleinschreibung nicht beachtet.

Nummer	Tastenname	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	-

Rückgabewert

• Status Boolescher Wert; bei erfolgreicher Operation true, bei getrennter oder ausgelasteter Verbindung oder fehlgeschlagenem Senden der Eingabe false
• Fehlermeldung Textwert; Fehlermeldung bei fehlgeschlagener Operation

Beschreibung

• Die Zahlen 1 bis 32 bezeichnen Tasten und sind keine geräteübergreifend einheitlichen Gamepad-Tastencodes. In der Regel sollten bevorzugt die Tastenbezeichnungen aus der obigen Tabelle verwendet werden.
• Für die Zahlen 17 bis 32 gibt es keine vordefinierten Namen. Sie zeigen nur Wirkung, wenn die Ziel-App die entsprechenden erweiterten Tasten unterstützt.
• "start" und "menu" sind Aliase für dieselbe Menüeingabe und entsprechen keiner Zahl von 1 bis 32.
• Die Tastenbezeichnungen select, back, options, home, share und Touchpad werden derzeit nicht unterstützt.
• left_trigger und right_trigger unterstützen nur Drücken und Loslassen, keine Drucksimulation. menu löst keine Systemaktion für den Home-Bildschirm aus.
• Typfehler, unbekannte Namen und Werte außerhalb des gültigen Bereichs werden als Lua-Parameterfehler ausgelöst und nicht als false, error zurückgegeben.

Beispiel

local pad = assert(gamepad.connect())

assert(pad:down("left_shoulder"))
assert(pad:up("left_shoulder"))
assert(pad:down(13))  -- Zifferntaste 13
assert(pad:up(13))
assert(pad:disconnect())