大网数据广告活动
Web 标准与前端开发

XRRay

· 52CE 我爱测

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

WebXR Device API

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.XRRay
    • : Creates a new XRRay object.

Instance properties

  • XRRay.direction
    • : A DOMPointReadOnly representing the ray's 3-dimensional directional vector.
  • XRRay.matrix
    • : 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
    • : 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.

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

See also

  • XRSession.requestHitTestSource()
  • XRHitTestResult

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。