XRSession: selectend 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 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 selectend 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 bearbeitet, getrennt wird, ohne die Aktion erfolgreich abzuschließen.

Das beforexrselect wird vor diesem Ereignis ausgelöst und kann verhindern, dass dieses Ereignis ausgelöst wird.

Syntax

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

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

onselectend = (event) => {};

Ereignistyp

Ereigniseigenschaften

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

frame Schreibgeschützt

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

inputSource Schreibgeschützt

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

Beschreibung

Auslöser

Ausgelöst, wenn der Benutzer aufhört, Abzüge oder Knöpfe zu drücken, ein Touchpad zu berühren, einen Befehl zu sprechen oder eine erkennbare Geste auszuführen, wenn er ein Videotracking-System oder einen Handcontroller mit einem Beschleunigungsmesser verwendet.

Anwendungsfälle

Die Ereignisse selectend und selectstart zeigen an, wann Sie dem Benutzer anzeigen möchten, dass die primäre Aktion ausgeführt wird. Dies könnte das Zeichnen eines Controllers mit aktiviertem Button in neuer Farbe sein oder das Darstellen des zielgerichteten Objekts, das gegriffen und bewegt wird. Dies beginnt, wenn selectstart eintrifft und endet, wenn selectend empfangen wird.

Das select-Ereignis ist das Ereignis, das Ihrem Code mitteilt, dass der Benutzer die gewünschte Aktion abgeschlossen hat. Dies könnte so einfach sein wie das Werfen eines Objekts oder das Drücken des Abzugs einer Waffe in einem Spiel oder so komplex wie das Platzieren eines gezogenen Objekts an einem neuen Ort.

Wenn Ihre primäre Aktion eine einfache Auslöseraktion ist und Sie nichts animieren müssen, während der Auslöser betätigt wird, können Sie die selectstart- und selectend-Ereignisse ignorieren und auf das Start-Ereignis reagieren.

Beispiele

Siehe das Ereignis selectstart für Beispielcode.

Spezifikationen

Specification
WebXR Device API
# eventdef-xrsession-selectend
WebXR Device API
# dom-xrsession-onselectend

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch