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

XRSession: depthUsage property

· 52CE 我爱测

The _read-only_ **`depthUsage`** property of an `immersive-ar` XRSession describes which depth-sensing usage is used.

WebXR Device API

The read-only depthUsage property of an immersive-ar XRSession describes which depth-sensing usage is used.

Value

This property can return the following values:

  • cpu-optimized
    • : The depth data is intended to be used on the CPU; see the XRCPUDepthInformation interface.
  • gpu-optimized
    • : The depth data is intended to be used on the GPU; see the XRWebGLDepthInformation interface.

Examples

To request the desired usage method, you need to specify a usagePreference when requesting a session using XRSystem.requestSession(). Here, the caller is able to handle both CPU- and GPU-optimized usage. The order indicates preference for CPU:

navigator.xr.requestSession("immersive-ar", {
  requiredFeatures: ["depth-sensing"],
  depthSensing: {
    usagePreference: ["cpu-optimized", "gpu-optimized"],
    formatPreference: ["luminance-alpha", "float32"],
  },
});

To check which usage was selected by the user agent, you can call the depthUsage property:

console.log(session.depthUsage); // either "cpu-optimized" or "gpu-optimized"

Specifications

Browser compatibility

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

资料来源与适用范围

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

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

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