XRSession: событие squeezestart

Событие WebXR squeezestart отправляется в XRSession, когда пользователь начинает основное действие сжатия на одном из источников ввода.

Основные действия сжатия — это действия, предназначенные для имитации сжатия или схватывания руками, и их можно смоделировать с помощью триггеров на контроллерах.

Используйте имя события в методах, таких как addEventListener(), или установите свойство обработчика событий.

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

onsqueezestart = (event) => {};

An XRInputSourceEvent. Наследуется от Event.

Помимо перечисленных ниже свойств, доступны свойства родительского интерфейса Event.

frame Только для чтения

Объект XRFrame, предоставляющий необходимую информацию о кадре события во время его возникновения. Этот кадр мог быть рендерен ранее, а не в текущий момент. Поскольку это кадр события, а не кадр анимации, вы не можете вызвать XRFrame.getViewerPose() на нём; вместо этого используйте getPose().

inputSource Только для чтения

Объект XRInputSource, указывающий, какой источник ввода сгенерировал событие ввода.

Срабатывает, когда пользователь начинает сжимать контроллер, выполняя жест рукой, имитирующий захват объекта, или нажимая (сжимая) триггер.

Событие squeezestart отправляется, чтобы указать, что пользователь начал действие сжатия.

Если основное действие сжатия завершается успешно, сессия отправляет событие squeeze.

Событие squeezeend отправляется, чтобы указать, что действие сжатия больше не выполняется. Это отправляется независимо от того, было ли действие сжатия успешным или нет.

В следующем примере используется addEventListener() для создания обработчиков событий сжатия: squeezestart, squeezeend и squeeze. Этот фрагмент кода является ядром обработчика событий, позволяющего пользователю захватывать объекты в сцене и перемещать их.

В этом случае используется одна функция для обработки всех трех событий, что позволяет им использовать общие участки кода, не зависящие от типа события. Только после выполнения этих задач функция onSqueezeEvent() ниже вызывает специальную функцию для обработки действий.

После проверки, является ли полученное событие событием tracked-pointer (единственным типом, обрабатываемым здесь), позиция целевого луча получается с помощью getPose().

Если позиция целевого луча была успешно получена, код использует значение свойства Event type для перенаправления управления в соответствующую функцию обработки события:

• Для событий squeezestart вызывается функция myBeginTracking() с матрицей matrix позиции целевого луча. Функция myBeginTracking(), предположительно, запускает процесс захвата объекта, используя преобразование для выполнения проверки попадания, определяя, какой объект подхватить. myBeginTracking() возвращает объект, представляющий объект, который пользователь начал перетаскивать.
• При получении события squeeze вызывается функция myDropObject() с объектом как входом. Это помещает объект в его новое положение в мире и запускает любые эффекты, которые могут возникнуть, такие как планирование анимации всплеска при падении в воду и т. д.
• Событие squeezeend приводит к вызову функции myStopTracking() с перетаскиваемым объектом и преобразованием окончательной позиции целевого луча.

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;
  }
}

Также можно настроить обработчик этих событий, установив свойства обработчиков событий объекта XRSession в функцию, которая обрабатывает событие:

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