VRDisplay

Instanz-Eigenschaften

VRDisplay.capabilities Schreibgeschützt

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

VRDisplay.depthFar

Ruft die z-Tiefe ab und legt diese fest, die die Fernebene des Frustums des Augenblicks definiert, d.h. die am weitesten sichtbare Grenze der Szene.

VRDisplay.depthNear

Ruft die z-Tiefe ab und legt diese fest, die die Nahebene des Frustums des Augenblicks definiert, d.h. die am nächsten sichtbare Grenze der Szene.

VRDisplay.displayId Schreibgeschützt

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

VRDisplay.displayName Schreibgeschützt

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

VRDisplay.isConnected Schreibgeschützt

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

VRDisplay.isPresenting Schreibgeschützt

Gibt einen booleschen Wert zurück, der anzeigt, ob das VRDisplay derzeit Inhalte präsentiert.

VRDisplay.stageParameters Schreibgeschützt

Gibt ein VRStageParameters-Objekt zurück, das Raummaßstab-Parameter enthält, wenn das VRDisplay in der Lage ist, Erlebnisse im Raummaßstab zu unterstützen.

Instanz-Methoden

VRDisplay.getEyeParameters()

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

VRDisplay.getFrameData()

Akzeptiert ein VRFrameData-Objekt und füllt es mit den Informationen, die erforderlich sind, um das aktuelle Bild darzustellen.

VRDisplay.getImmediatePose()

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

VRDisplay.getLayers()

Gibt die aktuell vom VRDisplay präsentierten Ebenen zurück.

VRDisplay.getPose()

Gibt ein VRPose-Objekt zurück, das die zukünftige vorhergesagte Pose des VRDisplay definiert, wie sie sein wird, wenn das aktuelle Bild tatsächlich präsentiert wird. Diese Methode ist veraltet — stattdessen sollten Sie VRDisplay.getFrameData() verwenden, das ebenfalls ein VRPose-Objekt bereitstellt.

VRDisplay.resetPose()

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

VRDisplay.cancelAnimationFrame()

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

VRDisplay.requestAnimationFrame()

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()

Beginnt mit der Präsentation einer Szene durch das VRDisplay.

VRDisplay.exitPresent()

Beendet die Präsentation einer Szene durch das VRDisplay.

VRDisplay.submitFrame()

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
    }
  });
}

Spezifikationen

Dieses Interface war Teil der alten WebVR API, die durch die WebXR Device API abgelöst wurde. Es 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 zu setzen, um WebXR-Anwendungen zu entwickeln, die in allen Browsern funktionieren. Lesen Sie den Leitfaden "Meta's Porting from WebVR to WebXR" für weitere Informationen.

Browser-Kompatibilität

Siehe auch

• WebVR API