XRSession: depthUsage 屬性

可用性有限

此特性不是基線特性,因為它在一些最廣泛使用的瀏覽器中不起作用。

實驗性: 這是一項實驗性技術
在生產中使用此技術之前,請仔細檢查瀏覽器相容性表格

安全上下文: 此功能僅在安全上下文(HTTPS)中可用,且支援此功能的瀏覽器數量有限。

immersive-ar 型別的 XRSession 物件的只讀 depthUsage 屬性描述了使用的深度感測用法。

此屬性可以返回以下值

cpu-optimized

深度資料旨在用於 CPU;請參閱 XRCPUDepthInformation 介面。

gpu-optimized

深度資料旨在用於 GPU;請參閱 XRWebGLDepthInformation 介面。

示例

要請求所需的用法方法,您需要在請求會話時使用 XRSystem.requestSession() 指定 usagePreference。在此,呼叫者能夠處理 CPU 和 GPU 最佳化的用法。順序表示對 CPU 的偏好。

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

要檢查使用者代理選擇了哪種用法,您可以呼叫 depthUsage 屬性。

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

規範

規範
WebXR Depth Sensing 模組
# dom-xrsession-depthusage

瀏覽器相容性