---
title: VRDisplay
slug: Web/API/VRDisplay
translation_of: Web/API/VRDisplay
---
<div>{{APIRef("WebVR API")}}{{SeeCompatTable}}</div>

<p><a href="/en-US/docs/Web/API/WebVR_API">WebVR API</a> 中的 <strong><code>VRDisplay </code></strong>代表任何支持此 API 的 VR 设备。它包括了设备 ID、描述信息等诸如此类的通用信息，以及用于开始呈现 VR 场景、检索眼睛参数和显示能力以及其他重要的功能和方法。</p>

<p>可以通过调用 {{domxref("Navigator.getVRDisplays()")}} 方法得到所有连接的 VR 设备数组。</p>

<h2 id="属性">属性</h2>

<dl>
 <dt>{{domxref("VRDisplay.capabilities")}} {{readonlyInline}}</dt>
 <dd>返回一个 {{domxref("VRDisplayCapabilities")}} 对象，用于指示 VRDisplay 的各种功能。</dd>
 <dt>{{domxref("VRDisplay.depthFar")}}</dt>
 <dd>获取或设置<a href="https://en.wikipedia.org/wiki/Viewing_frustum">眼睛可视锥</a>的最远深度。</dd>
 <dt>{{domxref("VRDisplay.depthNear")}}</dt>
 <dd>获取或设置<a href="https://en.wikipedia.org/wiki/Viewing_frustum">眼睛可视锥</a>的最近深度。</dd>
 <dt>{{domxref("VRDisplay.displayId")}} {{readonlyInline}}</dt>
 <dd>返回此 VRDisplay 的标识符，它也用作与 <a href="/en-US/docs/Web/API/Gamepad_API">Gamepad API</a> 的关联（详见 {{domxref("Gamepad.displayId")}}）。</dd>
 <dt>{{domxref("VRDisplay.displayName")}} {{readonlyInline}}</dt>
 <dd>返回一个不反人类的名称来标识此 <code>VRDisplay。</code></dd>
 <dt>{{domxref("VRDisplay.isConnected")}} {{readonlyInline}}</dt>
 <dd>返回一个 {{domxref("Boolean")}} 值，指示 <code>VRDisplay</code> 是否连接到计算机。</dd>
 <dt>{{domxref("VRDisplay.isPresenting")}} {{readonlyInline}}</dt>
 <dd>返回一个 {{domxref("Boolean")}} 值，指示 <code>VRDisplay</code> 当前是否由内容被呈现。</dd>
 <dt>{{domxref("VRDisplay.stageParameters")}} {{readonlyInline}}</dt>
 <dd>如果 VR 设备支持房间规模测验，则返回一个包含房间尺寸参数的 {{domxref("VRStageParameters")}} 对象。</dd>
</dl>

<h2 id="方法">方法</h2>

<dl>
 <dt>{{domxref("VRDisplay.getEyeParameters()")}}</dt>
 <dd>返回指定一侧眼睛参数的 {{domxref("VREyeParameters")}} 对象。</dd>
 <dt>{{domxref("VRDisplay.getLayers()")}}</dt>
 <dd>返回 VRDisplay 当前显示的图层。</dd>
 <dt>{{domxref("VRDisplay.getPose()")}}</dt>
 <dd>Returns a {{domxref("VRPose")}} object defining the future predicted pose of the <code>VRDisplay</code> as it will be when the current frame is actually presented.</dd>
 <dt>{{domxref("VRDisplay.getImmediatePose()")}}</dt>
 <dd>Returns a {{domxref("VRPose")}} object defining the current pose of the <code>VRDisplay</code>, with no prediction applied.</dd>
 <dt>{{domxref("VRDisplay.resetPose()")}}</dt>
 <dd>Resets the pose for this <code>VRDisplay</code>, treating its current {{domxref("VRPose.position")}} and {{domxref("VRPose.orientation")}} as the "origin/zero" values.</dd>
 <dt>{{domxref("VRDisplay.cancelAnimationFrame()")}}</dt>
 <dd>A special implementation of {{domxref("Window.cancelAnimationFrame")}} that allows callbacks registered with {{domxref("VRDisplay.requestAnimationFrame()")}} to be unregistered.</dd>
 <dt>{{domxref("VRDisplay.requestAnimationFrame()")}}</dt>
 <dd>A special implementation of {{domxref("Window.requestAnimationFrame")}} containing a callback function that will be called every time a new frame of the <code>VRDisplay</code> presentation is rendered.</dd>
 <dt>{{domxref("VRDisplay.requestPresent()")}}</dt>
 <dd>Starts the <code>VRDisplay</code> presenting a scene.</dd>
 <dt>{{domxref("VRDisplay.exitPresent()")}}</dt>
 <dd>Stops the <code>VRDisplay</code> presenting a scene.</dd>
 <dt>{{domxref("VRDisplay.submitFrame()")}}</dt>
 <dd>Captures the current state of the {{domxref("VRLayer")}} currently being presented and displays it on the <code>VRDisplay</code>.</dd>
</dl>

<h2 id="示例">示例</h2>

<pre>TBD.</pre>

<h2 id="规范">规范</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">Specification</th>
   <th scope="col">Status</th>
   <th scope="col">Comment</th>
  </tr>
  <tr>
   <td>{{SpecName('WebVR', '#interface-vrdisplay', 'VRDisplay')}}</td>
   <td>{{Spec2('WebVR')}}</td>
   <td>Initial definition</td>
  </tr>
 </tbody>
</table>

<h2 id="浏览器兼容性">浏览器兼容性</h2>

<p>{{CompatibilityTable}}</p>

<div id="compat-desktop">
<table class="compat-table">
 <tbody>
  <tr>
   <th>Feature</th>
   <th>Chrome</th>
   <th>Firefox (Gecko)</th>
   <th>Internet Explorer</th>
   <th>Opera</th>
   <th>Safari (WebKit)</th>
  </tr>
  <tr>
   <td>Basic support</td>
   <td>{{CompatVersionUnknown}}</td>
   <td>{{CompatVersionUnknown}}</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatNo}}</td>
  </tr>
 </tbody>
</table>
</div>

<div id="compat-mobile">
<table class="compat-table">
 <tbody>
  <tr>
   <th>Feature</th>
   <th>Android</th>
   <th>Firefox Mobile (Gecko)</th>
   <th>IE Phone</th>
   <th>Opera Mobile</th>
   <th>Safari Mobile</th>
   <th>Chrome for Android</th>
  </tr>
  <tr>
   <td>Basic support</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatVersionUnknown}}</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatNo}}</td>
  </tr>
 </tbody>
</table>
</div>

<h2 id="另请参见">另请参见</h2>

<ul>
 <li><a href="/en-US/docs/Web/API/WebVR_API">WebVR API 主页</a>。</li>
 <li><a href="http://mozvr.com/">MozVr.com</a> — 来源于 Mozilla VR 团队的演示、下载以及其他资源。</li>
</ul>