XRSession: squeezestart-Ereignis

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

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

onsqueezestart = (event) => {};

Ein XRInputSourceEvent. Erbt von Event.

Neben den unten aufgeführten Eigenschaften sind auch 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 aufgetreten ist. Dieser Rahmen könnte in der Vergangenheit gerendert worden sein und ist nicht zwingend ein aktueller Rahmen. Da es sich um einen Ereignis-Rahmen handelt und nicht um einen Animations-Rahmen, kann XRFrame.getViewerPose() nicht darauf aufgerufen werden; nutzen Sie stattdessen getPose().

inputSource Nur lesbar

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

Wird ausgelöst, wenn Benutzer anfangen, den Controller zu drücken, eine Handbewegung zu machen, die das Greifen von etwas imitiert, oder einen Trigger zu betätigen.

Das squeezestart-Ereignis wird gesendet, um anzuzeigen, dass der Benutzer eine Quetschaktion begonnen hat.

Wenn die primäre Quetschaktion erfolgreich abgeschlossen wird, erhält die Sitzung ein squeeze-Ereignis.

Ein squeezeend-Ereignis wird gesendet, um anzuzeigen, dass die Quetschaktion nicht mehr läuft. Dies wird unabhängig davon gesendet, ob die Quetschaktion erfolgreich war oder nicht.

Das folgende Beispiel verwendet addEventListener(), um Handler für die Quetschereignisse einzurichten: squeezestart, squeezeend und squeeze. Dieses Snippet bildet den Kern eines Ereignis-Handlers, der es dem Benutzer ermöglicht, Objekte in der Szene zu greifen und zu bewegen.

In diesem Fall wird eine einzelne Funktion verwendet, um alle drei Ereignisse zu behandeln, wodurch sie bestimmten Code teilen können, der unabhängig davon identisch ist, welches der drei Ereignisse empfangen wird. Erst nach Abschluss dieser Aufgaben leitet die Funktion onSqueezeEvent() die Aktion an eine spezialisierte Funktion weiter, um die Dinge zu handhaben.

Nach der Überprüfung, dass das empfangene Ereignis ein tracked-pointer-Ereignis ist (die einzige Art, die wir hier behandeln), wird die Pose des Zielstrahls mit getPose() ermittelt.

Wenn die Zielstrahlpose erfolgreich abgerufen wurde, verwendet der Code den Wert der type-Eigenschaft des Event, um die Steuerung an eine geeignete Funktion zur Behandlung des eingetroffenen Ereignisses zu übergeben:

• Für squeezestart-Ereignisse wird eine myBeginTracking()-Funktion mit der matrix der Zielstrahlpose aufgerufen. Die Funktion myBeginTracking() würde vermutlich den Prozess des Objektziehens starten, indem der Transformator zum Durchführen eines Hit-Tests verwendet wird, um zu bestimmen, welches Objekt aufgehoben wird. myBeginTracking() gibt ein Objekt zurück, das das Objekt repräsentiert, das der Benutzer zu ziehen begonnen hat.
• Beim Empfang eines squeeze-Ereignisses wird die Funktion myDropObject() mit dem Zielobjekt und dem aktuellen Transformator der Zielstrahlpose aufgerufen. Dies platziert das Objekt in seiner neuen Position in der Welt und löst mögliche Effekte aus, wie das Planen einer Animation eines Spritzers, falls es ins Wasser fällt, usw.
• Das squeezeend-Ereignis führt dazu, dass eine myStopTracking()-Funktion mit dem sich in der Bewegung befindlichen Objekt und dem finalen Transformator der Zielstrahlpose aufgerufen wird.

xrSession.addEventListener("squeezestart", onSqueezeEvent);
xrSession.addEventListener("squeeze", onSqueezeEvent);
xrSession.addEventListener("squeezeend", onSqueezeEvent);

function onSqueezeEvent(event) {
  let source = event.inputSource;
  let targetObj = null;

  if (source.targetRayMode !== "tracked-pointer") {
    return;
  }

  let targetRayPose = event.frame.getPose(source.targetRaySpace, myRefSpace);
  if (!targetRayPose) {
    return;
  }

  switch (event.type) {
    case "squeezestart":
      targetObj = myBeginTracking(targetRayPose.matrix);
      break;
    case "squeeze":
      myDropObject(targetObj, targetRayPose.matrix);
      break;
    case "squeezeend":
      myStopTracking(targetObj, targetRayPose.matrix);
      break;
  }
}

Sie können auch einen Handler für diese Ereignisse einrichten, indem Sie die Ereignis-Handler-Eigenschaften des XRSession-Objekts auf eine Funktion setzen, die das Ereignis behandelt:

xrSession.onsqueezestart = onSqueezeEvent;
xrSession.onsqueeze = onSqueezeEvent;
xrSession.onsqueezeend = onSqueezeEvent;