W3cubDocs

/Web APIs

XRRay

Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.

Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

The XRRay interface of the WebXR Device API is a geometric ray described by an origin point and a direction vector.

XRRay objects can be passed to XRSession.requestHitTestSource() or XRSession.requestHitTestSourceForTransientInput() to perform hit testing.

Constructor

XRRay() Experimental

Creates a new XRRay object.

Instance properties

XRRay.direction Read only Experimental

A DOMPointReadOnly representing the ray's 3-dimensional directional vector.

XRRay.matrix Read only Experimental

A transform that can be used to position objects along the XRRay. This is a 4 by 4 matrix given as a 16 element Float32Array in column major order.

XRRay.origin Read only Experimental

A DOMPointReadOnly representing the 3-dimensional point in space that the ray originates from, in meters.

Instance methods

None.

Examples

Using XRRay to request a hit test source

The XRSession.requestHitTestSource() method takes an XRRay object for its offsetRay option. In this example, the hit test source is positioned slightly above the viewer as the application has some UI elements at the bottom while wanting to maintain the perception of a centered cursor.

js

const xrSession = navigator.xr.requestSession("immersive-ar", {
  requiredFeatures: ["local", "hit-test"],
});

let hitTestSource = null;

xrSession
  .requestHitTestSource({
    space: viewerSpace, // obtained from xrSession.requestReferenceSpace("viewer");
    offsetRay: new XRRay({ y: 0.5 }),
  })
  .then((viewerHitTestSource) => {
    hitTestSource = viewerHitTestSource;
  });

Specifications

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
XRRay 81 81 No No 68 No No 81 No 58 No 13.0
XRRay 81 81 No No 68 No No 81 No 58 No 13.0
direction 81 81 No No 68 No No 81 No 58 No 13.0
matrix 81 81 No No 68 No No 81 No 58 No 13.0
origin 81 81 No No 68 No No 81 No 58 No 13.0

See also

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/XRRay