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 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 domOverlayState-Eigenschaft einer immersive-ar
XRSession liefert Informationen über das DOM-Overlay, falls 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 DOM-Overlay-Status 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 tragbare AR-Geräte).
head-locked-
Das Overlay wird in einem kopfgebundenen UI gezeichnet, das den darstellbaren Ansichtsbereich füllt und der Kopfbewegung des Benutzers folgt.
floating-
Das Overlay erscheint als rechteckiges Element, das im Raum schwebt und vor dem Benutzer gehalten wird. Es muss nicht unbedingt den gesamten Raum füllen und/oder streng kopfgebunden sein.
Beispiele
Überprüfen, welches DOM-Overlay aktiviert wurde
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 |