blob: 60f52c60cf26be63c62fa54f45defa688a564356 (
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
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
|
---
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>
|