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.
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.
const xrSession = navigator.xr.requestSession("immersive-ar", {
requiredFeatures: ["local", "hit-test"]
});
let hitTestSource = null;
xrSession.requestHitTestSource({
space: viewerSpace,
offsetRay: new XRRay({y: 0.5})
}).then((viewerHitTestSource) => {
hitTestSource = viewerHitTestSource;
});