XRSession: squeeze Ereignis

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

addEventListener("squeeze", (event) => {});

onsqueeze = (event) => {};

Ein XRInputSourceEvent. Erbt von Event.

Neben den unten aufgeführten Eigenschaften sind auch Eigenschaften der übergeordneten Schnittstelle Event verfügbar.

frame Schreibgeschützt

Ein XRFrame-Objekt, das die benötigten Informationen über den Ereignisrahmen bereitstellt, währenddessen das Ereignis aufgetreten ist. Dieser Frame könnte in der Vergangenheit gerendert worden sein und nicht der aktuelle Frame sein. Da dies ein Ereignis-Frame und kein Animations-Frame ist, können Sie nicht XRFrame.getViewerPose() darauf aufrufen; stattdessen verwenden Sie getPose().

inputSource Schreibgeschützt

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

Ausgelöst, wenn Benutzer den Controller drücken, eine Handbewegung machen, die das Greifen von etwas mimt, oder einen Trigger verwenden (drücken).

Das Ereignis squeezestart zeigt an, dass der Benutzer mit einer Squeeze-Aktion begonnen hat.

Wenn die primäre Squeeze-Aktion erfolgreich endet, wird eine squeeze-Ereignis an die Sitzung 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.

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 Momentaufnahme, die nicht ein fortlaufendes Tracking einer Aktivität beinhaltet. Wenn Sie ein Squeeze verfolgen müssen, das nicht sofortig ist, hören Sie auf die Ereignisse squeezestart und squeezeend, um festzustellen, 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-Ereignishandlereigenschaft 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);
    }
  }
};

• squeezestart und squeezeend Ereignis