在此页

• 句法
• 用法注意事项
• 规范
• 浏览器兼容性
• 另请参阅
• 相关话题

安全上下文
此特征只可用于 安全上下文 (HTTPS)，在某些或所有 支持浏览器 .

只读 visibilityState 特性为 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 visibilitychange event is fired on the XRSession 对象。

句法

visibilityState = xrSession.visibilityState;
					

值

A DOMString containing one of the values defined in the enumerated type XRVisibilityState ; this string indicates 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 是：

hidden

The virtual scene generated by the XRSession is not currently visible to the user, so its 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 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 用户代理 may be handling the session's requestAnimationFrame() callbacks at a throttled rate. Input controllers are not being processed for the session.

用法注意事项

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 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.

规范

规范	状态	注释
WebXR 设备 API The definition of 'XRSession.visibilityState' in that specification.	工作草案	初始定义。

浏览器兼容性

更新 GitHub 上的兼容性数据

	桌面						移动
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
visibilityState	Chrome 79	Edge 79	Firefox 不支持 No	IE 不支持 No	Opera 不支持 No	Safari 不支持 No	WebView Android 不支持 No	Chrome Android 79	Firefox Android 不支持 No	Opera Android 不支持 No	Safari iOS 不支持 No	Samsung Internet Android 11.2

图例

完整支持

完整支持

不支持

不支持

另请参阅

• XRSession.onvisibilitychange
• visibilitychange event

元数据

• 最后修改： Mar 30, 2020

相关话题

1. WebXR 设备 API
2. XRSession
3. 特性

   1. environmentBlendMode
   2. inputSources
   3. renderState
   4. visibilityState
4. 方法

   1. cancelAnimationFrame()
   2. end()
   3. requestAnimationFrame()
   4. requestReferenceSpace()
   5. updateRenderState()
5. 事件

   1. selectend
   2. selectstart
   3. squeeze
   4. squeezeend
   5. squeezestart
6. 继承：

   1. EventTarget
7. Related pages for WebXR Device API

   1. Navigator.xr
   2. WebGLRenderingContext.makeXRCompatible()
   3. XR
   4. XRBoundedReferenceSpace
   5. XRFrame
   6. XRInputSource
   7. XRInputSourceArray
   8. XRInputSourceEvent
   9. XRInputSourcesChangeEvent
   10. XRPose
   11. XRReferenceSpace
   12. XRReferenceSpaceEvent
   13. XRRenderState
   14. XRRigidTransform
   15. XRSessionEvent
   16. XRSpace
   17. XRView
   18. XRViewerPose
   19. XRViewport
   20. XRWebGLLayer