blob: 7af25cdf7328865c10ed4fcd7a76a2e7b1340a0c (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
|
---
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>
{{Compat("api.VRDisplay")}}
<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>
|