XRSession: событие squeeze

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

Подробную информацию о работе событий squeezestart, squeeze, и squeezeend и о том, как на них реагировать, см. в разделе Источники ввода и ввода.

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

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

onsqueeze = (event) => {};

Объект XRInputSourceEvent. Наследует от Event.

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

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

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

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

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

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

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

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

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

В следующем примере используется addEventListener() для настройки обработчика события squeeze. Обработчик извлекает позу, представляющую целевой луч для tracked-pointer ввода, и отправляет преобразование позы в функцию под названием myHandleSqueezeWithRay().

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

xrSession.addEventListener("squeeze", (event) => {
  if (event.inputSource.targetRayMode === "tracked-pointer") {
    let targetRayPose = event.frame.getPose(
      event.inputSource.targetRaySpace,
      myRefSpace,
    );
    if (targetRayPose) {
      myHandleSqueezeWithRay(targetRayPose.transform);
    }
  }
});

Вы также можете настроить обработчик для событий squeeze, задав свойство обработчика события onsqueeze объекта XRSession в функцию, которая обрабатывает событие:

xrSession.onsqueeze = (event) => {
  if (event.inputSource.targetRayMode === "tracked-pointer") {
    let targetRayPose = event.frame.getPose(
      event.inputSource.targetRaySpace,
      myRefSpace,
    );
    if (targetRayPose) {
      myHandleSqueezeWithRay(targetRayPose.transform);
    }
  }
};

• squeezestart и squeezeend событие