XRSession: domOverlayState-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 domOverlayState-Eigenschaft einer immersive-ar-XRSession bietet Informationen über das DOM-Overlay, wenn die Funktion aktiviert ist.

Wert

Gibt null zurück, wenn die DOM-Overlay-Funktion nicht unterstützt oder nicht aktiviert ist, oder ein Objekt, das Informationen über den Zustand des DOM-Overlays mit den folgenden Eigenschaften enthält:

type

Ein String, der angibt, wie das DOM-Overlay angezeigt wird. Mögliche Werte:

screen

Das Overlay wird auf dem gesamten bildschirmbasierten Gerät gezeichnet (für Handheld-AR-Geräte).

head-locked

Das Overlay wird als benutzerfixierte UI dargestellt, die den darstellbaren Viewport ausfüllt und den Kopfbewegungen des Benutzers folgt.

floating

Das Overlay erscheint als rechteckiger Bereich, der im Raum schwebt und sich vor dem Benutzer befindet. Es füllt nicht unbedingt den gesamten Raum aus und/oder ist strikt kopfgebunden.

Beispiele

Überprüfung, welches DOM-Overlay aktiviert ist

js
if (session.domOverlayState) {
  console.log(session.domOverlayState.type);
} else {
  console.log("DOM overlay not supported or enabled!");
}

Spezifikationen

Specification
WebXR DOM Overlays Module
# dom-xrsession-domoverlaystate

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch