XRBoundedReferenceSpace: свойство boundsGeometry

Только для чтения XRBoundedReferenceSpace свойство boundsGeometry представляет собой массив объектов DOMPointReadOnly, которые определяют точки, образующие многоугольник, внутри которого разрешено перемещение зрителя. Каждая точка рассматривается как двумерная точка и должна располагаться на уровне земли (то есть её y координата должна быть 0).

Эта граница обычно настраивается пользователем с помощью программного обеспечения, которое управляет его XR-оборудованием. Это может быть выполнено путем обхода границы пространства, которое он хочет использовать, или путем рисования формы своей комнаты с помощью своего XR-устройства ввода. Теоретически, более продвинутая система может использовать датчики или другие методы обнаружения для определения границ отдельной XR-комнаты (обратите внимание, как мы осторожно не называем её голодеком?).

Свойство boundsGeometry — это массив объектов DOMPointReadOnly, каждый из которых определяет одну вершину многоугольника, внутри которого зритель должен оставаться. Каждая точка должна быть на уровне пола, и её y координата должна быть равна 0. Кроме того, значение w всегда равно 1 для каждой точки в массиве. Кроме того, точки обязательно должны быть перечислены в порядке обхода по часовой стрелке.

Каждый элемент в boundsGeometry соответствует элементу в списке точек геометрии собственных границ комнаты, умноженному на обратное значение смещения начала координат. Другими словами, границы представляют собой физические ограничения доступного пространства, смещённые таким образом, чтобы точки границ пространства отсчета были определены относительно эффективного начала координат XRBoundedReferenceSpace.

У ограниченных пространств отсчета начало координат всегда находится на уровне земли, где y равно 0. Как общее правило, начало координат для x и z расположено в или около центра пространства, а ориентация настроена на логическое направление вперёд, как это подходит для базовой платформы или XR-оборудования.

Для снижения риска использования границ комнаты в целях отпечатков пальцев каждая точка в массиве boundsGeometry может быть округлена или скорректирована на некоторое значение. Спецификация рекомендует сдвигать точки до ближайших 5 сантиметров (избегая выхода за пределы физических ограничений оборудования).

XRBoundedReferenceSpace не предназначен для использования с очень большими ограниченными областями. Вместо этого он предназначен для пространств одной комнаты с не более чем примерно 15 метрами доступного пространства перемещения в любом направлении от исходного значения.

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

Если вам нужно создать пространство с несколькими комнатами или очень большое пространство, или пространство, которое требует различных уровней пола, вы должны вместо этого использовать неограниченное XRReferenceSpace и сами применять ограничения, как это необходимо.

Форма, определённая boundsGeometry, может быть такой простой, как квадрат, или такой сложной, как необходимо, потенциально включая вогнутые и/или выпуклые участки.

Однако вы не можете представить пространства с неровными уровнями пола с помощью XRBoundedReferenceSpace. Земля всегда находится на уровне y = 0.

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

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