DieXRInputSourceEvent-Schnittstelle derWebXR Device API beschreibt ein Ereignis, das auf einem WebXR-Benutzereingabegerät, wie einem Handcontroller, einem Blickverfolgungssystem oder einem Bewegungserkennungssystem, aufgetreten ist. Genauer gesagt, repräsentieren sie eine Änderung im Zustand einerXRInputSource.

Um mehr über die Handhabung von Eingaben in einem WebXR-Projekt zu erfahren, lesen Sie den ArtikelEingaben und Eingabequellen.

Konstruktor

XRInputSourceEvent()

Erstellt und gibt ein neuesXRInputSourceEvent-Objekt zurück, dessen Eigenschaften denen im bereitgestellteneventInitDict-Wörterbuch entsprechen.

Instanz-Eigenschaften

frameSchreibgeschützt

EinXRFrame-Objekt, das die benötigten Informationen über den Ereignisrahmen bereitstellt, in dem das Ereignis aufgetreten ist. Dieser Rahmen könnte in der Vergangenheit gerendert worden sein, anstatt ein aktueller Rahmen zu sein. Da dies einEreignisrahmen ist, nicht einAnimationsrahmen, können Sie dieXRFrame-MethodegetViewerPose() nicht darauf aufrufen; verwenden Sie stattdessengetPose().

inputSourceSchreibgeschützt

EinXRInputSource-Objekt, das angibt, welche Eingabequelle das Eingabeereignis erzeugt hat.

Instanz-Methoden

DieXRInputSourceEvent-Schnittstelle definiert keine Methoden; jedoch werden mehrere Methoden von der Elternschnittstelle,Event, geerbt.

Ereignisarten

select

Wird an eineXRSession gesendet, wenn die sendende Eingabequelle eineprimäre Aktion vollständig abgeschlossen hat.

selectend

Wird an eineXRSession gesendet, wenn eine laufendeprimäre Aktion endet oder wenn eine Eingabequelle mit einer laufenden primären Aktion vom System getrennt wurde.

selectstart

Wird an eineXRSession gesendet, wenn eine Eingabequelle ihreprimäre Aktion beginnt, was darauf hinweist, dass der Benutzer mit einem befehlsähnlichen Eingang begonnen hat, z. B. das Drücken eines Triggers oder Knopfes, das Aussprechen eines Sprachbefehls, das Tippen auf ein Touchpad oder Ähnliches.

squeeze

Wird an eineXRSession gesendet, wenn die sendende Eingabequelle eineprimäre Quetschaktion vollständig abgeschlossen hat.

squeezeend

Wird an eineXRSession gesendet, wenn eine laufendeprimäre Quetschaktion endet oder wenn eine Eingabequelle mit einer laufenden primären Quetschaktion getrennt wird.

squeezestart

Wird an eineXRSession gesendet, wenn eine Eingabequelle ihreprimäre Quetschaktion beginnt, was darauf hinweist, dass der Benutzer begonnen hat, den Controller zu greifen, zu quetschen oder zu fassen.

Beispiele

Der untenstehende Code richtet Handler für primäre Aktionsereignisse ein, um festzustellen, wann der Benutzer auf Objekte in der Szene klickt (schießt/anstupst/was auch immer).

xrSession.addEventListener("select", (event) => {  let targetRayPose = event.frame.getPose(    event.inputSource.targetRaySpace,    myRefSpace,  );  if (targetRayPose) {    let hit = myHitTest(targetRayPose.transform);    if (hit) {      /* handle the hit */    }  }});

Spezifikationen

Browser-Kompatibilität