VRDisplay
WebVR API 中的 VRDisplay 代表任何支持此 API 的 VR 设备。它包括了设备 ID、描述信息等诸如此类的通用信息,以及用于开始呈现 VR 场景、检索眼睛参数和显示能力以及其他重要的功能和方法。
可以通过调用 Navigator.getVRDisplays() (en-US) 方法得到所有连接的 VR 设备数组。
属性
VRDisplay.capabilities(en-US) 只读-
返回一个
VRDisplayCapabilities(en-US) 对象,用于指示 VRDisplay 的各种功能。 VRDisplay.depthFar(en-US)-
获取或设置眼睛可视锥的最远深度。
VRDisplay.depthNear(en-US)-
获取或设置眼睛可视锥的最近深度。
VRDisplay.displayId(en-US) 只读-
返回此 VRDisplay 的标识符,它也用作与 Gamepad API 的关联(详见
Gamepad.displayId(en-US))。 VRDisplay.displayName(en-US) 只读-
返回一个不反人类的名称来标识此
VRDisplay。 VRDisplay.isConnected(en-US) 只读-
返回一个
Boolean(en-US) 值,指示VRDisplay是否连接到计算机。 VRDisplay.isPresenting(en-US) 只读-
返回一个
Boolean(en-US) 值,指示VRDisplay当前是否由内容被呈现。 VRDisplay.stageParameters(en-US) 只读-
如果 VR 设备支持房间规模测验,则返回一个包含房间尺寸参数的
VRStageParameters(en-US) 对象。
方法
VRDisplay.getEyeParameters()(en-US)-
返回指定一侧眼睛参数的
VREyeParameters(en-US) 对象。 VRDisplay.getLayers()(en-US)-
返回 VRDisplay 当前显示的图层。
VRDisplay.getPose()(en-US)-
Returns a
VRPoseobject defining the future predicted pose of theVRDisplayas it will be when the current frame is actually presented. VRDisplay.getImmediatePose()(en-US)-
Returns a
VRPoseobject defining the current pose of theVRDisplay, with no prediction applied. VRDisplay.resetPose()(en-US)-
Resets the pose for this
VRDisplay, treating its currentVRPose.position(en-US) andVRPose.orientation(en-US) as the "origin/zero" values. VRDisplay.cancelAnimationFrame()(en-US)-
A special implementation of
Window.cancelAnimationFramethat allows callbacks registered withVRDisplay.requestAnimationFrame()to be unregistered. VRDisplay.requestAnimationFrame()-
A special implementation of
Window.requestAnimationFramecontaining a callback function that will be called every time a new frame of theVRDisplaypresentation is rendered. VRDisplay.requestPresent()(en-US)-
Starts the
VRDisplaypresenting a scene. VRDisplay.exitPresent()(en-US)-
Stops the
VRDisplaypresenting a scene. VRDisplay.submitFrame()(en-US)-
Captures the current state of the
VRLayer(en-US) currently being presented and displays it on theVRDisplay.
示例
TBD.
规范
该 API 在旧的 WebVR API(已被 WebXR Device API 取代)中定义。它不再有望成为标准。
在所有浏览器都实现新的 WebXR API (en-US) 之前,建议使用框架(如:A-Frame、Babylon.js 或 Three.js)或 polyfill 来开发适用于所有浏览器的 WebXR 应用程序。[1]
浏览器兼容性
BCD tables only load in the browser
参见
- WebVR API 主页。
- MozVr.com — 来源于 Mozilla VR 团队的演示、下载以及其他资源。