SteamVR Unity Plugin - v2.0.1中的InteractionSystem

最近写VR项目的时候用到了SteamVR Unity Plugin - v2.0.1插件，感受比以前用到的SteamVR plugin for Unity - v1.2.2版本改进了不少，就算不用VRTK插件，也能实现不少交互操做了。在此记录一下新版本插件的中的主要内容。（主要是根据InteractionSystem文档和本身的理解）

这个InteractionSystem包括一系列脚本，预制件和其余资产资源，这个系统专门设计的轻巧灵活。。其中大多数包含的组件在实际案例中都运用到了，但也包括一些没有在案例中用到的组件，可是它可能也是有用的。

1.首先概述一下示例场景中包括的预制件和脚本主要的功能：

Player：这个预制件是整个系统的核心，大多数其余组件都依赖于player
Teleporting：传送预制件处理全部关于传送的逻辑。
InteractableExample：这个类是一个和手柄进行简单交互的类。会接收手柄发来的信息并做出反应。
Throwables：这个展现了在游戏中怎样使用交互系统来建立一些更复杂的可以被使用的对象。
UI&Hints：这个显示了交互系统如何处理提示。而且如何使用它和Unity UI控件像按钮同样进行交互。
LinearDrive：这是一个稍微复杂的交互，能够经过简单的直线移动操做对象来控制的目标对象进行螺旋上升和降低。
CircularDrive：这个类主要实现了经过手柄控制一个圆盘的转动
Longbow：这是案例中使用的长弓。是这个系统建立的更复杂的对象之一。

2.简单介绍交互系统

交互系统的核心是Player，Hand和Interactable类。Player预制件为场景设置play对象和SteamVR摄像机。这个交互系统经过发送信息给场景中全部能够和手柄进行交互的对象，这个对象再对接收的信息做出反应。并能够设置对象附着到手柄上。为了接收手的信息只要添加Interactable组件到对象上，这个对象就能够根据手的信息做出相应的悬停监测。还包括了一些经常使用的可交互方式，例如Throwable（扔）或者LinearDrive（直线移动物体）。Player预制件也建立了一个用于模仿鼠标事件能够简单地用Unity UI控件控制的输入模式。交互系统也包括一个传统的第一人称摄像机，用键盘和鼠标控制。鼠标就相似人的一只手同样。当开发者没有VR头显时，这个模式就很是有用了。

3.Player类的功能介绍

-Player类是一个单例，意味着在一个场景中只有一个Player对象。
-Player主要功能是持续追踪手柄和头显。
-它能够在整个项目中全局访问，而且交互系统的许多方面都假定Player对象始终存在于场景中。
-不论是VR模式仍是2D fallback模式，它都保持追踪。
-经过Player类使用访问器容许其余组件以相似的方式运行，而不知道是否正在使用VR头显或鼠标/键盘。
-2D fallback模式虽然有用，但仍然有限制。此模式主要用于测试很是简单的交互，仅限于一个手和触发按钮。它对于一个团队在开发中，并不能保证每一个人一直都有一个VR头显和控制器设备。
-Player的一些有用的属性：
-hmdTransform:一只返回当前摄像机的transform。多是VR头显和2D fallback camera。
-feetPositionGuess:根据头显的位置猜想玩家脚的位置。但不能准确知道脚的位置，根据玩家的站立方式，这可能很是不许确。
-bodyDirectionGuess:相似于feetPositionGuess，根据玩家的站立方式，这可能很是不许确。
注意：在编辑场景中，player类设置使用icons显示feet和hands。但因为unity工做方式，须要将Core/icons移动到根目录下Gizmos中，才能起做用。
-关闭2D fallback mode的两种方式：
一、在build以前，将player的属性面板中Allow Toggle To 2D取消勾选
二、在PlayerSetting.Player中Scripting Define Symbols增长HIDE_DEBUG_UI。这将会在build时取消2D debug view，但容许在编辑器中使用。

