XRSession: свойство visibilityState

Только для чтения visibilityState свойство интерфейса XRSession — это строка, указывающая, видна ли в данный момент веб-XR-контент пользователю, и если видна, является ли он основным фокусом.

Каждый раз, когда состояние видимости изменяется, событие visibilitychange генерируется на объекте XRSession.

Строка, указывающая, виден ли XR-контент пользователю и, если виден, является ли он в данный момент основным фокусом.

Возможные значения visibilityState:

hidden

Виртуальная сцена, сгенерированная XRSession, в данный момент не видна пользователю, поэтому её requestAnimationFrame() обратные вызовы не выполняются, пока не изменится visibilityState. Устройства ввода для сессии не обрабатываются.

visible

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

visible-blurred

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

Важно помнить, что так как интерактивная сессия WebXR потенциально отображается на дисплее, отличном от HTML-документа, в котором она выполняется (например, при отображении на шлеме виртуальной реальности), значение visibilityState сессии необязательно совпадает со значением свойства document's visibilityState. Например, если пользователь использует шлем VR, подключённый к компьютеру, и интерактивная сцена скрыта интерфейсом настройки, пользователь может заглянуть из-за шлема и всё равно увидеть сам документ на мониторе компьютера.

• visibilitychange событие