VRDisplay

Deprecated

Avoid using this feature in new projects. Development of the WebVR API halted in favor of WebXR. This feature may be a candidate for removal from web standards or browsers.

Consider using the following features instead: WebXR.

Vollständige Kompatibilität anzeigen
Mehr erfahren

Nicht standardisiert: Diese Funktion ist nicht standardisiert. Wir raten davon ab, nicht-standardisierte Funktionen auf produktiven Webseiten zu verwenden, da sie nur von bestimmten Browsern unterstützt werden und sich in Zukunft ändern oder entfernt werden können. Unter Umständen kann sie jedoch eine geeignete Option sein, wenn es keine standardisierte Alternative gibt.

Die Schnittstelle VRDisplay der WebVR API repräsentiert jedes von dieser API unterstützte VR-Gerät. Sie stellt allgemeine Informationen wie Geräte-IDs und Beschreibungen bereit sowie Methoden, um die Darstellung einer VR-Szene zu starten, Augenparameter und Anzeigefunktionen abzurufen und weitere wichtige Aufgaben auszuführen.

Hinweis: Diese Schnittstelle war Teil der alten WebVR API. Sie wurde durch die WebXR Device API abgelöst.

Ein Array aller verbundenen VR-Geräte kann durch Aufrufen der Methode Navigator.getVRDisplays() abgerufen werden.

Instanzeigenschaften

VRDisplay.capabilities Schreibgeschützt: Gibt ein VRDisplayCapabilities-Objekt zurück, das die verschiedenen Funktionen des VRDisplay angibt.
VRDisplay.depthFar: Ruft die z-Tiefe ab und legt sie fest. Diese definiert die ferne Ebene des Sichtfrustums für das Auge, also die am weitesten entfernte sichtbare Grenze der Szene.
VRDisplay.depthNear: Ruft die z-Tiefe ab und legt sie fest. Diese definiert die nahe Ebene des Sichtfrustums für das Auge, also die nächstgelegene sichtbare Grenze der Szene.
VRDisplay.displayId Schreibgeschützt: Gibt eine Kennung für dieses VRDisplay zurück, die auch zur Zuordnung in der Gamepad API verwendet wird (siehe Gamepad.displayId).
VRDisplay.displayName Schreibgeschützt: Gibt einen für Menschen lesbaren Namen zur Identifizierung des VRDisplay zurück.
VRDisplay.isConnected Schreibgeschützt: Gibt einen booleschen Wert zurück, der angibt, ob das VRDisplay mit dem Computer verbunden ist.
VRDisplay.isPresenting Schreibgeschützt: Gibt einen booleschen Wert zurück, der angibt, ob über das VRDisplay derzeit Inhalte dargestellt werden.
VRDisplay.stageParameters Schreibgeschützt: Gibt ein VRStageParameters-Objekt mit Parametern für raumfüllende VR-Erlebnisse zurück, sofern das VRDisplay solche Erlebnisse unterstützt.

Instanzmethoden

VRDisplay.getEyeParameters(): Gibt das VREyeParameters-Objekt mit den Augenparametern für das angegebene Auge zurück.
VRDisplay.getFrameData(): Nimmt ein VRFrameData-Objekt entgegen und befüllt es mit den Informationen, die zum Rendern des aktuellen Frames erforderlich sind.
VRDisplay.getImmediatePose(): Gibt ein VRPose-Objekt zurück, das die aktuelle Position und Ausrichtung des VRDisplay ohne angewendete Vorhersage beschreibt. Diese Methode wird nicht mehr benötigt und wurde aus der Spezifikation entfernt.
VRDisplay.getLayers(): Gibt die Ebenen zurück, die derzeit vom VRDisplay dargestellt werden.
VRDisplay.getPose(): Gibt ein VRPose-Objekt zurück, das die vorhergesagte zukünftige Position und Ausrichtung des VRDisplay zum Zeitpunkt der tatsächlichen Darstellung des aktuellen Frames beschreibt. Diese Methode ist veraltet. Verwenden Sie stattdessen VRDisplay.getFrameData(), das ebenfalls ein VRPose-Objekt bereitstellt.
VRDisplay.resetPose(): Setzt die Position und Ausrichtung dieses VRDisplay zurück, indem die aktuellen Werte von VRPose.position und VRPose.orientation als Ursprungs- beziehungsweise Nullwerte behandelt werden.
VRDisplay.cancelAnimationFrame(): Eine spezielle Implementierung von Window.cancelAnimationFrame, mit der sich über VRDisplay.requestAnimationFrame() registrierte Callback-Funktionen wieder abmelden lassen.
VRDisplay.requestAnimationFrame(): Eine spezielle Implementierung von Window.requestAnimationFrame, die eine Callback-Funktion entgegennimmt. Diese wird jedes Mal aufgerufen, wenn ein neuer Frame für die Darstellung durch das VRDisplay gerendert wird.
VRDisplay.requestPresent(): Startet die Darstellung einer Szene durch das VRDisplay.
VRDisplay.exitPresent(): Beendet die Darstellung einer Szene durch das VRDisplay.
VRDisplay.submitFrame(): Erfasst den aktuellen Zustand des derzeit dargestellten VRLayerInit und zeigt ihn auf dem VRDisplay an.

Beispiele

if (navigator.getVRDisplays) {
  console.log("WebVR 1.1 supported");
  // Then get the displays attached to the computer
  navigator.getVRDisplays().then((displays) => {
    // If a display is available, use it to present the scene
    if (displays.length > 0) {
      vrDisplay = displays[0];
      // Now we have our VRDisplay object and can do what we want with it
    }
  });
}

Hinweis: Den vollständigen Code finden Sie unter raw-webgl-example.

Spezifikationen

Diese Schnittstelle war Teil der alten WebVR API, die durch die WebXR Device API abgelöst wurde. Sie wird nicht mehr als Standard weiterentwickelt.

Bis alle Browser die neuen WebXR APIs implementiert haben, empfiehlt es sich, für die Entwicklung browserübergreifender WebXR-Anwendungen Frameworks wie A-Frame, Babylon.js oder Three.js oder einen Polyfill zu verwenden. Weitere Informationen finden Sie in Metas Leitfaden zur Migration von WebVR zu WebXR.

Browser-Kompatibilität

Siehe auch

WebVR API

Help improve MDN

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

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