XRSession: squeeze-Ereignis
Eingeschränkt verfügbar
Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.
Want more browser support for this feature? Tell us why.
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 squeeze Ereignis wird an eine XRSession gesendet, wenn eine der Eingabequellen der Sitzung eine primäre Squeeze-Aktion abgeschlossen hat. Beispiele für häufige Arten von primären Aktionen sind das Drücken von Triggern oder Tasten durch Benutzer, das Tippen auf ein Touchpad, das Aussprechen eines Befehls oder das Ausführen einer erkennbaren Geste bei der Verwendung eines Video-Tracking-Systems oder eines Handcontrollers mit einem Beschleunigungsmesser.
Für Details zur Funktionsweise der Ereignisse squeezestart, squeeze und squeezeend und wie Sie darauf reagieren sollten, siehe Eingaben und Eingabequellen.
Syntax
Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder legen Sie eine Ereignishandler-Eigenschaft fest.
addEventListener("squeeze", (event) => { })
onsqueeze = (event) => { }
Ereignistyp
Ein XRInputSourceEvent. Erbt von Event.
Beschreibung
Auslöser
Ausgelöst, wenn Benutzer den Controller drücken, eine Handgeste ausführen, die das Greifen von etwas nachahmt, oder einen Auslöser verwenden (drücken).
Anwendungsfälle
Das squeezestart Ereignis zeigt an, dass der Benutzer eine Squeeze-Aktion begonnen hat.
Wenn die primäre Squeeze-Aktion erfolgreich endet, wird der Sitzung ein squeeze Ereignis gesendet.
Ein squeezeend Ereignis wird gesendet, um anzuzeigen, dass die Squeeze-Aktion nicht mehr im Gange ist. Dies wird gesendet, unabhängig davon, ob die Squeeze-Aktion erfolgreich war oder nicht.
Beispiele
Das folgende Beispiel verwendet addEventListener(), um einen Handler für das squeeze Ereignis einzurichten. Der Handler ruft die Pose ab, die den Zielstrahl für tracked-pointer Eingaben darstellt, und sendet die Transformation der Pose an eine Funktion namens myHandleSqueezeWithRay().
Dieser Code behandelt das Squeeze als eine momentane Aktion, die keine laufende Aktivität verfolgt. Wenn Sie eine Squeeze-Aktion verfolgen müssen, die nicht sofort abgeschlossen ist, hören Sie auf die Ereignisse squeezestart und squeezeend, um zu erkennen, wann die Squeeze-Aktion beginnt und endet.
xrSession.addEventListener("squeeze", (event) => {
if (event.inputSource.targetRayMode === "tracked-pointer") {
let targetRayPose = event.frame.getPose(
event.inputSource.targetRaySpace,
myRefSpace,
);
if (targetRayPose) {
myHandleSqueezeWithRay(targetRayPose.transform);
}
}
});
Sie können auch einen Handler für squeeze Ereignisse einrichten, indem Sie die onsqueeze Ereignishandler-Eigenschaft des XRSession Objekts auf eine Funktion setzen, die das Ereignis behandelt:
xrSession.onsqueeze = (event) => {
if (event.inputSource.targetRayMode === "tracked-pointer") {
let targetRayPose = event.frame.getPose(
event.inputSource.targetRaySpace,
myRefSpace,
);
if (targetRayPose) {
myHandleSqueezeWithRay(targetRayPose.transform);
}
}
};
Spezifikationen
| Spezifikation |
|---|
| WebXR Device API # eventdef-xrsession-squeeze |
| WebXR Device API # dom-xrsession-onsqueeze |
Browser-Kompatibilität
Siehe auch
squeezestartundsqueezeendEreignis