XRReferenceSpaceEvent

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.

TheWebXR Device API interfaceXRReferenceSpaceEvent represents an event sent to anXRReferenceSpace. Currently, the only event that uses this type is thereset event.

Constructor

XRReferenceSpaceEvent(): Returns a newXRReferenceSpaceEvent with the specified type and configuration.

Instance properties

In addition to inheriting the properties available on the parent interface,Event,XRReferenceSpaceEvent objects include the following properties:

referenceSpaceRead only: AnXRReferenceSpace indicating the reference space that generated the event.
transformRead only: AnXRRigidTransform object indicating the position and orientation of the specifiedreferenceSpace's native origin after the event, defined relative to the coordinate system before the event.

Instance methods

WhileXRReferenceSpaceEvent does not define any methods, it inherits the methods of its parent interface,Event.

Event types

reset: Thereset event is sent to a reference space when its native origin is changed due to a discontinuity, recalibration, or device reset. This is an opportunity for your app to update any stored transforms, position/orientation information, or the like—or to dump any cached values based on the reference's space's origin so you can recompute them as needed.