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
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