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

XRInputSource: targetRaySpace property

· 52CE 我爱测

The read-only XRInputSource property **`targetRaySpace`** returns an XRSpace (typically an XRReferenceSpace) representing the position and orientation of the target ray in the virtual space. Its native origin tracks the position of the origin point of the target ray, and its orie

WebXR Device API

The read-only XRInputSource property targetRaySpace returns an XRSpace (typically an XRReferenceSpace) representing the position and orientation of the target ray in the virtual space. Its native origin tracks the position of the origin point of the target ray, and its orientation indicates the orientation of the controller device itself. These values, interpreted in the context of the input source's XRInputSource.targetRayMode, can be used both to fully interpret the device as an input source.

To obtain an XRSpace representing the input controller's position and orientation in virtual space, use the XRInputSource.gripSpace property.

Value

An XRSpace object—typically an XRReferenceSpace or XRBoundedReferenceSpace—which represents the position and orientation of the input controller's target ray in virtual space.

The native origin of the returned XRSpace is located at the point from which the target ray is emitted, and the orientation of the space indicates the direction in which the target ray is pointing.

Usage notes

All input sources—regardless of their XRInputSource.targetRayMode—have a valid targetRaySpace. The exact meaning of this space varies, however, depending on the mode:

  • Every gaze input (targetRayMode value of gaze), shares the same XRSpace object as their target ray space, since the gaze input comes from the viewer's head. This shared space represents the same location as the space returned by the XRSession method XRSession.requestReferenceSpace, but is maintained as a different object to allow for future enhancements to the API.
  • The target ray space reported by tracked pointer inputs (targetRayMode of tracked-pointer) is actually based upon the true spatial position and orientation of the input device.

To determine the position and orientation of the target ray while rendering a frame, pass it into the XRFrame method XRFrame.getPose method, then use the returned XRPose object's XRPose.transform to gather the spatial information you need.

Examples

This fragment of code shows part of a function to be called once every frame. It looks for inputs which have a non-null targetRaySpace. Inputs which have a value for this property represent inputs that project a target ray outward from the user.

For each such input, this example looks for inputs whose XRInputSource.targetRayMode is tracked-pointer, indicating that the input is in fact intended to represent a targeting device rather than a gazing device, screen tap, or mouse click. For tracked pointers, a function myRenderTargetRayAsBeam() is called to render a beam from the input controller's virtual position outward in the direction it's pointing.

The code should continue to perform tasks such as drawing controllers or any objects representative of the user's hands' positions in the virtual space, as well as any other input-related tasks.

function updateInputSources(session, frame, refSpace) {
  for (const source of session.getInputSources()) {
    const targetRayPose = frame.getPose(inputSource.targetRaySpace, refSpace);

    if (targetRayPose) {
      if (source.targetRayMode === "tracked-pointer") {
        myRenderTargetRayAsBeam(targetRayPose);
      }
    }

    // …
  }
}

Specifications

Browser compatibility

See also

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

资料来源与适用范围

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

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

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