XRSession: метод requestReferenceSpace()

Метод requestReferenceSpace() интерфейса XRSession возвращает promise, который разрешается экземпляром либо XRReferenceSpace, либо XRBoundedReferenceSpace в зависимости от типа запрошенного пространства ссылок.

type

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

A Promise, который разрешается объектом XRReferenceSpace.

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

bounded-floor

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

local

XRReferenceSpace пространство отслеживания, чья родная точка отсчёта расположена рядом с положением зрителя на момент создания сеанса. Точное положение зависит от платформы и реализации. От пользователя не ожидается перемещения далеко от исходной позиции, и отслеживание оптимизировано для этого случая. Для устройств с отслеживанием в шести степенях свободы (6DoF) пространство ссылок local стремится поддерживать стабильность начала отсчёта по отношению к окружающей среде.

local-floor

XRReferenceSpace, подобный типу local, за исключением того, что начальная позиция размещается в безопасном месте для зрителя, где значение оси y равно 0 на уровне пола. Если уровень пола неизвестен, пользовательский агент unbounded оценит уровень пола. Если оценённый уровень пола отличен от нуля, браузер должен его округлить таким образом, чтобы избежать отслеживания (вероятно, до ближайшего сантиметра).

unbounded

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

viewer

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

Вместо выброса истинных исключений, requestReferenceSpace() отклоняет возвращённый промис с DOMException, чьё имя находится в списке ниже:

NotSupportedError

Запрошенное пространство ссылок не поддерживается.