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.
visibilityState = xrSession.visibilityState;
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
- The virtual scene generated by the
XRSessionis not currently visible to the user, so its
requestAnimationFrame()callbacks are not being executed until the
visibilityStatechanges. Input controllers are not being handled for the session.
- The virtual scene rendered by the
XRSessionis 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.
- While the virtual scene rendered by the
XRSessionmay 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
requestAnimationFrame()callbacks at a throttled rate. Inut controllers are not being processed for the session.
|WebXR Device API
The definition of 'XRSession.visibilityState' in that specification.
|Working Draft||Initial definition.|
|Chrome No support No||Edge No support No||Firefox No support No||IE No support No||Opera No support No||Safari No support No||WebView Android No support No||Chrome Android No support No||Firefox Android No support No||Opera Android No support No||Safari iOS No support No||Samsung Internet Android No support No|
- No support
- No support