4.Hand类的功能介绍

-Hand类为交互系统完成了大部分繁重工做。
-Hand检测正在悬停的对象（Interactables）并根据当前的悬停状态向它们发送消息。
-hand在同一时间只能悬停在一个对象，在相同时间只能有一只hand能悬停在一个对象。
-对象能够附着在手柄上，也能够从手柄上分离。只有一个对象能够是手柄的焦点对象，可是同时能够将多个对象附加到手柄上。
-一旦一个对象从手柄上分离，那么以前附着在手柄上的对象（仍然附着在手柄上）会成为手柄的焦点对象。
-当手柄上没有任何东西时，它将始终显示手柄控制器。
-当对象一旦附着在手柄上时，能够给附着在手柄上的对象能够设置一个附着标志物UI来肯定手柄和对象的行为。
-根据状况，能够锁定手柄以悬停在其余物体或任何物体上。
-这些是hand发送给交互物体的信息：
OnHandHoverBegin: 当手柄首次开始悬停在对象上时发送
HandHoverUpdate: 悬停在对象上时，每一帧都发送信息
OnHandHoverEnd: 当手柄中止悬停在对象上时发送
OnAttachedToHand: 当对象附加到手柄上时发送
-HandAttachedUpdate: 附加到手柄上时，每一帧都发送信息
OnDetachedFromHand: 当对象从手柄中分离时发送
OnHandFocusLost: 当附加对象失去焦点时发送，由于其余东西已附加到手柄上
OnHandFocusAcquired: 附加对象得到焦点时发送，由于前一个焦点对象已从手柄中分离
- 这些是手柄发送给其子对象的消息：
OnHandInitialized: 经过将本身与SteamVR跟踪控制器的设备ID相关联来首次初始化手柄时发送
OnParentHandHoverBegin: 当手柄开始悬停在某物上时发送
OnParentHandHoverEnd: 当手柄中止悬停在某物上时发送
OnParentHandInputFocusAcquired: 当游戏窗口得到输入焦点时发送
OnParentHandInputFocusLost: 当游戏窗口失去输入焦点时发送
- 这些成员处理附加和分离：
AttachObject: 将传入的附加标签设置在附着对象上
DetachObject: Detaches the object from the hand and optionally restores it to its original parent currentAttachedObject: This returns the in-focus attached object on the hand,if any
- Hand还有一些有用的属性和函数可用于自定义其行为：
OtherHand: 这是玩家控制的另外一只手柄。这对于须要用两个手柄交互的对象（例如长弓）很是有用。
HoverSphereTransform and Radius: 这可用于自定义手柄的悬停范围。
HoverLayerMask: 这能够改变，以便手柄只悬停在某些层中的对象上。
HoverUpdateInterval: 根据游戏的要求，能够设置进行悬停检测的时间间隔。
HoverLock/Unlock: 这用于使手柄仅悬停在某个对象上。当hover locked时，传入为null将使得手柄不会悬停在任何东西上。此技术用于在传送arc处于活动状态时使手柄不悬停在对象上
GetStandardInteractionButton/Up/Down: 这些用于检查手柄上的扳机的状态。 这对于也能够与2D fallback一块儿使用的简单对象很是有用。 在2D fallback状况下，左键单击用做标准交互按钮，对象的行为相同。
GuessCurrentHandType: 这使用一些SteamVR函数来肯定哪一个手柄最左边哪一个是最右边的。
GetAttachmentTransform: 物体可使用手上的“attachment transforms”来弄清楚如何附着到手柄上的transform。

5.Interactable类更像是一个标识符。它向Hand标识该对象是可交互的。具备此组件的任何对象都将从Hand接收相关消息。

仅使用以上这3个组件，就能够可以建立许多不一样且复杂的交互式对象。

6.Throwable类的主要功能：

