只读 XRRigidTransform property 位置 DOMPointReadOnly object which provides the 3D point, specified in meters, describing the translation component of the transform.

句法

let pos = xrRigidTransform.position;
					

A read-only DOMPointReadOnly indicating the 3D position component of the transform matrix. The units are meters.

注意: w component of the point is always 1.0.

范例

To create a reference space which can be used to place an object at eye level (assuming eye level is 1.5 meters):

function onSessionStarted(xrSession) {
  xrSession.addEventListener("end", onSessionEnded);
  gl = initGraphics(xrSession);
  let glLayer = new XRWebGLLayer(xrSession, gl);
  xrSession.updateRenderState({ baseLayer: glLayer });
  if (immersiveSession) {
    xrSession.requestReferenceSpace("bounded-floor").then((refSpace) => {
      refSpaceCreated(refSpace);
    }).catch(() => {
      session.requestReferenceSpace("local-floor").then(refSpaceCreated);
    });
  } else {
    session.requestReferenceSpace("viewer").then(refSpaceCreated);
  }
}
function refSpaceCreated(refSpace) {
  if (immersiveSession) {
    xrReferenceSpace = refSpace;
  } else {
    xrReferenceSpace = refSpace.getOffsetReferenceSpace(
      new XRRigidTransform({y: -1.5});
    );
  }
  xrSession.requestAnimationFrame(onFrame);
}
					

After setting up the graphics context for WebXR use, this begins by looking to see if a variable immersiveSession is true ; if so, we first request a bounded-floor reference space. if that fails (probably because bounded-floor isn't supported), we try requesting a local-floor reference space.

If we're not in an immersive session, we instead request a viewer reference space.

In all cases, once the space has been obtained, it gets passed into the refSpaceCreated() function. For immersive spaces, the specified space is simply saved for future use. However, for inline sesions, we know we're in a space not automatically adjusted for floor level, so we request an offset reference space to shift the viewer's height to 1.5 meters above the presumed floor level of 0 meters. That new reference space is used instead of the one initially received.

Finally, an animation frame request is submitted.

规范

规范 状态 注释
WebXR 设备 API
The definition of 'XRRigidTransform.position' in that specification.
工作草案 初始定义。

浏览器兼容性

更新 GitHub 上的兼容性数据
桌面 移动
Chrome Edge Firefox Internet Explorer Opera Safari Android webview Chrome for Android Firefox for Android Opera for Android Safari on iOS Samsung Internet
位置 Chrome 79 Edge 79 Firefox 不支持 No IE 不支持 No Opera 不支持 No Safari 不支持 No WebView Android 不支持 No Chrome Android 79 Firefox Android 不支持 No Opera Android 不支持 No Safari iOS 不支持 No Samsung Internet Android 11.2

图例

完整支持

完整支持

不支持

不支持

元数据

  • 最后修改: