{"json_modified": "2016-05-12T14:13:26.203999", "uuid": "057b19dd-223a-494f-b438-eb2c76e922af", "title": "PositionSensorVRDevice.getState()", "url": "/en-US/docs/Web/API/PositionSensorVRDevice/getState", "tags": ["API", "VR", "Obsolete", "Reference", "Experimental", "R\u00e9f\u00e9rence", "Exp\u00e9rimental", "PositionSensorVRDevice", "Virtual Reality", "WebVR", "Api", "Method"], "translations": [], "modified": "2016-05-12T14:13:26", "label": "PositionSensorVRDevice.getState()", "localization_tags": [], "locale": "en-US", "id": 149685, "last_edit": "2016-05-12T14:13:22", "summary": "The <strong><code>getState()</code></strong> method of the <a href=\"/en-US/docs/Web/API/PositionSensorVRDevice\" title=\"The PositionSensorVRDevice interface of the WebVR API represents VR hardware's position sensor. You can access information such as the current position and orientation of the sensor in relation to the head mounted display through the PositionSensorVRDevice.getState() method.\"><code>PositionSensorVRDevice</code></a> interface returns the current state of the position sensor for the current frame (e.g. within the current <a href=\"/en-US/docs/Web/API/Window/requestAnimationFrame\" title=\"You should call this method whenever you're ready to update your animation onscreen. This will request that your animation function be called before the browser performs the next repaint. The number of callbacks is usually 60 times per second, but will generally match the display refresh rate in most web browsers as per W3C recommendation. The callback rate may be reduced to a lower rate when running in background tabs or in hidden &lt;iframe&gt;s in order to improve performance and battery life.\"><code>window.requestAnimationFrame</code></a> callback) or for the previous frame, contained with a <a href=\"/en-US/docs/Web/API/VRPositionState\" title=\"The documentation about this has not yet been written; please consider contributing!\"><code>VRPositionState</code></a> object. This is the method you'd normally want to use, versus <a href=\"/en-US/docs/Web/API/PositionSensorVRDevice/getImmediateState\" title=\"The getImmediateState() method of the VRDevice interface returns the current instantaneous position sensor state. This is intended to only be used rarely, for certain special uses, for example sampling the immediate position of a hand orientation sensor &#x2014; or at least it will be, in the future.\"><code>PositionSensorVRDevice.getImmediateState</code></a>.", "sections": [{"id": "Quick_Links", "title": null}, {"id": "Syntax", "title": "Syntax"}, {"id": "Parameters", "title": "Parameters"}, {"id": "Returns", "title": "Returns"}, {"id": "Examples", "title": "Examples"}, {"id": "Specifications", "title": "Specifications"}, {"id": "Browser_compatibility", "title": "Browser compatibility"}, {"id": "See_also", "title": "See also"}], "slug": "Web/API/PositionSensorVRDevice/getState", "review_tags": []}