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.

length Schreibgeschützt

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()

Gibt einen iterator zurü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 der XRInputSource an diesem Index ist.

forEach()

Iteriert über jedes Element in der Liste, in der Reihenfolge von zuerst bis zuletzt.

keys()

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

values()

Gibt einen iterator zurück, den Sie verwenden können, um alle Werte in der Liste durchzugehen. 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 unten stehende Code-Schnipsel eine Funktion handleInput() auf und übergibt ihr das erste Element in der Eingabequellen-Liste, falls die Liste nicht leer ist.

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

Spezifikationen

Specification
WebXR Device API
# xrinputsourcearray-interface

Browser-Kompatibilität