VRDisplay：requestPresent() 方法

已弃用：此功能不再推荐。尽管某些浏览器可能仍然支持它，但它可能已从相关的 Web 标准中删除，可能正在被删除，或者可能仅出于兼容性目的而保留。请避免使用它，并在可能的情况下更新现有代码；请参阅此页面底部的兼容性表以指导您的决策。请注意，此功能可能随时停止工作。

非标准：此功能是非标准的，并且不在标准轨道上。请勿在面向 Web 的生产站点上使用它：它不会对每个用户都起作用。实现之间也可能存在很大的不兼容性，并且行为将来可能会发生变化。

requestPresent()是 VRDisplay 接口的方法，用于开始 VRDisplay 显示场景。

注意：此方法是旧版 WebVR API 的一部分。它已被 WebXR 设备 API 取代。

语法

requestPresent(layers)

参数

layers: 一个表示您想要呈现的场景的 VRLayerInit 对象数组。目前，此数组至少可以包含 0 个对象，最多可以包含 1 个对象。

返回值

一个 Promise，在呈现开始后解析。关于 Promise 的 fulfilled 或 rejected，有一些规则。

如果 VRDisplayCapabilities.canPresent 为 false，或者 VRLayer 数组包含的层数超过 VRDisplayCapabilities.maxLayers，则 Promise 将被 rejected。
如果在调用 requestPresent() 时 VRDisplay 已经在呈现，则 VRDisplay 将更新正在呈现的 VRLayer 数组。
如果在 VRDisplay 已经在呈现时，对 requestPresent() 的调用被 rejected，则它将结束呈现。
如果在没有用户交互的情况下调用 requestPresent()，则 Promise 将被 rejected，除非 VRDisplay 已经在呈现。此用户交互也足以允许 requestPointerLock() 调用，直到呈现结束。

示例

if (navigator.getVRDisplays) {
  console.log("WebVR 1.1 supported");
  // Then get the displays attached to the computer
  navigator.getVRDisplays().then((displays) => {
    // If a display is available, use it to present the scene
    if (displays.length > 0) {
      vrDisplay = displays[0];
      console.log("Display found");
      // Starting the presentation when the button is clicked: It can only be called in response to a user gesture
      btn.addEventListener("click", () => {
        if (btn.textContent === "Start VR display") {
          vrDisplay.requestPresent([{ source: canvas }]).then(() => {
            console.log("Presenting to WebVR display");

            // Set the canvas size to the size of the vrDisplay viewport

            const leftEye = vrDisplay.getEyeParameters("left");
            const rightEye = vrDisplay.getEyeParameters("right");

            canvas.width =
              Math.max(leftEye.renderWidth, rightEye.renderWidth) * 2;
            canvas.height = Math.max(
              leftEye.renderHeight,
              rightEye.renderHeight,
            );

            // stop the normal presentation, and start the vr presentation
            window.cancelAnimationFrame(normalSceneFrame);
            drawVRScene();

            btn.textContent = "Exit VR display";
          });
        } else {
          vrDisplay.exitPresent();
          console.log("Stopped presenting to WebVR display");

          btn.textContent = "Start VR display";

          // Stop the VR presentation, and start the normal presentation
          vrDisplay.cancelAnimationFrame(vrSceneFrame);
          drawScene();
        }
      });
    }
  });
}

注意：您可以在 raw-webgl-example 中看到完整的代码。

规范

此方法是旧版 WebVR API 的一部分，已被 WebXR 设备 API 取代。它不再有成为标准的计划。

在所有浏览器都实现了新的 WebXR API 之前，建议依靠框架（如 A-Frame、Babylon.js 或 Three.js）或 polyfill 来开发可在所有浏览器中运行的 WebXR 应用程序 [1]。

浏览器兼容性

BCD 表格仅在启用了 JavaScript 的浏览器中加载。

另请参阅

WebVR API