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, 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 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.
addEventListener("selectend", (event) => {});
onselectend = (event) => {};
Ereignistyp
Ein XRInputSourceEvent
. Erbt von Event
.
Ereigniseigenschaften
Neben den unten aufgeführten Eigenschaften sind Eigenschaften der Elternschnittstelle Event
verfügbar.
frame
Nur lesbar-
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 dieXRFrame
-MethodegetViewerPose()
nicht darauf aufrufen; stattdessen verwenden SiegetPose()
. inputSource
Nur lesbar-
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