XRInputSourceEvent: XRInputSourceEvent() 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 XRInputSourceEvent()-Konstruktor erstellt und gibt ein neues XRInputSourceEvent-Objekt zurück, das ein Ereignis (einen Statuswechsel) beschreibt, das auf einem WebXR-Benutzereingabegerät aufgetreten ist, das durch eine XRInputSource dargestellt wird.

Syntax

js
new XRInputSourceEvent(type, options)

Parameter

type

Ein String mit dem Namen des Ereignisses. Es ist groß-/kleinschreibungssensitiv und Browser setzen es auf select, selectend, selectstart, squeeze, squeezeend, squeezestart.

options

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

frame

Ein XRFrame-Objekt, das den Ereignisrahmen darstellt, während dessen das Ereignis stattgefunden hat. Dieses Ereignis ist nicht mit dem Animationsprozess verbunden und enthält keine Betrachterinformationen.

inputSource

Ein XRInputSource-Objekt, das das Eingabegerät repräsentiert, von dem das Ereignis gesendet wird.

Rückgabewert

Ein neues XRInputSourceEvent-Objekt, das das durch den angegebenen type und eventInitDict beschriebene Ereignis repräsentiert.

Beispiele

Dieses Beispiel erstellt ein neues select-Ereignis und sendet es an die XRSession.

js
let event = new XRInputSourceEvent("select", {
  frame: eventFrame,
  inputSource: source,
});
if (event) {
  xrSession.dispatchEvent(event);
}

Spezifikationen

Specification
WebXR Device API
# dom-xrinputsourceevent-xrinputsourceevent

Browser-Kompatibilität

BCD tables only load in the browser