VRDisplayCapabilities

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

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

Auf diese Schnittstelle kann über die VRDisplay.capabilities Eigenschaft zugegriffen werden.

Instanzeigenschaften

VRDisplayCapabilities.canPresent Veraltet Schreibgeschützt Nicht standardisiert: Gibt einen booleschen Wert zurück, der angibt, ob das VR-Display in der Lage ist, Inhalte zu präsentieren (z.B. über ein HMD).
VRDisplayCapabilities.hasExternalDisplay Veraltet Schreibgeschützt Nicht standardisiert: Gibt einen booleschen Wert zurück, der angibt, ob das VR-Display von dem primären Display des Geräts getrennt ist.
VRDisplayCapabilities.hasOrientation Veraltet Schreibgeschützt Nicht standardisiert: Gibt einen booleschen Wert zurück, der angibt, ob das VR-Display die Orientierung verfolgen und zurückgeben kann.
VRDisplayCapabilities.hasPosition Veraltet Schreibgeschützt Nicht standardisiert: Gibt einen booleschen Wert zurück, der angibt, ob das VR-Display die Position verfolgen und zurückgeben kann.
VRDisplayCapabilities.maxLayers Veraltet Schreibgeschützt 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 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 den Leitfaden Meta's Porting from WebVR to WebXR für weitere Informationen.

Browser-Kompatibilität

Siehe auch

WebVR API