VRStageParameters

已弃用:此特性不再推荐。虽然某些浏览器可能仍然支持它,但它可能已经从相关的网络标准中删除,可能正在删除过程中,或者可能仅为兼容性目的而保留。请避免使用它,如果可能,请更新现有代码;请参阅本页底部的兼容性表格以指导您的决策。请注意,此特性可能随时停止工作。

非标准:此特性未标准化。我们不建议在生产环境中使用非标准特性,因为它们浏览器支持有限,并且可能会更改或被移除。但是,在没有标准选项的特定情况下,它们可以是合适的替代方案。

VRStageParameters 接口是 WebVR API 的一部分,用于描述支持房间尺度体验的设备的舞台区域的值。

注意: 此接口是旧版 WebVR API 的一部分。它已被 WebXR Device API 取代。

可以通过 VRDisplay.stageParameters 属性访问此接口。

实例属性

VRStageParameters.sittingToStandingTransform 已弃用 只读 非标准

包含一个将 VRFrameData 的坐姿视图矩阵转换为站姿视图矩阵的矩阵。

VRStageParameters.sizeX 已弃用 只读 非标准

返回 以米为单位的活动区域边界的宽度。

VRStageParameters.sizeY 已弃用 只读 非标准

返回 以米为单位的活动区域边界的深度。

示例

js
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.sizeY}`;
    info.insertBefore(
      document.createElement("strong"),
      info.firstChild,
    ).textContent = "Display stage parameters";
  }
});

规范

此接口是旧的 WebVR API 的一部分,该 API 已被 WebXR Device API 取代。它已不再是标准的制定方向。

在所有浏览器都实现新的 WebXR API 之前,建议依靠 A-FrameBabylon.jsThree.js 等框架,或 polyfill 来开发可在所有浏览器上运行的 WebXR 应用程序。有关更多信息,请阅读 Meta 的从 WebVR 移植到 WebXR 指南。

浏览器兼容性

另见