XRSpace
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Secure context: This feature is available only insecure contexts (HTTPS), in some or allsupporting browsers.
TheXRSpace interface of theWebXR 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 ofXRSpace, at the time at which a givenXRFrame takes place.
Numeric values such as pose positions are thus coordinates in the correspondingXRSpace, relative to that space's origin.
Note:TheXRSpace interface is never used directly; instead, all spaces are created using one of the interfaces based onXRSpace. At this time, those areXRReferenceSpace,XRBoundedReferenceSpace, andXRJointSpace.
In this article
Interfaces based on XRSpace
Below is a list of interfaces based on theXRSpace interface.
XRBoundedReferenceSpaceRepresents 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
XRBoundedReferenceSpaceis always at floor level, with its X and Z coordinates typically defaulting to a location near the room's center.XRReferenceSpaceRepresents 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, anXRReferenceSpacemay move in order to adjust based on reconfiguration of the user's headset or other motion-sensitive device.XRJointSpaceRepresents the space of an
XRHandjoint.
Instance properties
TheXRSpace interface defines no properties of its own; however, it does inherit the properties of its parent interface,EventTarget.
Instance methods
TheXRSpace interface provides no methods of its own. However, it inherits the methods ofEventTarget, its parent interface.
Specifications
| Specification |
|---|
| WebXR Device API> # xrspace-interface> |