OpenVR[0] - 初步了解

0 序

开始用 HTC Vive 做项目，由于 OpenVR 并没有提供用于 Unity3D 的 C♯ 文档（只提供了 C++ API 文档），所以想写一个“第三方”的 OpenVR C♯ API 文档，借此机会提高姿势和水平。

由于作者的水平相当低，可想而知接下来一定会遇到众多问题，望读者海涵，如果有什么写得不对的地方请一定指出并往死里喷我，教我人生的经验。虽然我认为没人会读这东西。

1 对于OpenVR的初步认识

OpenVR 是由 Valve 公司开发的一套 VR 设备通用 API ，换而言之不管是 Oculus Rift 或 HTC Vive 甚至是其他 VR 设备，都不再需要使用产商提供的 SDK 就可以进行开发，有种打算一统天下的范儿。这套 API 并未开源所以具体实现未知。（由于 Vive 和 Oculus Rift 的原理看似一样但是其实对于画面的处理大相径庭，根据我大胆的瞎猜，我认为这套 API 只是帮我们在原先设备产商提供的 SDK 上又实现了一个能够通过统一接口访问的抽象层来，应该不是什么黑科技大概）

OpenVR 文件夹的结构大致如下：

\openvr
    \bin                用于各平台的dll、pdb文件
    \headers            用于 C++(.h) 和 C♯(.cs) 的头文件
                       （是根据本文件夹下的 openvr_api.json 自动生成的，不要手动编辑）
    \lib                用于各平台的lib文件
    \samples            C++、Unity 范例
    \unity_package    用于 Unity 的 Package

unity_package 是之后研究的重点。

2 OpenVR Unity Package

OpenVR Unity Package 包含以下脚本内容：

• \Plugins
  • openvr_api.cs
• \SteamVR
  • \Editor
    • SteamVR_Editor.cs
    • SteamVR_RenderModelEditor.cs
    • SteamVR_Settings.cs
    • SteamVR_SkyboxEditor.cs
    • SteamVR_Update.cs
  • \Scripts
    • SteamVR.cs
    • SteamVR_Camera.cs
    • SteamVR_CameraFlip.cs
    • SteamVR_CameraMask.cs
    • SteamVR_Controller.cs
    • SteamVR_ControllerManager.cs
    • SteamVR_Ears.cs
    • SteamVR_ExternalCamera.cs
    • SteamVR_Fade.cs
    • SteamVR_Frustum.cs
    • SteamVR_GameView.cs
    • SteamVR_IK.cs
    • SteamVR_LoadLevel.cs
    • SteamVR_Menu.cs
    • SteamVR_Overlay.cs
    • SteamVR_PlayArea.cs
    • SteamVR_Render.cs
    • SteamVR_RenderModel.cs
    • SteamVR_Skybox.cs
    • SteamVR_SphericalProjection.cs
    • SteamVR_Stats.cs
    • SteamVR_Status.cs
    • SteamVR_StatusText.cs
    • SteamVR_TestController.cs
    • SteamVR_TrackedObject.cs
    • SteamVR_UpdatePoses.cs
    • SteamVR_Utils.cs
  • \Extras
    • SteamVR_GazeTracker.cs
    • SteamVR_LaserPointer.cs
    • SteamVR_Teleporter.cs
    • SteamVR_TestThrow.cs
    • SteamVR_TrackedController.cs

事实上，只有 \Plugins 中的 open_api.cs 是直接与 OpenVR 打交道的，是它把 OpenVR 所有的 API 都暴露出来，并且声明了一些用于与其进行交换的数据结构。

\Scripts 下是官方为我们实现的一些能够处理 OpenVR 中的原始数据的方法，和能够方便的在 Unity 中调用的方法，官方的说法是“推荐我们修改并提出反馈”(You are encouraged to modify these to suit your project's unique needs, and provide feedback)，当然，我们这次的主题是看懂它，所以不作修改就我这水平，能看懂就不错了。

用过Unity的都知道 \Editor 下是一些编辑器脚本，\Extras 下是一些简单的应用，所以就不多提了。不过值得一说的是，Valve 还写了一个自动检测 Project Settings 等设置是否有问题且能够一键自动配置的编辑器扩展工具，简直比 Oculus 高到不知道哪里去了。

至于详细内容请参看 readme 此处不再叙述。

---

下一篇，我们主要研究 openvr_api.cs，了解 class OpenVR{} 中的方法。