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 aufgerufen wird.
Syntax
Verwenden Sie den Ereignisnamen in Methoden wie addEventListener()
oder setzen Sie eine Ereignisbehandlungseigenschaft.
addEventListener("selectend", (event) => { })
onselectend = (event) => { }
Ereignistyp
Ein XRInputSourceEvent
. Erbt von Event
.
Ereigniseigenschaften
Neben den unten aufgeführten Eigenschaften sind auch die Eigenschaften der übergeordneten Schnittstelle Event
verfügbar.
frame
Schreibgeschützt-
Ein
XRFrame
-Objekt, das die erforderlichen Informationen über den Ereignisrahmen bereitstellt, während dem das Ereignis aufgetreten ist. Dieser Rahmen kann in der Vergangenheit gerendert worden sein und muss kein aktueller Rahmen sein. Da es sich um einen Ereignis-Rahmen handelt und nicht um einen Animations-Rahmen, können Sie die MethodegetViewerPose()
vonXRFrame
nicht darauf aufrufen; verwenden Sie stattdessengetPose()
. inputSource
Schreibgeschützt-
Ein
XRInputSource
-Objekt, das angibt, welche Eingabequelle das Eingabeereignis erzeugt hat.
Beschreibung
Auslöser
Ausgelöst, wenn der Benutzer aufhört, Trigger oder Tasten zu drücken, ein Touchpad zu berühren, einen Sprachbefehl zu geben oder eine erkennbare Geste auszuführen, wenn er ein Videotracking-System oder einen Handcontroller mit Beschleunigungsmesser verwendet.
Anwendungsfälle
Die selectend
- und selectstart
-Ereignisse informieren Sie, wann Sie dem Benutzer etwas anzeigen könnten, das darauf hinweist, dass die primäre Aktion ausgeführt wird. Dies könnte das Zeichnen eines Controllers mit der aktiven Taste in einer neuen Farbe sein oder das Anzeigen des ausgewählten Objekts, das ergriffen und bewegt wird, beginnend mit dem Eintreffen von selectstart
und endend, 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 Abdrücken des Auslösers einer Waffe in einem Spiel, oder so umfangreich wie das Platzieren eines gezogenen Objekts an einer neuen Position.
Wenn Ihre primäre Aktion eine einfache Auslöseaktion ist und Sie nicht animieren müssen, während der Auslöser betätigt ist, können Sie die selectstart
- und selectend
-Ereignisse ignorieren und auf das Startevent reagieren.
Beispiele
Siehe das selectstart
-Ereignis für Beispielcode.
Spezifikationen
Specification |
---|
WebXR Device API # eventdef-xrsession-selectend |
WebXR Device API # dom-xrsession-onselectend |