XRFrame:getDepthInformation() 方法
getDepthInformation()
是 XRFrame
接口的方法,它返回一个 XRCPUDepthInformation
对象,其中包含活动和动画帧的 CPU 深度信息。
语法
js
getDepthInformation(view)
参数
返回值
一个 XRCPUDepthInformation
对象。
异常
NotSupportedError
DOMException
-
如果
"depth-sensing"
不在此XRSession
的已启用功能列表中,则抛出此异常。 InvalidStateError
DOMException
-
如果
XRFrame
不处于活动状态或动画状态,则抛出此异常。获取深度信息仅在requestAnimationFrame()
回调函数中有效。- 会话的
depthUsage
不是"cpu-optimized"
。
示例
获取 CPU 深度信息
js
// Make sure to request a session with depth-sensing enabled
const session = navigator.xr.requestSession("immersive-ar", {
requiredFeatures: ["depth-sensing"],
depthSensing: {
usagePreference: ["cpu-optimized", "gpu-optimized"],
formatPreference: ["luminance-alpha", "float32"],
},
});
// …
// Obtain depth information in an active and animated frame
function rafCallback(time, frame) {
session.requestAnimationFrame(rafCallback);
const pose = frame.getViewerPose(referenceSpace);
if (pose) {
for (const view of pose.views) {
const depthInformation = frame.getDepthInformation(view);
if (depthInformation) {
// Do something with the depth information
renderDepth(depthInformation);
}
}
}
}
规范
规范 |
---|
WebXR 深度感知模块 # dom-xrframe-getdepthinformation |
浏览器兼容性
BCD 表仅在启用 JavaScript 的浏览器中加载。