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.
Das Interface XRInputSourceArray repräsentiert eine dynamische Liste von WebXR-Eingabequellen und wird als Rückgabewert der XRSession-Eigenschaft inputSources verwendet. Jeder Eintrag ist ein XRInputSource, das ein mit dem WebXR-System verbundenes Eingabegerät darstellt.
Zusätzlich zur Möglichkeit, auf die Eingabequellen in der Liste unter Verwendung der Standard-Array-Notation (d.h. mit Indexnummern in eckigen Klammern) zuzugreifen, stehen Methoden zur Verfügung, die die Verwendung von Iteratoren ermöglichen, und die forEach()-Methode ist ebenfalls verfügbar.
Instanz-Eigenschaften
Die folgenden Eigenschaften sind auf XRInputSourceArray-Objekten verfügbar.
lengthSchreibgeschützt Experimentell-
Die Anzahl der
XRInputSource-Objekte in der Liste.
Instanz-Methoden
Die folgenden Methoden sind auf XRInputSourceArray-Objekten verfügbar. Sie können auch die Funktionen des Symbol-Typs verwenden.
entries()Experimentell-
Gibt einen
iteratorzurück, den Sie verwenden können, um die Liste der Schlüssel/Werte-Paare in der Liste durchzugehen. Jedes zurückgegebene Element ist ein Array, dessen erster Wert der Index und dessen zweiter Wert derXRInputSourcean diesem Index ist. forEach()Experimentell-
Iteriert über jedes Element in der Liste, in der Reihenfolge von zuerst bis zuletzt.
keys()Experimentell-
Eine Liste der Schlüssel, die den Einträgen in der Eingabequellen-Liste entsprechen.
values()Experimentell-
Gibt einen
iteratorzurück, den Sie verwenden können, um alle Werte in der Liste durchzugehen. Jedes Element ist ein einzelnesXRInputSource-Objekt.
Zusätzlich zu diesen Methoden können Sie Array-Notation verwenden, um Elemente in der Liste nach Index zuzugreifen. Zum Beispiel ruft der unten stehende Code-Schnipsel eine Funktion handleInput() auf und übergibt ihr das erste Element in der Eingabequellen-Liste, falls die Liste nicht leer ist.
let sources = xrSession.inputSources;
if (sources.length > 0) {
handleInput(sources[0]);
}
Spezifikationen
| Specification |
|---|
| WebXR Device API # xrinputsourcearray-interface |
Browser-Kompatibilität
Loading…