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 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 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. durch ein HMD).
VRDisplayCapabilities.hasExternalDisplay Veraltet Schreibgeschützt 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 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 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