VRDisplay

Veraltet: Diese Funktion wird nicht mehr empfohlen. Obwohl einige Browser sie möglicherweise noch unterstützen, kann sie bereits aus den relevanten Webstandards entfernt worden sein, befindet sich im Prozess der Entfernung oder wird nur aus Kompatibilitätsgründen beibehalten. Vermeiden Sie die Verwendung und aktualisieren Sie gegebenenfalls bestehenden Code; siehe die Kompatibilitätstabelle am Ende dieser Seite, um Ihre Entscheidung zu treffen. Beachten Sie, dass diese Funktion jederzeit nicht mehr funktionieren kann.

Kein Standard: Diese Funktion ist nicht standardisiert und befindet sich nicht im Standardisierungsprozess. Verwenden Sie sie nicht auf Produktionsseiten, die auf das Web ausgerichtet sind: Sie wird nicht für alle Benutzer funktionieren. Außerdem kann es große Inkompatibilitäten zwischen Implementierungen geben und das Verhalten kann sich in Zukunft ändern.

Die VRDisplay-Schnittstelle der WebVR API repräsentiert jedes von dieser API unterstützte VR-Gerät. Sie enthält allgemeine Informationen wie Geräte-IDs und Beschreibungen sowie Methoden zum Starten der Präsentation einer VR-Szene, zum Abrufen von Augenparametern und Anzeigeeigenschaften und weiterer wichtiger Funktionen.

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

Ein Array aller angeschlossenen VR-Geräte kann durch Aufrufen der Methode Navigator.getVRDisplays() zurückgegeben werden.

Instanz-Eigenschaften

VRDisplay.capabilities Nur lesbar Veraltet Nicht standardisiert

Gibt ein VRDisplayCapabilities-Objekt zurück, das die verschiedenen Fähigkeiten des VRDisplay angibt.

VRDisplay.depthFar Veraltet Nicht standardisiert

Holt und setzt die z-Tiefe, die die Fern-Ebene des Eye View Frustum definiert, d.h. die am weitesten sichtbare Grenze der Szene.

VRDisplay.depthNear Veraltet Nicht standardisiert

Holt und setzt die z-Tiefe, die die Nah-Ebene des Eye View Frustum definiert, d.h. die am nächsten sichtbare Grenze der Szene.

VRDisplay.displayId Nur lesbar Veraltet Nicht standardisiert

Gibt einen Bezeichner für dieses bestimmte VRDisplay zurück, der auch als Verbindungspunkt in der Gamepad API verwendet wird (siehe Gamepad.displayId).

VRDisplay.displayName Nur lesbar Veraltet Nicht standardisiert

Gibt einen menschenlesbaren Namen zurück, um das VRDisplay zu identifizieren.

VRDisplay.isConnected Nur lesbar Veraltet Nicht standardisiert

Gibt einen booleschen Wert zurück, der angibt, ob das VRDisplay mit dem Computer verbunden ist.

VRDisplay.isPresenting Nur lesbar Veraltet Nicht standardisiert

Gibt einen booleschen Wert zurück, der angibt, ob das VRDisplay derzeit Inhalte durchführt.

VRDisplay.stageParameters Nur lesbar Veraltet Nicht standardisiert

Gibt ein VRStageParameters-Objekt zurück, das Raummaßstäbe enthält, wenn das VRDisplay in der Lage ist, raumgroße Erlebnisse zu unterstützen.

Instanz-Methoden

VRDisplay.getEyeParameters() Veraltet Nicht standardisiert

Gibt das VREyeParameters-Objekt zurück, das die Augenparameter für das angegebene Auge enthält.

VRDisplay.getFrameData() Veraltet Nicht standardisiert

Akzeptiert ein VRFrameData-Objekt und füllt es mit den Informationen aus, die benötigt werden, um das aktuelle Bild zu rendern.

VRDisplay.getImmediatePose() Veraltet Nicht standardisiert

Gibt ein VRPose-Objekt zurück, das die aktuelle Pose des VRDisplay definiert, ohne dass eine Vorhersage angewendet wird. Dies ist nicht mehr erforderlich und wurde aus der Spezifikation entfernt.

VRDisplay.getLayers() Veraltet Nicht standardisiert

Gibt die Ebenen zurück, die derzeit vom VRDisplay präsentiert werden.

VRDisplay.getPose() Veraltet Nicht standardisiert

Gibt ein VRPose-Objekt zurück, das die zukünftige vorhergesagte Pose des VRDisplay definiert, wie sie beim tatsächlichen Präsentieren der aktuellen Szene sein wird. Diese Methode ist veraltet – stattdessen sollten Sie VRDisplay.getFrameData() verwenden, das ebenfalls ein VRPose-Objekt bereitstellt.

VRDisplay.resetPose() Veraltet Nicht standardisiert

Setzt die Pose für dieses VRDisplay zurück, wobei die aktuelle VRPose.position und VRPose.orientation als "Ursprungs-/Nullwerte" behandelt werden.

VRDisplay.cancelAnimationFrame() Veraltet Nicht standardisiert

Eine spezielle Implementierung von Window.cancelAnimationFrame, die es ermöglicht, Rückrufe, die mit VRDisplay.requestAnimationFrame() registriert wurden, abzumelden.

VRDisplay.requestAnimationFrame() Veraltet Nicht standardisiert

Eine spezielle Implementierung von Window.requestAnimationFrame, die eine Rückruffunktion enthält, die jedes Mal aufgerufen wird, wenn ein neues Bild der VRDisplay-Präsentation gerendert wird.

VRDisplay.requestPresent() Veraltet Nicht standardisiert

Startet die Präsentation einer Szene durch das VRDisplay.

VRDisplay.exitPresent() Veraltet Nicht standardisiert

Beendet die Präsentation einer Szene durch das VRDisplay.

VRDisplay.submitFrame() Veraltet Nicht standardisiert

Erfasst den aktuellen Zustand des derzeit präsentierten VRLayerInit und zeigt ihn auf dem VRDisplay an.

Beispiele

js
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: Sie können diesen vollständigen Code unter raw-webgl-example einsehen.

Spezifikationen

Diese Schnittstelle war Teil der alten WebVR API, die durch die WebXR Device API ersetzt wurde. Sie ist nicht mehr auf dem Weg, ein Standard zu werden.

Bis alle Browser die neuen WebXR APIs implementiert haben, wird empfohlen, auf Frameworks wie A-Frame, Babylon.js oder Three.js oder ein Polyfill zurückzugreifen, um WebXR-Anwendungen zu entwickeln, die in allen Browsern funktionieren. Lesen Sie Metas Porting von WebVR zu WebXR Anleitung für weitere Informationen.

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch