ugui 转轮_(搬运工)unity3D的FingerGestures插件

目录

fingerGestures包结构

路径，相对Assets/Plugin/…

描述

FingerGestures/

插件的根目录

FingerGestures/Prefabs

可以直接拖放到场景中的预设资源(prefabs)

FingerGestures/Scripts

核心脚本和组件

FingerGestures/Scripts/Gesture Recognizers

每个手势识别 的脚本

FingerGestures/Scripts/Finger Event Detectors

每个触摸事件检测器的脚本

FingerGestures/Scripts/Components

手势识别和触摸事件所需要添加的额外组件

FingerGestures/Toolbox

FingerGestures 自带的工具箱脚本

FingerGestures/Samples.unitypackage

所有例子的子包

FingerGestures/PlayMaker Actions.unitypackage

FingerGestures对PlayMaker扩展的插件

Editor/FingerGestures

FingerGestures对编辑器的扩展

FingerGestures例子列表

Finger Event(鼠标或手指事件)

FingerEventsPart1:展示如何通过不同的检测器( FingerEventDetectors )去检测鼠标或者手指的上(down)、下(up)，按下不移动(stationary，悬停(hover) 事件。

FingerEventsPart2:展示如何识别不同鼠标或者手指动作(FingerMotionDetector)。

Gestures(手势)

BasicGestures:识别单击(react to tap)，双击(double tap)，拖动(drag)，长按(long——press)，滑动(swipe)等基础手势。

PinchAndTwist:两个或多个手指同时在触摸屏上挤压(pinch)或扭转(twist)时，触发手势的事件。(PS：通常都是用来缩放或旋转)

PointCloudGestures:示范如何识别一个点云(point cloud)手势。(PS：通常是指用用户画的图案作为识别)

Toolbox(工具箱)

Camera(放入摄像机的脚本)：

Toolbox-DragView: 展示使用TBDragView脚本，实现拖动视角。

Toolbox-Orbit: 展示使用TBOrbit脚本，实现围绕目标旋转视角。

Toolbox-Pan: 展示使用TBPan脚本，实现以自身为轴旋转视角。

Toolbox-PinchZoom: 展示使用TBPinchZoom脚本，实现变焦。

Object-Based(放入普通场景对象的脚本)：

Toolbox-Drag: 展示使用TBDrag脚本，实现简单的物体拖动

Toolbox-Hover: 展示使用TBHoverChangeMaterial和TBHoverChangeScale脚本，实现当鼠标或者手指悬停在物体上时候的响应。(PS：类似鼠标放到图标上，图标发亮的效果)

Toolbox-PinchToScale 展示使用TBPinchToScale脚本，实现缩放物体

Toolbox-TwistToRotate: 展示使用TBTwistToRotate脚本，实现旋转物体

设置场景

需要在场景中实例化一个FingerGesture组件才可使用。 FingerGesture在项目中的作用是管理用户输入和识别手势和鼠标或手指事件。

有两种添加方式，一是直接把Plugins\FingerGestures\Prefabs下的FingerGesturesprefab文件拖入场景中。二是可以创建一个空物件，然后把FingerGestures组件添加进去。

使用Make Persistent标志可以让使FingerGestures 单例在跨场景后一直有效，所以只要保证它在第一个场景设置就足够。

教程：识别一个轻敲手势

该章节会学习到如何识别一个简单的单击动作，然后到特殊物件的单击动作识别，最后到识别一个三个手指的双击动作。

初始化

第一步，如上章节设置;

第二步，创建一个GameObject 命名为Gestures;

第三步，给Gestures添加一个TapRecognizer组件，并保持默认设置，你可以在项目面板搜索到它或者直接打开Component > FingerGestures > Gestures > Tap menu item。

TapRecognizer 是其中一种手势识别器，它用于监控用户输入而且当一个有效的单击动作被识别时候工作。

第四步，创建一个新的C# script 叫做TapTutorial并添加到第二步创建的Gestures中。

轻敲屏幕

第一步，点击TapGestures组件上的Copy Event To Clipboard按钮，它会把TapGesture所需要的时间信号代码copy到黏贴板。

第二步，粘贴到TapTutorial脚本里，如下:public class TapTutorial : MonoBehaviour

{

void OnTap( TapGesture gesture )

{

/* your code here */

}

}

OnTap函数匹配定义在TapRecognizer 组件内的信息名属性，当识别器要识别一个轻敲手势，它会使用unity3d的SendMessage API先向Gestures物件内所有的脚本广播OnTap信息，只要TapTutorial绑定在该物件上，它的OnTap函数就会被调用到。

出于性能考虑，通常使用.net标准的事件模型代替unity3d的SendMessage API。

第三步，修改OnTop函数：void OnTap( TapGesture gesture )

{

Debug.Log( "Tap gesture detected at " + gesture.Position +

". It was sent by " + gesture.Recognizer.name );

}

gesture参数包含着手势事件数据，在上面的代码，我们主要输出了位置和TapRecognizer内工作的事件。你还可以在gesture参数内获得更多属性，例如通过gesture.Fingers获得鼠标或手指相关的手势列表，还有可以通过gesture.Selection获得当前是哪个场景被轻敲 。

第四步，可以测试，通过敲不同位置，可以看到debug信息输出。

教程：手势识别器

在FingerGesture里，用户的手势都由GestureRecognizers组件来处理，它是顺序处理被识别匹配的用户动作的。

找到GestureRecognizers

每种手势都有自己的脚本，存放脚本的路径在Plugins\FingerGestures\Scripts\Gesture Recognizers。

你也可以从Component > FingerGestures > Gestures menu里面找到。

基本使用

要识别一个特殊手势，你需要：

1、添加对应的GestureRecognizer组件到场景中的目标物件。

2、配置它的属性。

3、监听它的手势事件和对应响应。

作为手势事件通知的一部分，GestureRecognizer传递一个包含相关信息(位置，手指触屏点列表，选择的场景物件，相关的GestureRecognizer等)的事件参数。

一个手势识别器有以下监听事件的方式：

1、使用标准的.net 委托事件模型，每一个手势识别器都暴露一个.net事件接口。

2、使用unity的SendMessage()函数 ：手势事件将会被广播到游戏对象里所有的组件。

手势事件也可以指向当前相关的场景对象，这时候需要把手势识别器配置到 `Raycaster `组件中才能检测场景对象。

这取决于你的选择。.net的事件模型较为高效，unity的SendMessage()较为方便。

属性

由同一基类派生出来的各种手势识别器共用一个通用配置和一些函数。例如，我们可以看到TapRecognizer和SwipeRecognizer组件的配置放置在同一个对象里。

设置：

你可以看到，两个组件共用了一部分配置:fingers setup,reset mode,event notification settings,references to additional components...

同样，每个手势识别器都有自己独特的配置，例如滑动识别器要设置距离阀值、速度、和偏差。而多点触控可以设置最大持续时间等。

事件信息广播：

此处使用SendMessage()函数去通知其他系统。你可以使用Message Name属性去指定响应的函数名。

通常，Message Target会设置你加入的手势识别器组件。但你也可以设置别的对象。

组件：

你可以收到手动指定添加组件。例如：添加一个ScreenRaycaster组件让手势识别器获知场景内对象碰撞。并把消息发送到相应的监听器。它允许识别器转发消息到正在有关联的场景对象。

教程：轻击手势识别器

属性

Required Taps：连续轻击的次数。

Max Delay Between Taps:两次轻击间最大的时间间隔。(秒)

Movement Tolerance：连续轻敲时候，和第一次轻击的位置相隔的偏差大小。

Max Duration：最大可以识别的手指数。

事件void OnTap( TapGesture gesture )

{

// 轻击的数量

int taps = gesture.Taps;

}

教程：拖拽手势识别器

属性

Movement Tolerance：最小的拖动距离才触发识别器。

Apply Same Direction Constraint：只能用于多点拖拽，打开后，如果所有点不是向同一个方向拖拽，识别器将不会识别。

事件void OnDrag( DragGesture gesture )

{

// 当前识别器阶段 (Started/Updated/Ended)

ContinuousGesturePhase phase = gesture.Phase;

// 最后一帧的拖拽/移动数据

Vector2 deltaMove = gesture.DeltaMove;

//完整的拖拽数据

Vector2 totalMo