VRDisplayCapabilities

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 VRDisplayCapabilities Schnittstelle der WebVR API beschreibt die Fähigkeiten eines VRDisplay — ihre Funktionen können verwendet werden, um Tests der VR-Gerätefähigkeiten zu durchführen, zum Beispiel, ob sie Positionsinformationen zurückgeben kann.

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

Diese Schnittstelle ist über die VRDisplay.capabilities-Eigenschaft zugänglich.

Instanz-Eigenschaften

VRDisplayCapabilities.canPresent Veraltet Nur lesbar Nicht standardisiert: Gibt einen booleschen Wert zurück, der angibt, ob das VR-Display in der Lage ist, Inhalte zu präsentieren (z.B. durch ein HMD).
VRDisplayCapabilities.hasExternalDisplay Veraltet Nur lesbar Nicht standardisiert: Gibt einen booleschen Wert zurück, der angibt, ob das VR-Display vom primären Display des Geräts getrennt ist.
VRDisplayCapabilities.hasOrientation Veraltet Nur lesbar Nicht standardisiert: Gibt einen booleschen Wert zurück, der angibt, ob das VR-Display die Orientierung verfolgen und zurückgeben kann.
VRDisplayCapabilities.hasPosition Veraltet Nur lesbar Nicht standardisiert: Gibt einen booleschen Wert zurück, der angibt, ob das VR-Display die Position verfolgen und zurückgeben kann.
VRDisplayCapabilities.maxLayers Veraltet Nur lesbar Nicht standardisiert: Gibt eine Zahl an, die die maximale Anzahl von VRLayerInits angibt, die das VR-Display gleichzeitig präsentieren kann (z.B. die maximale Länge des Arrays, das VRDisplay.requestPresent() akzeptieren kann.)

Beispiele

function reportDisplays() {
  navigator.getVRDisplays().then((displays) => {
    displays.forEach((display, i) => {
      const cap = display.capabilities;
      // cap is a VRDisplayCapabilities object
      const listItem = document.createElement("li");
      listItem.innerText = `
VR Display ID: ${display.displayId}
VR Display Name: ${display.displayName}
Display can present content: ${cap.canPresent}
Display is separate from the computer's main display: ${cap.hasExternalDisplay}
Display can return position info: ${cap.hasPosition}
Display can return orientation info: ${cap.hasOrientation}
Display max layers: ${cap.maxLayers}`;
      listItem.insertBefore(
        document.createElement("strong"),
        listItem.firstChild,
      ).textContent = `Display ${i + 1}`;
      list.appendChild(listItem);
    });
  });
}

Spezifikationen

Diese Schnittstelle war Teil der alten WebVR API, die von der WebXR Device API abgelöst 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 auf ein Polyfill zurückzugreifen, um WebXR-Anwendungen zu entwickeln, die in allen Browsern funktionieren. Lesen Sie für weitere Informationen Metas Leitfaden zum Portieren von WebVR zu WebXR.

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch

WebVR API