Unity VR Samples示例项目分析

核心脚本和对象

在VR场景中，我们需要激活我们正在看着的物体，高亮或者交互。在VRSamples中主要包括三个脚本：VREyeRaycaster, VRInput, 以及VRInteractiveItem。

VREyeRaycaster

VREyeRaycaster.png

该脚本需要和Main Camera关联。在每次调用Update()时，该脚本都会使用Physics.Raycast来投射一条射线，以确认该射线是否命中任何collider（碰撞体）。使用该脚本还可以排除特定的Layer。在某些场景中，我们可能为了性能考虑，把所有的可交互对象移到一个单独的层。

如果某个碰撞体被射线命中，那么该脚本将尝试在GameObject上找到一个VRInteractiveItem组件。来看下该类的主要代码：

// 从相机位置向前发射一条射线
Ray ray = new Ray(m_Camera.position, m_Camera.forward);
RaycastHit hit;
//做射线投射，看是否有物体相交
if (Physics.Raycast(ray, out hit, m_RayLength, ~m_ExclusionLayers))
{
VRInteractiveItem interactible = hit.collider.GetComponent<VRInteractiveItem>(); //获取相交物体上的VRInteractiveItem组件
m_CurrentInteractible = interactible;
//如果相交物体跟上次的物体不同，那么判断悬停
if (interactible && interactible != m_LastInteractible)
interactible.Over();
// 停用上次相交物体，该函数内置空
if (interactible != m_LastInteractible)
DeactiveLastInteractible();
m_LastInteractible = interactible;
//有物体相交的话，瞄准星的位置要更新。在该函数中，会根据距离做缩放；使用相交物体的法线方向做旋转。
if (m_Reticle)
m_Reticle.SetPosition(hit);
//调用事件处理函数
if (OnRaycasthit != null)
OnRaycasthit(hit);
}
else
{
//没有相交物体，置空上次使用的可交互物体
DeactiveLastInteractible();
m_CurrentInteractible = null;
//把瞄准星放到默认位置
if (m_Reticle)
m_Reticle.SetPosition();
}

该类在OnEnable函数中和OnDisable函数中会把VRInteractiveItem上的处理事件函数与VRInput中的事件绑定起来（订阅事件）。

VRInput

image2.png

VRInput是个简单的类，可以判断用户在GearVR上（或是使用DK2时在PC上）所进行的一些简单操作，比如滑动、触碰、或双触。

VRInteractiveItem

我们可以把该组件添加到任何希望在VR场景中进行交互的GameObject上，在该物体上需要绑定一个碰撞体。

交互可视化元素SelectionRadial和SelectionSlider

我们同时利用了radial选择条（SelectionRadial），以及选择滑动条(SelectionSlider)，这样用户就可以按住Fire1来确认某个交互：

image3.png image4.png

当按住输入键时，选择条会进行填充，并在填充完整后分发OnSelectionComplete或OnBarFilled事件。关于此部分的代码，可以在SelectionRadial.cs和SelectionSlider.cs中找到，并进行了详细的注释。

在VR的世界里，从用户交互的角度看，用户需要时刻知道自己在做什么，而且可以掌控一切。通过这种“held input”的确认输入方式，可以确保用户不会出现误操作。

VR Sample项目中的各个场景分析

先来分析一下各个场景中对象和脚本的作用

MainMenu场景

MainMenu场景可以认为是整个VR项目的入口，用户首先在这里选择目标场景，然后进入。因此非常重要。该场景中的主要交互如下：

Reticle只有瞄准星的效果：

image5.png

当用户“凝视”菜单选项时，空白的Selection Radial可见。

image6.png

Selection Radial 填充（当用户“凝视”菜单选项，且按下fire1输入键）

image7.png

在整个示例项目中，都是这样的风格，也就是使用bar和radial以固定的速度进行填充。在此建议大家在开发自己的VR项目时注意到这一点，因为交互设计中的连贯性对用户很重要，特别是对于VR这种新媒介。

Selector/MenuSelectorChild对象是控制界面下边的瘦长进度条，根据用户目前凝视的对象（不同的菜单项），会把进度条移动到这些对象的下面，在鼠标移进移出的时候有一个popout的效果，根据几个public字段可以设置相应的动画参数。该脚本还收集了所有的菜单项，用他们的transform来作为目标位置的参考。

image8.png

VRCameraFade是用来控制场景之间切换效果的脚本。包含场景淡入淡出的效果。Fade效果有两种，一种是FadeIn，从全黑色逐渐变为无色透明；一种是FadeOut，从无色透明逐渐变为全黑色。该组件public的字段中，FadeColor默认是全黑色，即FadeIn中的起始颜色和FadeOut中的终止颜色，该颜色会作用于FadeImage的颜色。另外一个颜色是代码中写死的，即无色透明。FadeDuration是指fade效果的持续时间。FadeInOnSceneLoad指的是当场景加载的时候，启用Fade效果，在Unity的OnLevelWasLoaded回调中会使用到。FadeInOnStart和上面的作用类似，但是它控制的是Fade效果在Start回调中使用。

image10.png

Menu/Items对象及其子对象

MenuButton处理一个VRInteractiveItem和交互界面（瞄准星）的事件。主要是三个事件处理函数：HandleOver（reticle进入）、HandleOut（reticle移出）、HandleSelectionComplete（选择完成）。当redial的选择结束的时候，会调用HandleSelectionComplete函数，该函数启动一个Coroutine，让当前场景淡出，然后加载指定的场景（Scene To Load指定）。

image11.png

MenuItemPopout控制用户凝视menu item时popout的效果。

image12.png

MenuAnimator当用户凝视物体的时候，播放动画（实际上是一系列的纹理图片）。

image13.png

SelectionSlider当用户凝视一个物体、并按住Fire键的时候，用来控制进度条的行为。这里的Renderer引用的就是上面提到的瘦长进度条，Selection Radial引用的是上面提到的瞄准星周围一圈进度条。并且通过VRInput对象的回调来处理输入的Down和Up事件，Down的时候开始改变Slider的value，up的时候清零。通过InteractiveItem对象的回调来处理可交互对象的slider充满和瞄准星悬停事件，这里是播放声音。

image14.png

• 多场景通用的对象

WarningTextCanvas是当用户在场景中错误的输入之后，在场景中显示警告信息的界面，采用了world space的canvas界面。该脚本可以设置警告字符串，引用了VRInput对象，用来处理单击双击等事件。引用了Reticle对象，用它的transform信息来放置警告信息。引用Camera是为了让警告信息知道朝向哪里。

image15.png

MainCamera这是最重要的一个对象，包含了上述的很多代码组件：

VREyeRaycaster, VRInput, SelectionRadial和VRInteractiveItem上面都已经介绍过了。

VRCameraUI脚本确保相机UI能正确的渲染。代码中把canvas的sortingOrder放到了最大值，然后强制刷新canvas。

Reticle是瞄准星类。它是屏幕中心的一个小红点（颜色可设定），用来瞄准当前场景中的物体。如果从相机发射出来的ray没有和物体（具有VRInteractiveItem组件）相交的时候，它在默认的位置上；如果有相交物体的话，它的位置在物体的表面。位置的设定是调用其中SetPosition函数进行实现的。Default Distance可以设置默认距离。Use Normal是设定是否根据相交物体的法线来设置Reticle的旋转，效果见下面的图。

image16.png

下图展示了准星如何匹配墙壁的法线：

image17.png

下图展示了准星如何匹配地板的法线：

image18.png

ReturnToMainMenu用来允许用户返回主菜单。Menu Scene Name用来设置场景名称。引用VRInput对象是为了处理用户Cancel的输入。引用VRCameraFade是需要做场景弹出效果。

image19.png

VRTrackingReset是用于使场景重新居中的脚本。里面只有一个回调函数OnApplicationPause，调用了InputTracking.Recenter()。

image20.png

Intro场景

该场景中包含了通用prefab对象：MainCamera和WarningTextCanvas。场景中包含了三个主要的介绍界面：How to Use、How to Use Confirm、Return。还有一个VRDeviceManager对象。所有的调度控制在System/IntroManager对象下面的IntroManager脚本中。

先从一个简单的说起：

VRDeviceManager脚本使用了单例模式，主要用于配置不同的VR平台。代码中使用预定的宏例如UNITY_ANDROID，进行条件编译。

GUI对象下面是场景中的界面元素，结构如下图所示。以InstructionsGUI为例进行说明。

image21.png

