XRSession: depthUsage-Eigenschaft

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig, bevor Sie diese produktiv verwenden.

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Die schreibgeschützte depthUsage-Eigenschaft einer immersive-ar XRSession beschreibt, welche Nutzung der Tiefensensoren eingesetzt wird.

Wert

Diese Eigenschaft kann die folgenden Werte zurückgeben:

cpu-optimized

Die Tiefendaten sind zur Verwendung auf der CPU vorgesehen; siehe das XRCPUDepthInformation Interface.

gpu-optimized

Die Tiefendaten sind zur Verwendung auf der GPU vorgesehen; siehe das XRWebGLDepthInformation Interface.

Beispiele

Um die gewünschte Nutzungsmethode anzufordern, müssen Sie eine usagePreference angeben, wenn Sie eine Sitzung mit XRSystem.requestSession() anfordern. Hier kann der Aufrufer sowohl CPU- als auch GPU-optimierte Nutzung verarbeiten. Die Reihenfolge zeigt die Präferenz für die CPU an:

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

Um zu überprüfen, welche Nutzung von der Benutzeragentur ausgewählt wurde, können Sie die depthUsage-Eigenschaft aufrufen:

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

Spezifikationen

Specification
WebXR Depth Sensing Module
# dom-xrsession-depthusage

Browser-Kompatibilität

BCD tables only load in the browser