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

XRInputSource: gripSpace property

· 52CE 我爱测

The read-only XRInputSource property **`gripSpace`** returns an XRSpace whose native origin tracks the pose used to render virtual objects so they appear to be held in (or part of) the user's hand. For example, if a user were holding a virtual straight rod, the native origin of t

WebXR Device API

The read-only XRInputSource property gripSpace returns an XRSpace whose native origin tracks the pose used to render virtual objects so they appear to be held in (or part of) the user's hand. For example, if a user were holding a virtual straight rod, the native origin of this XRSpace would be located at the approximate center of mass of the user's fist.

Value

An XRSpace object representing the position and orientation of the input device in virtual space, suitable for rendering an image of the device into the scene. gripSpace is null if the input source is not inherently trackable. For example, only inputs whose XRInputSource.targetRayMode is tracked-pointer provide a gripSpace.

Imagine that the controller is shaped like a straight rod, held in the user's fist. The native origin of the grip space is located at the centroid—the center of mass—of the user's fist, tracking the position of the user's hand.

The coordinate system for the left hand's grip space.

A diagram showing how the grip space indicates the local coordinate system for the player's hand relative to the world.

The coordinate system for the right hand's grip space.

A diagram showing how the grip space indicates the local coordinate system for the player's hand relative to the world.

As shown in the diagram above, the coordinate system is oriented as follows:

  • The x-axis is perpendicular to the palm of the user's hand, with the direction extending outward from the back of the hand being +X if the controller is in the user's right hand or -X if the controller is in the left hand.
  • The z-axis along the length of the rod, parallel to the user's palm and along the length of their grip. -Z is in the direction of the user's thumb, and +Z is in the opposite direction.
  • The y-axis is implied by the relationship between the other two axes; as is always the case, it's the cross product of the other two axes (lying 90° away from both the X and Z axes).

Examples

In tis example, taken from the frame rendering callback, the gripSpace is used to render a mesh that represents the position and orientation of the controller in the virtual environment.

for (const source in xrSession.inputSources) {
  if (source.gripSpace) {
    const gripPose = frame.getPose(source.gripSpace, xrRefSpace);

    if (gripPose) {
      myDrawMeshUsingTransform(controllerMesh, gripPose.transform.matrix);
    }
  }
}

For each input source which has a value for gripSpace, this loop obtains the XRPose representing the position and orientation that are described by gripSpace. If a valid pose is returned, a method myDrawMeshUsingTransform() is called to draw the controller's mesh transformed using the grip pose's transform matrix.

Specifications

Browser compatibility

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

资料来源与适用范围

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

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

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