VRDisplay

Veraltet: Diese Funktion wird nicht mehr empfohlen. Obwohl einige Browser sie möglicherweise noch unterstützen, könnte sie bereits aus den relevanten Webstandards entfernt worden sein, in Kürze entfernt werden oder nur noch aus Kompatibilitätsgründen bestehen. Vermeiden Sie die Verwendung und aktualisieren Sie vorhandenen Code, falls möglich; siehe die Kompatibilitätstabelle am Ende dieser Seite, um Ihre Entscheidung zu unterstützen. Beachten Sie, dass diese Funktion jederzeit aufhören könnte zu funktionieren.

Nicht standardisiert: Diese Funktion ist nicht standardisiert und befindet sich nicht auf dem Weg zur Standardisierung. Verwenden Sie sie nicht auf Produktionsseiten, die dem Web ausgesetzt sind: Sie funktioniert nicht für alle Benutzer. Es kann auch 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 Schreibgeschützt 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 Schreibgeschützt 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 Schreibgeschützt Veraltet Nicht standardisiert: Gibt einen menschenlesbaren Namen zurück, um das VRDisplay zu identifizieren.
VRDisplay.isConnected Schreibgeschützt Veraltet Nicht standardisiert: Gibt einen booleschen Wert zurück, der angibt, ob das VRDisplay mit dem Computer verbunden ist.
VRDisplay.isPresenting Schreibgeschützt Veraltet Nicht standardisiert: Gibt einen booleschen Wert zurück, der angibt, ob das VRDisplay derzeit Inhalte durchführt.
VRDisplay.stageParameters Schreibgeschützt 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

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

Siehe auch

WebVR API