MDN self-hosted library · e01.org

VRStageParameters

WebVR API

WebVR API

The VRStageParameters interface of the WebVR API represents the values describing the stage area for devices that support room-scale experiences.

[!NOTE] This interface was part of the old WebVR API. It has been superseded by the WebXR Device API.

This interface is accessible through the VRDisplay.stageParameters property.

Instance properties

  • VRStageParameters.sittingToStandingTransform
  • : Contains a matrix that transforms the sitting-space view matrices of VRFrameData to standing-space.
  • VRStageParameters.sizeX
  • : Returns the width of the play-area bounds in meters.
  • VRStageParameters.sizeZ
  • : Returns the depth of the play-area bounds in meters.

Examples

const info = document.querySelector("p");
let vrDisplay;

navigator.getVRDisplays().then((displays) => {
  vrDisplay = displays[0];
  const stageParams = vrDisplay.stageParameters;
  // stageParams is a VRStageParameters object

  if (stageParams === null) {
    info.textContent =
      "Your VR Hardware does not support room-scale experiences.";
  } else {
    info.innerText = `
Sitting to standing transform: ${stageParams.sittingToStandingTransform}
Play area width (m): ${stageParams.sizeX}
Play area depth (m): ${stageParams.sizeZ}`;
    info.insertBefore(
      document.createElement("strong"),
      info.firstChild,
    ).textContent = "Display stage parameters";
  }
});

Specifications

This interface was part of the old WebVR API that has been superseded by the WebXR Device API. It is no longer on track to becoming a standard.

Until all browsers have implemented the new WebXR APIs, it is recommended to rely on frameworks, like A-Frame, Babylon.js, or Three.js, or a polyfill, to develop WebXR applications that will work across all browsers. Read Meta's Porting from WebVR to WebXR guide for more information.

Browser compatibility

See also