Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

VRDisplayCapabilities

Deprecated

Avoid using this feature in new projects. Development of the WebVR API halted in favor of WebXR. This feature may be a candidate for removal from web standards or browsers.

Consider using the following features instead: WebXR.

Nicht standardisiert: Diese Funktion ist nicht standardisiert. Wir raten davon ab, nicht-standardisierte Funktionen auf produktiven Webseiten zu verwenden, da sie nur von bestimmten Browsern unterstützt werden und sich in Zukunft ändern oder entfernt werden können. Unter Umständen kann sie jedoch eine geeignete Option sein, wenn es keine standardisierte Alternative gibt.

Das VRDisplayCapabilities-Interface der WebVR API beschreibt die Fähigkeiten eines VRDisplay – seine Eigenschaften können verwendet werden, um Tests zur VR-Gerätefähigkeit durchzuführen, zum Beispiel ob es Positionsinformationen zurückgeben kann.

Hinweis: Dieses Interface war Teil der alten WebVR API. Es wurde durch die WebXR Device API ersetzt.

Dieses Interface ist über die VRDisplay.capabilities-Eigenschaft zugänglich.

Instanz-Eigenschaften

VRDisplayCapabilities.canPresent Schreibgeschützt

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 Schreibgeschützt

Gibt einen booleschen Wert zurück, der angibt, ob das VR-Display von der Primäranzeige des Geräts getrennt ist.

VRDisplayCapabilities.hasOrientation Schreibgeschützt

Gibt einen booleschen Wert zurück, der angibt, ob das VR-Display die Ausrichtung verfolgen und zurückgeben kann.

VRDisplayCapabilities.hasPosition Schreibgeschützt

Gibt einen booleschen Wert zurück, der angibt, ob das VR-Display die Position verfolgen und zurückgeben kann.

VRDisplayCapabilities.maxLayers Schreibgeschützt

Gibt eine Zahl zurück, 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

js
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

Dieses Interface war Teil der alten WebVR API, die durch die WebXR Device API ersetzt wurde. Es ist nicht mehr auf dem Weg, ein Standard zu werden.

Bis alle Browser die neuen WebXR APIs implementiert haben, wird empfohlen, sich auf Frameworks wie A-Frame, Babylon.js oder Three.js oder ein Polyfill zu stützen, um WebXR-Anwendungen zu entwickeln, die in allen Browsern funktionieren. Lesen Sie Metas Leitfaden zum Portieren von WebVR auf WebXR für weitere Informationen.

Browser-Kompatibilität

Siehe auch