最近可能是元宇宙这概念火了，有挺多小伙伴私信说对VR开发产生浓浓的兴趣，想知道关于OpenVR的API介绍等等。
大家可以看看官方的OpenVR API
链接：官方OpenVR API
如果想在开发VR游戏的时候，选择切换键鼠输入还是VR端输入，可了解一下这些API
初始化与关闭释放：
由于OpenVR API能使游戏能够连接任何添加VR的外设，因此它不是自动初始化。调用函数VR_Init来初始化OpenVR API以及访问接口IVRSystem；
调用VR_Shutdown来断开游戏与外设的连接以及释放IVRSystem接口。
程序通过IVRSystem来调用其他的OpenVR API方法。如果调用失败，则将返回NULL并且赋给peError一个错误码用来指示错误内容。peError为产生的错误代码或者没有错误时为VRInitError_None。错误码如下：
-
HmdError_None (0)- 无错误 -
HmdError_Unknown (1)- 未知错误 -
HmdError_Init_InstallationNotFound (100)- 在路径注册表中指定的安装文件夹不存在 -
HmdError_Init_InstallationCorrupt (101)- 在路径注册表中指定的安装文件夹没有bin文件夹 -
HmdError_Init_VRClientDLLNotFound (102)- bin文件夹中没有vrclient.dll 或系统对应的动态库 -
HmdError_Init_FileNotFound (103)- 驱动不能加载 -
HmdError_Init_FactoryNotFound (104)- vrclient.dll中的工厂方法找不到，是vrclient.dll出现异常吗? -
HmdError_Init_InterfaceNotFound (105)- VR_Init或VR_GetGenericInterface 请求的接口不存在，是使用的SDK版本比安装的runtime版本更新吗？ -
HmdError_Init_InvalidInterface (106)- 错误码当前没有被使用 -
HmdError_Init_UserConfigDirectoryInvalid (107)- 路径注册表中的配置目录不可写 -
HmdError_Init_HmdNotFound (108)- HMD没有添加到系统或者HMD没有初始化，该错误很常见，就是因为设备没有检测到
-
HmdError_Init_NotInitialized (109)- 如果VR_GetGenericInterface在VR_Init之前或者在VR_Shutdown之后被调用会返回这个错误 -
HmdError_Init_PathRegistryNotFound (110)- VR路径注册文件不能被读。重新安装OpenVR runtime或Steam上的SteamVR应用程序 -
HmdError_Init_NoConfigPath (111)- 配置路径没有在路径注册表中指定 -
HmdError_Init_NoLogPath (112)- log路径没有在路径注册表中指定 -
HmdError_Init_PathRegistryNotWritable (113)- VR路径注册表不可写 -
HmdError_Driver_Failed (200)- 驱动初始化失败，内部错误 -
HmdError_Driver_Unknown (201)- 驱动由于位置原因失败，内部错误 -
HmdError_Driver_HmdUnknown (202)- 驱动未检测到HMD，内部错误 -
HmdError_Driver_NotLoaded (203)- 在该驱动发出请求前，还没有加载，内部错误 -
HmdError_Driver_RuntimeOutOfDate (204)- 如果一个驱动自带runtime，那么需要更新它的runtime. -
HmdError_Driver_HmdInUse (205)- 另外一个非OpenVR的应用程序正在使用HMD -
HmdError_IPC_ServerInitFailed (300)- OpenVR不能够启动vrserver. -
HmdError_IPC_ConnectFailed (301)- 多次尝试后，OpenVR不能链接到vrserver或vrcompositor. -
HmdError_IPC_SharedStateInitFailed (302)- vrserver或vrcompositor的共享内存不能够打开 -
HmdError_IPC_CompositorInitFailed (303)- OpenVR不能够启动vrcompositor. -
HmdError_IPC_MutexInitFailed (304)- OpenVR不能够创建互斥量来与vrcompositor通信. -
HmdError_VendorSpecific_UnableToConnectToOculusRuntime (1000)- 由于未知原因导致到Oculus runtime的连接失败. -
HmdError_Steam_SteamInstallationNotFound (2000)- 当前没有使用的错误码.
根据以上错误代码，可以解决相应的报错问题
接口：
API被分成了多个接口，其中标记黄色的为主要接口：
- IVRSystem：主要提供用来处理显示，畸变，追踪，控制以及事件访问的接口
- IVRChaperone：主要用来提供访问监护软硬件界限的接口
- IVRCompositor：允许通过VR混合器来使得一个应用程序渲染3D内容
- IVROverlay：允许通过VR混合器来使得一个应用程序渲染2D内容
- IVRRenderModels：允许应用程序访问渲染模型
- IVRInput ：允许应用程序定义和查询调用操作(和操作集)，以便用户可以创建、编辑和与任何受支持的设备共享自定义绑定。
- IVRScreenshots:允许应用程序请求与提交截图
- IVRChaperoneSetup:主要用来设置访问监护软硬件界限
- IVRResources：主要用来加载资源的接口
- IVRExtendedDisplay：提供扩展显示区域的接口
- IVRSettings:主要用来对VR混合器的属性配置接口
- IVRApplications：主要用来进行对程序的管理接口
- IVRTrackedCamera：提供追踪VR摄像机的接口
- IVRDriverManager:用来提供检测满足VR运行的驱动程序的接口
常用的函数:
VR_Shutdown()
关闭VR硬件的连接且清除OpenVR API，调用该函数后，由VR_Init返回的IVRSystem指针无效。
bool VR_IsHmdPresent()
如果系统认为HMD存在系统中，则返回true。该函数比初始化所有的OpenVR API都要快，它仅仅是为了检测HMD。
该函数会在VR_Init()返回NULL情况下返回true。这是一个快速告诉用户现在没有VR硬件的方法，但是还是有一些启动条件必须通过启动系统才能够检测到。
bool VR_IsRuntimeInstalled()
当OpenVR runtime安装在系统上时，返回true。
char VR_RuntimePath()
返回OpenVR runtime的安装目录
char VR_GetVRInitErrorAsSymbol(EVRInitError error)
该函数以字符串的形式返回EVRInitError枚举量的值。它在任何时间都可以被调用，而且与VR系统是否启动无关。
void VR_GetGenericInterface(char pchInterfaceVersion, EVRInitError peError)
该函数通过OpenVR提供的名字返回一个接口。如果该接口未找到，则它会返回NULL且在peError中回传一个错误码。如果vr::VR_Init()没有成功的被调用，则它会返回NULL。
有些API还没用到过，根据官方文档翻译了一下，如有错误请指出，谢谢哈~