XRInputSource: свойство handedness

Только для чтения XRInputSource свойство handedness указывает, с какой из рук пользователя связан источник ввода WebXR, или же если он вообще не связан с рукой.

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

none

Контроллер ввода не связан ни с одной из рук пользователя.

left

Контроллер ввода находится в левой руке пользователя, надет на неё или прикреплён к ней.

right

Контроллер ввода находится в правой руке пользователя, надет на неё или прикреплён к ней.

Если источник ввода не связан с рукой пользователя (независимо от того, держится ли он, прикреплён или надет), значение handedness равно none. Это может указывать, например, на источник ввода, который не используется для управления рукой, например, на элементы управления, встроенные в гарнитуру или на устройство ввода, прикреплённое к голове или телу.

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

function updateInputSources(session, frame, refSpace) {
  for (const source of session.inputSources) {
    if (source.gripSpace) {
      const gripPose = frame.getPose(source.gripSpace, refSpace);

      if (gripPose) {
        myRenderHandObject(gripPose, inputSource.handedness);
      }
    }
  }
}

Эта функция, которая вызывается в каждом кадре анимации (или, возможно, периодически, в зависимости от требуемой плавности и ограничений производительности), сканирует список источников ввода, ища те, у которых gripSpace не равно null. Если gripSpace присутствует, это означает, что источник ввода — это устройство, управляемое рукой, поэтому его следует отображать, если это возможно.

Если gripSpace не равно null, функция продолжает получать позу gripSpace и преобразовывает её в текущее пространство отсчёта. Предполагая, что это значение является корректным, вызывается функция myRenderHandObject() с позой захвата и значением handedness. Затем рисуется соответствующая модель, позиционированная и сформированная для правильной руки.

• API устройств WebXR
• Ввод и источники ввода
• Использование геймпадов в приложениях WebXR