Draft
This page is not complete.
Secure context
This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
The XRSpace
interface of the WebXR Device API is an abstract interface providing a common basis for every class which represents a virtual coordinate system within the virtual world, in which its origin corresponds to a physical location. Spatial data in WebXR is always expressed relative to an object based upon one of the descendant interfaces of XRSpace
, at the time at which a given XRFrame
takes place.
Numeric values such as pose positions are thus coordinates in the corresponding XRSpace
, relative to that space's origin.
Note: The XRSpace
interface is never used directly; instead, all spaces are created using one of the interfaces based on XRSpace
. At this time, those are XRReferenceSpace
and XRBoundedReferenceSpace
.
Interfaces based on XRSpace
Below is a list of interfaces based on the XRSpace
interface.
XRBoundedReferenceSpace
- Represents a reference space which may move within a region of space whose borders are defined by an array of points laid out in clockwise order along the floor to define the passable region of the space. The origin of an
XRBoundedReferenceSpace
is always at floor level, with its X and Z coordinates typically defaulting to a location near the room's center. XRReferenceSpace
- Represents a reference space which is typically expected to remain static for the duration of the
XRSession
. While objects may move within the space, the space itself remains fixed in place. There are exceptions to this static nature; most commonly, anXRReferenceSpace
may move in order to adjust based on reconfiguration of the user's headset or other motion-sensitive device.
Properties
The XRSpace
interface defines no properties of its own; however, it does inherit the properties of its parent interface, EventTarget
.
Methods
The XRSpace
interface provides no methods of its own. However, it inherits the methods of EventTarget
, its parent interface.
Specifications
Specification | Status | Comment |
---|---|---|
WebXR Device API The definition of 'XRSpace' in that specification. |
Working Draft | Initial definition. |
Browser compatibility
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
XRSpace | 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