Zum Hauptinhalt springen

! Ein eigenständiges Hardwaretastatur-Objekt erstellen (key.connect_keyboard)

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

Deklaration​

Hardwaretastatur-Objekt, Fehlermeldung = key.connect_keyboard([Konfigurationseigenschaften])

Parameter​

  • Konfigurationseigenschaften Tabelle, optionaler Parameter zum Festlegen der folgenden üblichen Geräteeigenschaften; die Werte im Codeblock sind die Standardwerte bei Auslassung:
{
    VendorID = 0x5858,
    ProductID = 0x0001,
    Product = "XXTouch Keyboard",
    Manufacturer = "XXTouch",
    Transport = "USB",
}

Zusätzlich können VersionNumber, SerialNumber und LocationID gesetzt werden. Für andere Eigenschaften wird keine Wirksamkeit garantiert.

Rückgabewerte​

  • Hardwaretastatur-Objekt Hardwaretastatur-Objekt, bei erfolgreicher Erstellung zurückgegeben; bei Fehler nil.
  • Fehlermeldung Text; bei fehlgeschlagener Erstellung wird die Fehlermeldung zurückgegeben.

Bei einer fehlgeschlagenen Erstellung lauten beide Rückgabewerte zusammen nil, error.

Hinweise​

Erstellt ein eigenständiges Hardwaretastatur-Objekt; der Tastenstatus und der Verbindungslebenszyklus jedes Objekts sind voneinander unabhängig. Während des Wartens auf die Verbindung wird die Ausführung implizit abgegeben; vor der Rückgabe der Funktion können andere Threads ausgeführt werden.

  • Transport beeinflusst nur, wie iOS oder die Ziel-App diese Tastatur erkennt. Das Setzen auf "Bluetooth" oder "BluetoothLowEnergy" stellt keine Bluetooth-Verbindung her, sendet keine Werbung und führt kein Pairing durch; die Tastatur erscheint auch nicht in den Bluetooth-Listen anderer Geräte.
  • Gleichzeitig können höchstens 6 normale Tasten gedrückt gehalten werden; Modifikatortasten werden nicht mitgezählt. Bei Überschreitung kann das Zielsystem die einzelnen Tasten nicht erkennen; geben Sie zuerst einige Tasten frei.
  • Die Ziel-App kann möglicherweise nicht zwischen den Eingabequellen mehrerer Hardwaretastatur-Objekte unterscheiden.
  • Diese Funktion erstellt nur ein eigenständiges Objekt und ändert die vorhandenen key.*-Schnittstellen nicht. Damit bestehende Schnittstellen die Hardwaretastatur verwenden, rufen Sie key.connect_global_keyboard auf.
  • Bei einer fehlgeschlagenen Übertragung wird nicht automatisch eine andere Eingabemethode versucht.

Beispiel​

local keyboard, err = key.connect_keyboard({
    Product = "XXTouch Keyboard",
})
assert(keyboard, err)

assert(keyboard:press("a"))
assert(keyboard:down("LEFTSHIFT"))
assert(keyboard:press("b"))
assert(keyboard:up("LEFTSHIFT"))
assert(keyboard:send_text("Hello"))

keyboard:disconnect()