XRSession: Eigenschaft interactionMode

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 Eigenschaft interactionMode des XRSession-Interfaces beschreibt den besten Raum (laut dem Benutzeragenten), in dem die Anwendung eine interaktive Benutzeroberfläche für die aktuelle Sitzung zeichnen sollte.

Wert

Ein String, der den besten Raum (laut dem Benutzeragenten) beschreibt, in dem die Anwendung eine interaktive Benutzeroberfläche für die aktuelle Sitzung zeichnen sollte.

Mögliche Werte sind:

screen-space

Gibt an, dass die Benutzeroberfläche direkt auf dem Bildschirm ohne Projektion gezeichnet werden sollte. Dies ist typischerweise der Modus, der von Handheld-Geräten gemeldet wird.

world-space

Gibt an, dass die Benutzeroberfläche in der Welt, in einer gewissen Entfernung vom Benutzer gezeichnet werden sollte, sodass sie mit Controllern interagieren können. Dies ist typischerweise der Modus, der von kopfgetragenen Geräten gemeldet wird.

Beispiele

js
if (xrSession.interactionMode === "world-space") {
  // draw UI in the world
} else {
  // draw UI directly to the screen
}

Spezifikationen

Specification
WebXR Augmented Reality Module - Level 1
# dom-xrsession-interactionmode

Browser-Kompatibilität

BCD tables only load in the browser