XRInputSourcesChangeEvent: XRInputSourcesChangeEvent()-Konstruktor

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.

Der XRInputSourcesChangeEvent()- Konstruktor erstellt und gibt ein neues XRInputSourcesChangeEvent-Objekt zurück, das eine Aktualisierung der Liste der verfügbaren WebXR-Eingabegeräte darstellt. Sie werden diesen Konstruktor normalerweise nicht selbst aufrufen, da diese Ereignisse vom WebXR-System erstellt und an Sie gesendet werden.

Syntax

js
new XRInputSourcesChangeEvent(type, options)

Parameter

type

Ein Zeichenfolgenwert mit dem Namen des Ereignisses. Es ist groß- und kleinschreibungssensitiv und Browser setzen es immer auf inputsourceschange.

options

Ein Objekt, das zusätzlich zu den in Event() definierten Eigenschaften die folgenden Eigenschaften haben kann:

added

Ein Array von null oder mehr XRInputSource-Objekten, die jeweils ein neu verfügbares Eingabegerät darstellen.

removed

Ein Array von null oder mehr XRInputSource-Objekten, die die nicht mehr verfügbaren Eingabegeräte darstellen.

session

Die XRSession, auf die sich das Ereignis bezieht.

Rückgabewert

Ein neues XRInputSourcesChangeEvent-Objekt, das basierend auf den bereitgestellten Eingabeparametern konfiguriert wird.

Beispiele

Der folgende Codeausschnitt erstellt ein neues XRInputSourcesChangeEvent- Objekt, das anzeigt, dass eine einzelne neue Eingabequelle, beschrieben durch ein XRInputSource-Objekt namens newInputSource, dem System hinzugefügt wurde.

js
let iscEvent = new XRInputSourcesChangeEvent("inputsourceschange", {
  session: xrSession,
  added: [newInputSource],
  removed: [],
});

Spezifikationen

Specification
WebXR Device API
# dom-xrinputsourceschangeevent-xrinputsourceschangeevent

Browser-Kompatibilität

BCD tables only load in the browser