XRFrame: createAnchor() 方法

可用性有限

此特性不是基线特性,因为它在一些最广泛使用的浏览器中不起作用。

实验性: 这是一项实验性技术
在生产中使用此技术之前,请仔细检查浏览器兼容性表格

安全上下文: 此功能仅在安全上下文(HTTPS)中可用,且支持此功能的浏览器数量有限。

XRFrame 接口的 createAnchor() 方法创建一个自由漂浮的 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 Anchors 模块
# dom-xrframe-createanchor

浏览器兼容性

另见