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{} 中的方法。

OpenVR[0] - 初步了解