UIFader脚本是用来对一组元素进行淡入淡出效果的，并且包含了很多不同的方法。这里把InstructionsGUI的两个直接子对象都加到淡入淡出组里面去。还支持设置淡入淡出速度。

image22.png

PlatformDependentText脚本用来支持不同平台的文字组件。

IntroInstructions只是简单的显示文字对象。InstructionsSelectionSlider是按钮状的滑动条对象，包含了好几个已经熟悉的脚本VRInteractiveItem、SelectionSlider。UITint是第一次见到，它是给图片染色（tint）的脚本，添加了VRInteractiveItem对象的OnOver、OnOut两个事件的处理函数。当瞄准星与该物体相交的时候，该脚本根据Tint变量设置的颜色，改变图片的颜色，相当于高亮的效果。这里并非完全的颜色替换，而是一种线性加成，计算颜色的代码如下：

m_ImagesToTint[i].color += m_Tint * m_TintPercent;

image23.png

GUIArrows脚本用来控制场景中出现的箭头出现、消失、淡入淡出的效果，VR场景中可以使用这种方式提示用户应该看往正确的方向。Fade Duration指定了淡入淡出的时间；show angle指的是当用户偏离目标方向多少角度的时候，箭头出现；Desired Direction可以设定一个transform来规定目标方向，如果是空的话使用的world space下的forward；引用相机对象是为了获取当前的朝向；Arrow Renderers是要渲染的对象。

image24.png

IntroManager脚本引导用户一步一步通过介绍场景。代码的核心是Coroutine机制。

image25.png

Flyer场景

Flyer场景是个计时“无尽飞行”的第三人称游戏，在其中玩家可以通过四处看来引导飞船的方向，并使用Fire1输入键进行射击，通过击中陨石或是引导飞船穿越空中的门来得分，跟Pilotwings或Starfox这两款游戏有点类似。

在交互方面，Flyer使用了更简单的方式，也就是让FlyerLaserController订阅VRInput的OnDown事件，从而发射激光。

Vehicles是场景中的飞机对象，还包括了飞机的附属对象，比如飞机尾部的喷气、冒烟的粒子系统，飞机的子弹发射口，以及用来显示生命值、时间、得分的界面元素。

image26.png

FlyerPlayership对象上主要包含了飞机开火、飞行、爆炸的音效，还有飞机行为的控制脚本、UI的控制脚本。

FlyerLaserController主要控制飞机发射Laser的行为。Laser采用了对象池技术，从池中取对象。引用VRInput是为了处理鼠标单击事件；引用GameController是为了知道当前游戏的状态，游戏没开始的话，不能发射laser。LaserObjectPool是用来存放Laser对象的对象池。LaserSpawnPosLeft和LaserSpawnPosRight是Laser发出的位置和旋转，LaserAudio是Laser发出时的音效。

image27.png

FlyerMovementController脚本用于控制飞机的移动（飞机是一直往前飞的，可以使用头盔控制上下左右活动）。DistanceFromCamera用于控制相机和飞机的距离；Speed控制飞机飞行的速度；Damping是飞机运动时的阻尼系数；Flyer是飞机的Transform；TagetMarker是飞机前面两个圆圈标记的transform；还引用了Camera和CameraContainer的transform，以及CurrentScore的文本界面。

image28.png

FlyerAlignmentChecker脚本控制的是当飞机接近一个场景中圆环Ring的时候，使得圆环和飞机对齐，并改变圆环的颜色。

image29.png

FlyerHealthController脚本用于控制飞机的生命状况，包括生命值，爆炸的prefab，生命条还有音效等。飞机在爆炸的时候要隐藏，毕竟飞机和爆炸的碎片完全是两个毫不相关的物体。

image30.png

System对象下面包含很多游戏控制的对象和脚本，还有对象池，是这个场景核心的内容。

image31.png

FlyerGameController是游戏控制脚本，把整个游戏流程和其他脚本整合在了一起。

image32.png

EnvironmentController脚本控制了游戏场景中小行星（石头）和圆环Ring的生成。

image33.png

UIController脚本对外提供了淡入淡出的效果。

image34.png

此外还有场景中动态生成的物体，Laser有FlyerLaser脚本控制，石头（小行星）由Asteroid脚本控制、Gate由Ring脚本控制。

Maze场景

