XRSession: squeezeend-Ereignis

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig, bevor Sie diese produktiv verwenden.

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Das WebXR-Ereignis squeezeend wird an eine XRSession gesendet, wenn eine ihrer Eingabequellen ihre primäre Aktion beendet oder wenn eine Eingabequelle, die gerade eine laufende primäre Aktion behandelt, getrennt wird, ohne die Aktion erfolgreich abzuschließen.

Zu den primären Squeeze-Aktionen gehören Dinge wie das Drücken von Triggern oder Tasten durch Benutzer, das Antippen eines Touchpads, das Aussprechen eines Befehls oder das Ausführen einer erkennbaren Geste bei der Verwendung eines Video-Tracking-Systems oder eines Handcontrollers mit einem Beschleunigungsmesser.

Syntax

Verwenden Sie den Ereignisnamen in Methoden wie addEventListener(), oder setzen Sie eine Ereignis-Handler-Eigenschaft.

js
addEventListener("squeezeend", (event) => {});

onsqueezeend = (event) => {};

Ereignistyp

Ein XRInputSourceEvent. Erbt von Event.

Event XRInputSourceEvent

Ereigniseigenschaften

Zusätzlich zu den unten aufgeführten Eigenschaften sind Eigenschaften der übergeordneten Schnittstelle, Event, verfügbar.

frame Nur lesbar

Ein XRFrame-Objekt, das die benötigten Informationen über den Ereignisframe bereitstellt, während das Ereignis auftrat. Dieser Frame könnte in der Vergangenheit gerendert worden sein, anstatt ein aktueller Frame zu sein. Da dies ein Ereignis-Frame und kein Animations-Frame ist, können Sie XRFrame.getViewerPose() nicht darauf aufrufen; verwenden Sie stattdessen getPose().

inputSource Nur lesbar

Ein XRInputSource-Objekt, das angibt, welche Eingabequelle das Eingabeereignis erzeugt hat.

Beschreibung

Auslöser

Ausgelöst, wenn Benutzer den Controller nicht mehr zusammendrücken, eine Handbewegung machen, die das Greifen von etwas imitiert, oder einen (drückenden) Trigger verwenden.

Anwendungsfälle

Das squeezestart-Ereignis wird gesendet, das anzeigt, dass der Benutzer eine Squeeze-Aktion begonnen hat.

Wenn die primäre Squeeze-Aktion erfolgreich beendet wird, wird der Sitzung ein squeeze-Ereignis gesendet.

Ein squeezeend-Ereignis wird gesendet, um anzuzeigen, dass die Squeeze-Aktion nicht mehr im Gange ist. Dies wird unabhängig davon gesendet, ob die Squeeze-Aktion erfolgreich war oder nicht.

Beispiele

Siehe das squeezestart-Ereignis für Beispielcode.

Spezifikationen

Specification
WebXR Device API
# eventdef-xrsession-squeezeend
WebXR Device API
# dom-xrsession-onsqueezeend

Browser-Kompatibilität

BCD tables only load in the browser