Secure contextThis feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
The WebXR Device API's XRBoundedReferenceSpace
interface describes a virtual world reference space which has preset boundaries. This extends XRReferenceSpace
, which describes an essentially unrestricted space around the viewer's position. These bounds are defined using an array of points, each of which defines a vertex in a polygon inside which the user is allowed to move.
This is typically used when the XR system is capable of tracking the user's physical movement within a limited distance of their starting position. The specified bounds may, in fact, describe the shape and size of the room the user is located in, in order to let the WebXR site or application prevent the user from colliding with the walls or other obstacles in the real world. At a minimum, the boundaries indicate the area in which the XR device is capable of tracking the user's movement. See the article Using bounded reference spaces for details on how bounded spaces work and why they're useful.
Properties
In addition to the properties of XRReferenceSpace
, XRBoundedReferenceSpace
includes the following:
boundsGeometry
Read only- An array of
DOMPointReadOnly
objects, each of which defines a vertex in the polygon defining the boundaries within which the user will be required to remain. These vertices must be sorted such that they move clockwise around the viewer's position.
Methods
XRBoundedReferenceSpace
inherits the methods of its parent interface, XRReferenceSpace
. It has no further methods.
Specifications
Specification | Status | Comment |
WebXR Device APIThe definition of 'XRBoundedReferenceSpace' in that specification. | Working Draft | Initial definition. |
Browser compatibility
The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Update compatibility data on GitHub
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Chrome
Full support 79 |
Edge
Full support 79 |
Firefox
No support No |
IE
No support No |
Opera
No support No |
Safari
No support No |
WebView Android
No support No |
Chrome Android
Full support 79 |
Firefox Android
No support No |
Opera Android
No support No |
Safari iOS
No support No |
Samsung Internet Android
Full support 11.2 |
Chrome
Full support 79 |
Edge
Full support 79 |
Firefox
No support No |
IE
No support No |
Opera
No support No |
Safari
No support No |
WebView Android
No support No |
Chrome Android
Full support 79 |
Firefox Android
No support No |
Opera Android
No support No |
Safari iOS
No support No |
Samsung Internet Android
Full support 11.2 |
Legend
- Full support
- Full support
- No support
- No support
- Experimental. Expect behavior to change in the future.'
- Experimental. Expect behavior to change in the future.
See also
- WebXR Device API
- Geometry and reference spaces in WebXR
- Viewpoints and viewers: simulating cameras in WebXR
XRBoundedReferenceSpace by Mozilla Contributors is licensed under CC-BY-SA 2.5.