XRSessionMode

WebXR Device API's XRSessionMode enumerated type defines the string values used to identify the possible kinds of session mode that can be used.

Values

immersive-ar

The session's output will be given exclusive access to the immersive device, but the rendered content will be blended with the real-world environment. The session's environmentBlendMode indicates the method to be used to blend the content together.

Important: immersive-ar mode is defined by the WebXR Augmented Reality Module, which is not yet stable and should not be used other than for testing and experimentation.

immersive-vr
Indicates that the rendered session will be displayed using an immersive XR device in VR mode; it is not intended to be overlaid or integrated into the surrounding environment. The environmentBlendMode is expected to be opaque if possible, but might be additive if the hardware requires it.
inline
The output is presented inline within the context of an element in a standard HTML document, rather than occupying the full visual space. Inline sessions can be presented in either mono or stereo mode, and may or may not have viewer tracking available. Inline sessions don't require special hardware and should be avalable on any user agent offering WebXR API support.

Usage notes

XRSessionMode type indicates the values that can be specified when calling XR.isSessionSupported() to determine whether or not the specified session type is supported and available to be used, and by requestSession() to attempt to open a new WebXR session.

immersive-ar mode supports all the same features and reference spaces that immersive-vr does, since both are immersive sessions. Browsers may support either or both of these modes, but if WebXR is available, the inline mode is always supported.

规范

规范 状态 Comment
WebXR 设备 API
The definition of 'XRSessionMode' in that specification.
工作草案 初始定义。
WebXR Augmented Reality Module
The definition of 'XRSessionMode: immersive-ar' in that specification.
编者草案 immersive-ar value added

浏览器兼容性

更新 GitHub 上的兼容性数据
Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari Android webview Chrome for Android Firefox for Android Opera for Android Safari on iOS Samsung Internet
XRSessionMode
Chrome 79 Edge 79 Firefox 不支持 No IE 不支持 No Opera 不支持 No Safari 不支持 No WebView Android 79 Chrome Android 79 Firefox Android 不支持 No Opera Android 不支持 No Safari iOS 不支持 No Samsung Internet Android 11.2
immersive-ar
Chrome 81 Edge 81 Firefox 不支持 No IE 不支持 No Opera 不支持 No Safari 不支持 No WebView Android ? Chrome Android 81 Firefox Android 不支持 No Opera Android 不支持 No Safari iOS 不支持 No Samsung Internet Android 12.1
immersive-vr
Chrome 79 Edge 79 Firefox 不支持 No IE 不支持 No Opera 不支持 No Safari 不支持 No WebView Android 79 Chrome Android 79 Firefox Android 不支持 No Opera Android 不支持 No Safari iOS 不支持 No Samsung Internet Android 11.2
inline
Chrome 79 Edge 79 Firefox 不支持 No IE 不支持 No Opera 不支持 No Safari 不支持 No WebView Android 79 Chrome Android 79 Firefox Android 不支持 No Opera Android 不支持 No Safari iOS 不支持 No Samsung Internet Android 11.2

图例

完整支持
完整支持
不支持
不支持
兼容性未知
兼容性未知
实验。期望将来行为有所改变。
实验。期望将来行为有所改变。