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.

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

onselectend = (event) => { }

Ereignistyp

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 Methode getViewerPose() von XRFrame nicht darauf aufrufen; verwenden Sie stattdessen getPose().

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

Browser-Kompatibilität

Siehe auch