XRInputSourceEvent: свойство frame

Только для чтения XRInputSourceEvent свойство frame определяет объект XRFrame, представляющий кадр события, во время которого произошёл пользовательский ввод WebXR. Следовательно, это может быть событие, которое произошло в прошлом, а не текущее или предстоящее событие.

Объект XRFrame, указывающий на кадр события, в котором произошло событие пользовательского ввода, описанное объектом.

Кадр события не соответствует визуальному кадру, который передаётся в функцию обратного вызова рендеринга кадра (см. Рендеринг и обратный вызов рендеринга кадра WebXR для получения подробной информации об обратном вызове). Вместо этого, XRFrame указанное frame свойством, — это способ предоставления доступа к методу getPose(), который можно использовать для получения относительных позиций объектов в сцене в момент возникновения события.

Однако, поскольку кадр события не является кадром анимации, позиция зрителя недоступна для представления текущей точки зрения зрителя; результаты вызова getViewerPose() будут XRViewerPose со списком views пустым.

Этот код демонстрирует обработчик события selectstart, который получает позицию целевого луча из кадра, отображая позицию, представляющую луч (event.inputSource.targetRaySpace) в общем пространстве отсчёта myRefSpace.

Затем, если результат не null, преобразование целевой позиции луча передаётся в функцию myCheckAndHandleHit() для проверки, был ли луч направлен на что-либо при срабатывании выбора.

xrSession.onselectstart = (event) => {
  let targetRayPose = event.frame.getPose(
    event.inputSource.targetRaySpace,
    myRefSpace,
  );
  if (targetRayPose) {
    checkAndHandleHit(targetRayPose.transform);
  }
};