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下的FingerGestures prefab文件拖入场景中。二是能够创建一个空物件，然后把FingerGestures组件加入进去。

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

教程：识别一个轻敲手势

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

初始化

第一步。如上章节设置;

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

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

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

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

轻敲屏幕

第一步。点击TapGestures组件上的Copy Event To Clipboardbutton，它会把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 totalMove = gesture.TotalMove;

}

教程：滑动手势识别器