XRFrame:createAnchor() 方法

实验性: 这是一个 实验性技术
在生产环境中使用此功能之前,请仔细查看 浏览器兼容性表

安全上下文:此功能仅在 安全上下文(HTTPS)中可用,在某些或所有 支持的浏览器 中可用。

createAnchor()XRFrame 接口的方法,它创建一个浮动的 XRAnchor,该锚点将相对于现实世界固定。

请参阅 XRHitTestResult.createAnchor(),了解如何从与现实世界对象关联的命中测试结果创建锚点。

语法

js
createAnchor(pose, space)

参数

pose

一个 XRRigidTransform 对象,其中包含应创建锚点的初始姿态。系统将确保在此时与物理世界建立的关系在跟踪系统对世界的理解演变时得到保持。

space

一个 XRSpace 对象,姿态相对于该对象。

返回值

一个 Promise,解析为一个 XRAnchor 对象。

示例

创建锚点

js
frame.createAnchor(anchorPose, referenceSpace).then(
  (anchor) => {
    // Do stuff with the anchor (assign objects that will be relative to this anchor)
  },
  (error) => {
    console.error(`Could not create anchor: ${error}`);
  },
);

规范

规范
WebXR 锚点模块
# dom-xrframe-createanchor

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