XRInputSourceArray

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Die Schnittstelle XRInputSourceArray repräsentiert eine lebendige Liste von WebXR-Eingabequellen und wird als Rückgabewert der XRSession-Eigenschaft inputSources verwendet. Jeder Eintrag ist eine XRInputSource, die ein mit dem WebXR-System verbundenes Eingabegerät repräsentiert.

Zusätzlich zur Möglichkeit, auf die Eingabequellen in der Liste mit der Standard-Array-Notation (d.h. mit Indexnummern in eckigen Klammern) zuzugreifen, sind Methoden verfügbar, die die Verwendung von Iteratoren zulassen, und auch die Methode forEach() ist verfügbar.

Instanzeigenschaften

Die folgenden Eigenschaften sind auf XRInputSourceArray-Objekten verfügbar.

length Schreibgeschützt

Die Anzahl der XRInputSource-Objekte in der Liste.

Instanzmethoden

Die folgenden Methoden sind auf XRInputSourceArray-Objekten verfügbar. Sie können auch die Funktionen des Typs Symbol verwenden.

entries()

Gibt einen iterator zurück, den Sie verwenden können, um die Liste der Schlüssel/Werte-Paare in der Liste zu durchlaufen. Jedes zurückgegebene Element ist ein Array, dessen erster Wert der Index und dessen zweiter Wert die XRInputSource an diesem Index ist.

forEach()

Iteriert über jedes Element in der Liste, in der Reihenfolge von erstem bis letztem.

keys()

Eine Liste der Schlüssel, die den Einträgen in der Eingabebereichsliste entsprechen.

values()

Gibt einen iterator zurück, mit dem Sie alle Werte in der Liste durchgehen können. Jedes Element ist ein einzelnes XRInputSource-Objekt.

Zusätzlich zu diesen Methoden können Sie Array-Notation verwenden, um Elemente in der Liste nach Index zuzugreifen. Zum Beispiel ruft der untenstehende Codeausschnitt eine Funktion handleInput() auf und übergibt ihr das erste Element in der Eingabeliste, sofern die Liste nicht leer ist.

js
let sources = xrSession.inputSources;
if (sources.length > 0) {
  handleInput(sources[0]);
}

Beispiele

Spezifikationen

Specification
WebXR Device API
# xrinputsourcearray-interface

Browser-Kompatibilität

BCD tables only load in the browser