Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten.Erfahre mehr über dieses Experiment.
PositionSensorVRDevice
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 dieKompatibilitä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. 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.
DasPositionSensorVRDevice-Interface derWebVR API repräsentiert den Positionssensor der VR-Hardware. Sie können Informationen wie die aktuelle Position und Orientierung des Sensors in Bezug auf das Head-Mounted Display über die MethodePositionSensorVRDevice.getState() abrufen.
Instanzmethoden
PositionSensorVRDevice.getState()VeraltetNicht standardisiertGibt den aktuellen Zustand des Positionssensors für den aktuellen Frame zurück (z. B. innerhalb des aktuellen
window.requestAnimationFrame-Callbacks) oder für den vorherigen Frame, enthalten in einemVRPose-Objekt. Dies ist die Methode, die Sie normalerweise verwenden möchten, im Gegensatz zugetImmediateState().PositionSensorVRDevice.getImmediateState()VeraltetNicht standardisiertGibt den aktuellen momentanen Zustand des Positionssensors zurück. Dies ist nur selten zu verwenden, für bestimmte Spezialfälle, beispielsweise um die unmittelbare Position eines Handsensors zu erfassen – oder zumindest wird es in der Zukunft der Fall sein.
PositionSensorVRDevice.resetSensor()VeraltetNicht standardisiertKann verwendet werden, um den Sensor zurückzusetzen, falls gewünscht, und die Position und Orientierungswerte auf null zurückzusetzen.
Instanzeigenschaften
Dieses Interface definiert keine eigenen Eigenschaften, aber es erbt die Eigenschaften seines Eltern-Interfaces,VRDisplay.
VRDisplay.displayIdSchreibgeschütztGibt die ID für dieses spezifische
VRDevicezurück. Die ID sollte sich über Browser-Neustarts hinweg nicht ändern, sodass Konfigurationsdaten basierend darauf gespeichert werden können.VRDisplay.displayNameSchreibgeschütztEin lesbarer Name, um das
VRDevicezu identifizieren.
Beispiele
Das folgende Beispiel verwendet die WebVR API, um die Ansicht einer einfachen2D-Canvas-Szene in jedem Frame einerrequestAnimationFrame-Schleife zu aktualisieren.
function setView() { const posState = gPositionSensor.getState(); if (posState.hasPosition) { posPara.textContent = `Position: x${roundToTwo( posState.position.x, )} y${roundToTwo(posState.position.y)} z${roundToTwo(posState.position.z)}`; xPos = -posState.position.x * WIDTH * 2; yPos = posState.position.y * HEIGHT * 2; zPos = -posState.position.z > 0.01 ? -posState.position.z : 0.01; } if (posState.hasOrientation) { orientPara.textContent = `Orientation: x${roundToTwo( posState.orientation.x, )} y${roundToTwo(posState.orientation.y)} z${roundToTwo( posState.orientation.z, )}`; xOrient = posState.orientation.x * WIDTH; yOrient = -posState.orientation.y * HEIGHT * 2; zOrient = posState.orientation.z * 180; }}Hier greifen wir auf einVRPose-Objekt mithilfe vonPositionSensorVRDevice.getState() zu und speichern es inposState. Wir prüfen dann, ob Positions- und Orientierungsinformationen im aktuellen Frame vorhanden sind, indem wirVRPose.position undVRPose.orientation verwenden (diese gebennull zurück, wenn zum Beispiel das Head-Mounted Display ausgeschaltet ist oder nicht auf den Positionssensor zeigt, was zu einem Fehler führen würde).
Wir geben dann die x-, y- und z-Position und -Orientierungswerte zu Informationszwecken aus und verwenden diese Werte, um die VariablenxPos,yPos,zPos,xOrient,yOrient undzOrient zu aktualisieren, die verwendet werden, um die Szenen-Rendering in jedem Frame zu aktualisieren.