XRSession: squeezeend Event

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 vor der Verwendung auf produktiven Webseiten.

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 mit dem Bearbeiten einer laufenden primären Aktion beschäftigt ist, getrennt wird, ohne die Aktion erfolgreich abzuschließen.

Primäre Quetschaktionen umfassen Dinge wie das Drücken von Auslösern oder Tasten, das Tippen auf ein Touchpad, das Sprechen eines Befehls oder das Ausführen einer erkennbaren Geste bei der Verwendung eines Videoverfolgungssystems oder eines Handcontrollers mit Beschleunigungssensor.

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

Neben den unten aufgeführten Eigenschaften sind auch die Eigenschaften der Elternschnittstelle, Event, verfügbar.

frame Schreibgeschützt

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

inputSource Schreibgeschützt

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

Beschreibung

Auslöser

Wird ausgelöst, wenn Benutzer aufhören, den Controller zu drücken, eine Handbewegung ausführen, die das Greifen von etwas imitiert, oder einen Auslöser verwenden (drücken).

Anwendungsfälle

Das squeezestart-Ereignis wird gesendet, um anzuzeigen, dass der Benutzer eine Quetschaktion begonnen hat.

Wenn die primäre Quetschaktion erfolgreich endet, erhält die Sitzung ein squeeze-Ereignis.

Ein squeezeend-Ereignis wird gesendet, um anzuzeigen, dass die Quetschaktion nicht mehr im Gange ist. Dies wird gesendet, unabhängig davon, ob die Quetschaktion 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