XRSession：depthDataFormat 屬性

值

此屬性可以返回以下值

luminance-alpha

2 位元組無符號整數資料緩衝區（LUMINANCE_ALPHA GLEnum）。CPU 使用：將 XRCPUDepthInformation.data 解釋為 Uint8Array。GPU 使用：檢查亮度（Luminance）和 Alpha 通道以重新組合單個值。

float32

4 位元組浮點數資料緩衝區（R32F GLEnum）。CPU 使用：將 XRCPUDepthInformation.data 解釋為 Float32Array。GPU 使用：檢查紅色（Red）通道並使用該值。

示例

要請求所需的資料格式，您需要在呼叫 XRSystem.requestSession() 請求會話時指定 dataFormatPreference。在此示例中，呼叫者可以處理 "luminance-alpha" 和 "float32" 格式。順序表示對 "luminance-alpha" 的偏好。

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

要檢查使用者代理選擇了哪種資料格式，您可以呼叫 depthDataFormat 屬性。

console.log(session.depthDataFormat); // either "luminance-alpha" or "float32"

規範

瀏覽器相容性