这是最基本的交互式对象之一。
- 当手柄在其上悬停并按下交互键（扳机）时，玩家能够拾取此对象。
- 按下扳机时，物体会附在手柄上并保持在那里。
- 当释放扳机时，手柄的速度都会赋给抛出对象。
- 这能够建立能够拾取和抛出的基本对象。

7.LinearDrive类的主要功能是容许用手柄在开始和结束点之间移动对象，对象的当前位置用于设置LinearMapping。

8.CircularDrive类的主要功能是容许用手柄控制圆盘转动。对象的当前位置用于设置LinearMapping。

9.LinearMapping值由LinearDrive和CircularDive设置
-映射可用于将简单的手部交互映射到更复杂的行为。
-一个例子是长弓中的字符串，它使用LinearMapping将弓弦的拉动映射到长弓拉回动画。
-几个其余类使用该映射来插入其属性
LinearAnimation
LinearAnimator
LinearBlendShape
LinearDisplacement
HapticRack

10.VelocityEstimator类可用于根据对象位置的变化估计对象的速度和加速度。在大多数状况下，若是从实际控制器得到速度和加速度，将得到更准确的结果，但有时这是不可能的，例如使用2Dfallback hand时。

11.IgnoreHovering类主要功能是，当你但愿某对象不进行悬停检查时，则能够将此组件添加到该对象或特定的碰撞器上。

12.UIElement类的主要功能：

将此组件添加到unity的UI控件上，则手就能够与UI进行交互。
这将生成基于手部交互的鼠标悬停和单击事件，并经过Unity事件系统发送它们以使用现有的UI控件。
此外，它还将生成一个OnHandClick事件，该事件也将传递到点击的那个手柄。

13.ItemPackage类的主要功能：

-ItemPackage是用于暂时覆盖手柄的功能的对象集合
-在长弓的例子中，当长弓被手柄拿起后，长弓和手柄就结合在一块儿，并暂时替代手柄的功能。
-ItenPackages的概念是可以捡起和放回到物体被捡起的地方。
-一旦附带ItemPackage组件的对象被拿起，此对象会附着在手柄上，直到此对象被放回。不须要按钮就可让此对象保持在手柄上。手柄仍然能够正常的传递消息（与场景中的对象交互），但此对象一般会禁用手柄的某些功能，例如手柄的悬停功能。

14.ItemPackageSpawner脚本处理产生和收起ItemPackage时的逻辑，以及如何在产生后将物品附加到手柄上。还能够处理拾取对象的展现和预览或者拾取对象的轮廓。

15.ItemPackageReference能够将此组件添加到对象以指示它是组合对象的一部分。

16.PlaySound这个类容许使用更多参数来使用AudioClips。能够接收多个AudioClips而且每次随机播放一个。还能够随机播放剪辑的方式。

17.SoundPlayOneShot类专门用于播放一次且不循环播放的声音或者须要在播放时暂停的声音。

18.Util类中全是interaction system中用到的工具方法。

19.InteractableHoverEvents当收到手柄传递的信息时这个类生成UnityEvents。

20.InteractableButtonEvents此类将手柄按钮输入转换为UnityEvents。

21.ComplexThrowable类当手接触对象时使用物理关节而不是simple parenting，这容许在手接触对象时进行更多基于物理的交互。
注意：这个类是实验性的，尚未真正运用到场景中，此类的功能是不完整的而且可能有错误。

22.DistanceHaptics基于两个transform之间的距离触发手柄的震动反馈。

23.Player（Prefab）功能

-这是交互系统的单个部分，它结合了全部基本部分
-这个预制件管理玩家和手部，使他们均可以轻松访问。
-包括全部SteamVR和2Dfallback的设置
-交互系统的大多数的组件都依赖于Player预制件，而且一些组件假设player和hand都用这种方式设置。
-每一个场景只有一个。

24.BlankCOntroller（Prefab）当手柄没有接触任何东西时使用，控制器的渲染模型经过SteamVR加载，其全部部件都是铰接式（articulated）的。