HMDVRDevice
Deprecated: This feature is no longer recommended. Though some browsers might still support it, it may have already been removed from the relevant web standards, may be in the process of being dropped, or may only be kept for compatibility purposes. Avoid using it, and update existing code if possible; see thecompatibility table at the bottom of this page to guide your decision. Be aware that this feature may cease to work at any time.
Non-standard: This feature is not standardized. We do not recommend using non-standard features in production, as they have limited browser support, and may change or be removed. However, they can be a suitable alternative in specific cases where no standard option exists.
TheHMDVRDevice interface of theWebVR API represents a head mounted display, providing access to information about each eye, and allowing us to modify the current field of view.
Instance methods
HMDVRDevice.getEyeParameters()DeprecatedNon-standardReturns current parameters for the eye specified as its argument ("left" or "right") — such as field of view information — stored in a
VREyeParametersobject.HMDVRDevice.setFieldOfView()DeprecatedNon-standardSets the field of view for both eyes.
Instance properties
This interface doesn't define any properties of its own, but it does inherit the properties of its parent interface,VRDisplay.
VRDisplay.hardwareUnitIdRead onlyReturns the distinct hardware ID for the overall hardware unit that this
VRDeviceis a part of. All devices that are part of the same physical piece of hardware will have the samehardwareUnitId.VRDisplay.displayIdRead onlyReturns the ID for this specific
VRDevice. The ID shouldn't change across browser restarts, allowing configuration data to be saved based on it.VRDisplay.displayNameRead onlyA human-readable name to identify the
VRDevice.
Examples
The following example, taken from the WebVR spec, finds the first availableHMDVRDevice and its associatedPositionSensorVRDevice, if it has one.
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; } } }});