VRDisplayEvent: свойство reason

Устаревшее: Эта функция больше не рекомендуется. Хотя некоторые браузеры могут её всё ещё поддерживать, она может быть уже удалена из соответствующих веб-стандартов, может быть в процессе удаления или может поддерживаться только для совместимости. Избегайте её использования и, если возможно, обновите существующий код; см. таблицу совместимости внизу этой страницы, чтобы принять решение. Имейте в виду, что эта функция может перестать работать в любое время.

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

Чтение только свойство reason интерфейса VRDisplayEvent возвращает удобочитаемое описание причины, по которой было выполнено событие.

Примечание: Это свойство было частью старого API WebVR. Оно было заменено API WebXR Device.

Значение

Строка, представляющая причину срабатывания события. Доступные причины определены в перечислении VRDisplayEventReason и таковы:

mounted — VRDisplay обнаружил, что пользователь надел его (или оно было активировано иным образом).
navigation — К странице перешли из контекста, который позволяет ей сразу начать презентацию, например, с другого сайта, который уже находился в режиме VR-презентации.
requested — Пользовательский агент запросил запуск режима VR-презентации. Это позволяет пользовательским агентам включать согласованный интерфейс для входа в VR на разных сайтах.
unmounted — VRDisplay обнаружил, что пользователь снял его (или оно было отключено/переведено в режим ожидания).

Примеры

window.addEventListener("vrdisplaypresentchange", (e) => {
  console.log(
    `Display ${e.display.displayId} presentation has changed. Reason given: ${e.reason}.`,
  );
});

Спецификации

Это свойство было частью старого API WebVR, которое было заменено API WebXR Device. Оно больше не находится на пути к стандартизации.

Пока все браузеры не реализуют новые API WebXR, рекомендуется полагаться на фреймворки, такие как A-Frame, Babylon.js или Three.js, или полифилл, для разработки приложений WebXR, которые будут работать во всех браузерах. Прочитайте руководство Meta's Porting from WebVR to WebXR для получения дополнительной информации.

Совместимость с браузерами

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari на IOS	Samsung Internet	WebView Android
`reason`	Нет	15–79	98 64–98 Поддержка macOS была включена в Firefox 64. 55–98 Поддержка Windows была включена в Firefox 55.	Нет	Нет	Нет	55–98	Нет	Нет	6.0 Google Cardboard поддерживается в Samsung Internet 7.0.	Нет

См. также

WebVR API

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/VRDisplayEvent/reason