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

View in English Always switch to English

HMDVRDevice

Deprecated

Avoid using this feature in new projects. This feature may be a candidate for removal from web standards or browsers.

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.

Die Schnittstelle HMDVRDevice der WebVR API repräsentiert ein Head-Mounted Display. Sie stellt Informationen über jedes Auge bereit und ermöglicht es, das aktuelle Sichtfeld zu ändern.

Instanzeigenschaften

Diese Schnittstelle definiert keine eigenen Eigenschaften, erbt aber die Eigenschaften ihrer übergeordneten Schnittstelle VRDisplay.

VRDisplay.hardwareUnitId Schreibgeschützt

Gibt die eindeutige Hardware-ID der gesamten Hardwareeinheit zurück, zu der dieses VRDevice gehört. Alle Geräte, die zur selben physischen Hardwareeinheit gehören, haben dieselbe hardwareUnitId.

VRDisplay.displayId Schreibgeschützt

Gibt die ID dieses bestimmten VRDevice zurück. Die ID sollte sich bei einem Neustart des Browsers nicht ändern, damit Konfigurationsdaten anhand dieser ID gespeichert werden können.

VRDisplay.displayName Schreibgeschützt

Ein für Menschen lesbarer Name zur Identifizierung des VRDevice.

Instanzmethoden

HMDVRDevice.getEyeParameters()

Gibt die aktuellen Parameter für das als Argument angegebene Auge („left“ oder „right“) zurück, beispielsweise Informationen zum Sichtfeld. Die Parameter werden in einem VREyeParameters-Objekt gespeichert.

HMDVRDevice.setFieldOfView()

Legt das Sichtfeld für beide Augen fest.

Beispiele

Das folgende Beispiel aus der WebVR-Spezifikation findet das erste verfügbare HMDVRDevice und, falls vorhanden, das zugehörige PositionSensorVRDevice.

js
navigator.getVRDevices().then((devices) => {
  for (const device of devices) {
    if (device instanceof HMDVRDevice) {
      gHMD = device;
      break;
    }
  }

  if (gHMD) {
    for (const device of devices) {
      if (
        device instanceof PositionSensorVRDevice &&
        device.hardwareUnitId === gHMD.hardwareUnitId
      ) {
        gPositionSensor = devices[i];
        break;
      }
    }
  }
});

Browser-Kompatibilität

Siehe auch