XRSession: depthDataFormat-Eigenschaft

Eingeschränkt verfügbar

Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

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

Die schreibgeschützte depthDataFormat-Eigenschaft einer immersive-ar XRSession beschreibt, welches Tiefensensor-Datenformat verwendet wird.

In diesem Artikel

Wert

Diese Eigenschaft kann die folgenden Werte zurückgeben:

luminance-alpha

2-Byte-unsigned-Integer-Datenpuffer (LUMINANCE_ALPHA GLEnum). CPU-Nutzung: Interpretieren Sie XRCPUDepthInformation.data als Uint8Array. GPU-Nutzung: Untersuchen Sie die Luminanz- und Alphakanäle, um einen einzelnen Wert wiederherzustellen.

float32

4-Byte-Gleitkomma-Datenpuffer (R32F GLEnum). CPU-Nutzung: Interpretieren Sie XRCPUDepthInformation.data als Float32Array. GPU-Nutzung: Untersuchen Sie den Rotkanal und nutzen Sie den Wert.

Beispiele

Um das gewünschte Datenformat anzufordern, müssen Sie eine dataFormatPreference angeben, wenn Sie eine Sitzung mit XRSystem.requestSession() anfordern. Hier ist der Aufrufer in der Lage, sowohl das "luminance-alpha"- als auch das "float32"-Format zu verarbeiten. Die Reihenfolge gibt die Präferenz für "luminance-alpha" an:

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

Um zu überprüfen, welches Datenformat vom Benutzeragenten ausgewählt wurde, können Sie die depthDataFormat-Eigenschaft aufrufen:

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

Spezifikationen

Spezifikation

WebXR Depth Sensing Module
# dom-xrsession-depthdataformat

Browser-Kompatibilität

JavaScript aktivieren, um diese Browser-Kompatibilitätstabelle anzuzeigen.

Help improve MDN

War diese Übersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden

WebXR Device API
XRSession
Instanzeigenschaften
Instanzmethoden
Events
Vererbung
1. EventTarget
Verwandte Seiten für WebXR Device API
Anleitungen
1. Grundlagen von WebXR
2. Lebenszyklus einer WebXR-Anwendung
3. Starten und Beenden einer WebXR-Sitzung
4. Geometrie und Referenzräume im WebXR
5. Räume und Referenzräume: Räumliches Tracking in WebXR
6. Rendering und der WebXR-Frame-Animationsrückruf
7. Blickpunkte und Betrachter: Kamerasimulation in WebXR
8. Eine perspektivische Rückschau für WebXR-Entwickler
9. Beleuchtung einer WebXR-Umgebung
10. Verwendung von begrenzten Referenzräumen
11. Bewegung, Orientierung und Bewegung: Ein WebXR-Beispiel
12. Eingaben und Eingabequellen
13. Targeting und Treffererkennung
14. WebXR-Leitfaden zur Leistungsoptimierung
15. WebXR-Berechtigungen und Sicherheit