大网数据广告活动
Web 标准与前端开发

XRSession: visibilityState property

· 52CE 我爱测

The _read-only_ **`visibilityState`** property of the XRSession interface is a string indicating whether the WebXR content is currently visible to the user, and if it is, whether it's the primary focus.

WebXR Device API

The read-only visibilityState property of the XRSession interface is a string indicating whether the WebXR content is currently visible to the user, and if it is, whether it's the primary focus.

Every time the visibility state changes, a XRSession.visibilitychange_event event is fired on the XRSession object.

Value

A string indicating whether or not the XR content is visible to the user and if it is, whether or not it's currently the primary focus.

The possible values of visibilityState are:

  • hidden
    • : The virtual scene generated by the XRSession is not currently visible to the user, so its XRSession.requestAnimationFrame callbacks are not being executed until the visibilityState changes. Input controllers are not being handled for the session.
  • visible
    • : The virtual scene rendered by the XRSession is currently visible to the user and is the primary focus of the user's attention. To that end, the session's XRSession.requestAnimationFrame callbacks are being processed at the XR device's native refresh rate and input controllers are being processed as normal.
  • visible-blurred
    • : While the virtual scene rendered by the XRSession may currently be visible to the user, it is not the user's primary focus at the moment; it's also possible the session is not currently visible at all. In order to optimize resource utilization, the user agent may be handling the session's XRSession.requestAnimationFrame callbacks at a throttled rate. Input controllers are not being processed for the session.

Usage notes

It's important to keep in mind that because an immersive WebXR session is potentially being shown using a different display than the HTML document in which it's running (such as when being shown on a headset), the value of a session's visibilityState may not necessarily be the same as the owning document's Document.visibilityState. For instance, if the viewer is using a headset tethered to a computer and the immersive scene is obscured by a configuration UI, the user could peek out from behind the headset and still be able to see the document itself on their computer's monitor.

Specifications

Browser compatibility

See also

  • XRSession.visibilitychange_event event

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。