Maze（迷宫）游戏中提供了一个桌面式的交互示例，其中我们可以指引游戏角色到出口，并避免触发炮塔（Turret）。在选择角色的目的地时，会出现一个目的地标记，同时还会显示一个角色的路径。玩家可以通过在触摸板上使用swipe，按下方向键，或是使用游戏操纵杆上的左键来旋转视图。

image35.png

该场景中最主要的还是System和Maze对象。

image36.png

Maze对象包括了整个场景的元素，墙壁、地面、炮塔、开关、标记等等。

MazeCourse 游戏对象是一个parent对象，其中包含了MazeFloor和MazeWalls GameObjects，这两个对象依次包含了迷宫布局中的几何信息。在MazeFloor游戏对象上关联了MeshCollider和VRInteractiveItem，从而允许在VR场景中进行交互。

MazeCourse关联了一个MazeTargetSetting脚本，该脚本提供了OnTargetSet事件，并确定什么时候才能触发这个事件。

image37.png

ExitArea脚本提供了游戏结束的事件OnGameComplete，确定了角色到达终点区域的行为。

Turret脚本控制炮塔的行为，Switch Button控制开关的行为。

System对象中主要是MazeGameController脚本。MazeGameController是整个场景的控制器，它负责整个游戏的流程、逻辑、不同游戏阶段游戏对象的开关。

image38.png

Shooter180和Shooter360场景

在VR Samples包含了两个射击游戏，其中一个是回廊射击游戏，玩家在180度视角的走廊中对潜在目标射击，场景如下左图。另外还有一个竞技场射击游戏，玩家被类似X战警场景的潜在目标包围，场景如下右图。

image39.png image40.png

第一人称的胳膊和手枪是摆在相机前面的模型：

image41.png

System对象下面有4个子对象，用来控制游戏流程和逻辑，包括简介、目标生成、结尾。

image42.png

ShootingGalleryController脚本中的字段分别设置了游戏类型、理想目标数量、生成目标的概率、游戏时长、生成间隔、结尾延迟等等。

image43.png

ObjectPool脚本是对象池技术，避免频繁创建和删除对象。

UIController封装了游戏中UI的切换和显示动作。

ShooterWeapon是场景中的胳膊、武器和倒计时、数字界面的根节点。它是可以跟随着相机转动的。

image44.png

ShootingGalleryGun脚本控制了枪的行为包括移动和射击。

image45.png

DefaultLineLength指的是，如果没有目标被击中的话，线渲染器的长度；

Damping阻尼，设定的是这个物体跟随相机的阻尼；

GunFlareVisibleSeconds设置的是枪开火之后的flare持续几秒；

GunContainerSmoothing胳膊和枪的模型跟随瞄准星多快；

GunAudio设计的声音；

ShootingGalleryController引用这个对象是为了在游戏没有开始的时候，不让枪射击；

EyeRaycaster检测枪正在瞄准的东西；

VRInput告诉枪什么时候射击；

CameraTransform为了获取朝前的方向；

GunContainer要引用的胳膊和枪模型；

GunEnd枪的结束位置，用来作为线渲染的起点;

GunFlare用来画射击轨迹；

Reticle瞄准星的位置；

FlareParticles是个粒子系统，枪开火的时候播放；

FlareMeshes枪开火的时候随机激活其中之一；

UIMovement在VR场景中很有用，它使得UI元素始终保持在相机的前面一定距离，并跟随相机旋转。可以设置ui元素是否朝向相机、是否跟随相机旋转以及跟随的速度等等。

image46.png

ShootingGalleryScore用来显示玩家分数。

场景中会生成许多目标对象供玩家射击，每个都是一个ShooterTarget对象，该对象主要是包括Mesh Collider，VRInteractiveItem，还有ShootingTarget脚本。ShootingTarget脚本中可以设置target对象消失的时长，被击中后消失的时长，粉碎的对象，还有几种声效。

image47.png

总结

VR场景中基本的界面和交互元素在这些示例场景中均有涉及，能满足绝大部分的需求，我们可以从中学习借鉴很多东西。作为官方给出的示例项目，该工程代码组织和实现有很多值得学习的地方：

大量使用事件机制，设计松耦合；

大量使用Coroutine，实现场景进度逻辑控制，特殊渐变效果；

对于场景中需要反复创建和销毁的对象，采用了对象池技术，避免了频繁的内存分配与释放。