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 desVRDisplay
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 (sieheGamepad.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 dasVRDisplay
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 desVRDisplay
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 desVRDisplay
definiert, wie sie beim tatsächlichen Präsentieren der aktuellen Szene sein wird. Diese Methode ist veraltet – stattdessen sollten SieVRDisplay.getFrameData()
verwenden, das ebenfalls einVRPose
-Objekt bereitstellt. VRDisplay.resetPose()
Veraltet Nicht standardisiert-
Setzt die Pose für dieses
VRDisplay
zurück, wobei die aktuelleVRPose.position
undVRPose.orientation
als "Ursprungs-/Nullwerte" behandelt werden. VRDisplay.cancelAnimationFrame()
Veraltet Nicht standardisiert-
Eine spezielle Implementierung von
Window.cancelAnimationFrame
, die es ermöglicht, Rückrufe, die mitVRDisplay.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 derVRDisplay
-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 demVRDisplay
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
BCD tables only load in the browser