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()较为方便。

  • 属性 

    由同一基类派生出来的各种手势识别器共用一个通用配置和一些函数。

    比如,我们能够看到TapRecognizerSwipeRecognizer组件的配置放置在同一个对象里。

     

    设置: 

    你能够看到。两个组件共用了一部分配置: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;
    }

教程:滑动手势识别器

  • 属性 

    Min Distance: 必须滑动的最小距离。 

    Max Distance:同意滑动的最大距离。 

    Min Velocity:滑动时候最小速度。

    Max Deviation:同意的最大角度偏差。(度)

  • 事件

      void OnSwipe( SwipeGesture gesture )
    {
    // 完整的滑动数据
    Vector2 move = gesture.Move;
    // 滑动的速度
    float velocity = gesture.Velocity;
    // 大概的滑动方向
    FingerGestures.SwipeDirection direction = gesture.Direction;
    }

教程:长按手势识别器

  • 属性 

    Press Duration:最少长按时间。 

    Move Tolerance:长按过程中同意的最大移动偏差。

  • 事件

      void OnLongPress( LongPressGesture gesture )
    {
    // 长按持续时间
    float elapsed = gesture.ElapsedTime;
    }

教程:缩放手势识别器

  • 属性 

    Minimum DOT :同意的小向量点积。 

    Minimum Distance:两个手指第一次触屏时候同意的最短路径。

  • 事件

      void OnPinch( PinchGesture gesture )
    {
    // 识别器当前状态(Started/Updated/Ended)
    ContinuousGesturePhase phase = gesture.Phase;
    // 当前两个手指的距离
    float gap = gesture.Gap;
    // 当前与上一帧的变动值
    float delta = gesture.Delta;
    }

教程:旋转手势识别器

  • 属性 

    Minimum DOT :同意的小向量点积。

    Minimum Rotation:必须的最小自旋角度。

  • 事件

      void OnTwist( TwistGesture gesture )
    {
    // 识别器当前状态 (Started/Updated/Ended)
    ContinuousGesturePhase phase = gesture.Phase;
    // 近期一次角度变化(度)
    float delta = gesture.DeltaRotation;
    // 总的角度变化(度)
    float total = gesture.TotalRotation;
    }
  • 桌面仿真 

    在桌面环境。你能够通过left-CTRL键加上鼠标转轮去调节角度。也能够在Mouse Input Provider配置别的按键。

教程:自己定义手势识别器

自从FingerGestures 3.0之后。能够通过PointCloudRecognizer识别自己定义手势。利用基于$P recognizer 是手势匹配算法实现。

如今仅仅支持单手指操作的识别。将来会支持多点自己定义手势。 

 

点云识别器会对照用户输入和已经设置好的手势模板。然后会返回近期接近的匹配结果,会返回匹配得分和差距值。 

点云识别器是规模和方向固定不变的,这就意味着它能够识别画得比較大或者小的,也或者是反方向的(李若:从左到右变成从右到左)。

  • 点云识别器模板 

    一个模板包含要识别的手势的数据。是通过一个编辑器编辑的。 

     

    创建一个模板须要下面步骤: 

    1:在你的项目编码,右击-> create ->PonitCloud Gesture Template 

     

    一个新的模板就好加入到项目里面。能够自己重命名。 

    2:选择模板然后在 Inspecrot 面板内点击 Edit。 

     

    3:然后開始绘图案。 

  • 使用点云识别器 

    第一步: 

    1:保证场景对象已经设置好了finger gesture的属性。

    2:创建一个新的Gestures对象。 

    3:加入一个PointCloudRecognizer组件。 

     

    下面属性须要特别注意。

    Max Match Distance:控制识别的精确的程度。

    数值越低,越精确。 

    Sampling Distance: 连贯动作取样时候,两点间隔的最小距离。越小越精确,可是取样会很多其它。

    Gesture Templates List:我们指定的模板列表。

    第二步: 

    加入刚刚创建的模板拖放到手势模板列表中。

    第三步: 

    1、创建一个c#文件,此处命名为PointCloudTutorial.cs。 

    2、在PointCloudRecognizer 以下创建一个手势对象。

    3、编辑c#文件:

      public class PointCloudTutorial : MonoBehaviour
    {
    void OnCustomGesture( PointCloudGesture gesture )
    {
    Debug.Log( "Recognized custom gesture: " + gesture.RecognizedTemplate.name +
    ", match score: " + gesture.MatchScore +
    ", match distance: " + gesture.MatchDistance );
    }
    }

    手势事件保护以下几个重要属性: 

    gesture.RecognizedTemplate: 被觉得是最佳匹配的手势模板。 

    gesture.MatchScore:一个百分比的值,表示匹配的程度。

    gesture.MatchDistance:一个測量绝对值,表示匹配程度。 

    你还能够使用其它手势的属性。

    比如位置和选择对象等属性。

  • 用代码创建模板 

    你能够使用api字自己的编辑器扩展中在执行时候创建手势模板。

      void Awake()
    {
    PointCloudGestureTemplate triangle = ScriptableObject.CreateInstance<PointCloudGestureTemplate>();
    triangle.name = "Triangle Gesture Template";
    triangle.BeginPoints();
    triangle.AddPoint( 0, 1, 1 );
    triangle.AddPoint( 0, 2, 2 );
    triangle.AddPoint( 0, 3, 1 );
    triangle.AddPoint( 0, 1, 1 );
    triangle.EndPoints();
    PointCloudGestureTemplate square = ScriptableObject.CreateInstance<PointCloudGestureTemplate>();
    square.name = "Square Gesture Template";
    square.BeginPoints();
    square.AddPoint( 0, 2, 1 );
    square.AddPoint( 0, 2, 3 );
    square.AddPoint( 0, 4, 3 );
    square.AddPoint( 0, 4, 1 );
    square.AddPoint( 0, 2, 1 );
    square.EndPoints();
    PointCloudRegognizer recognizer = gameObject.AddComponent<PointCloudRegognizer>();
    recognizer.AddTemplate( triangle );
    recognizer.AddTemplate( square );
    }

    第一个參数AddPoint是一个笔画的顺序。该api临时仅仅支持单线笔画的手势。 

    EndPoints()调用时候。手势模板会被格式化,全部的点都会又一次绘制成0到1范围的数。

教程:识别手指事件

FingerGestures 能够识别向上,向下,悬停,移动,长按等单点输入手势。各种FingerEventDetector组件用于识别相应的手指事件,与 GestureRecognizers类似,都是通过广播信息去触发。

  • FingerEventDetector 

    全部的手指事件识别器都派生与一个基础抽象类。通常。每一个FingerEventDetector实例监控着全部手指事件信号。

    也能够配置Finger Index Filter属性。让其仅仅跟踪特定的手指事件。 

    和手势识别器一样。手指事件识别器传递一个事件数据对象,改该对象派生于FingerEvent类。包括下面属性:

属性 类型 描写叙述
Name string 消息的名字
Detector FingerEventDetector 该次事件中的手指事件识别器
Finger FingerGestures.Finger 该次事件中的手指类
Position Vector2 事件所发生的位置
Selection GameObject 被选中游戏对象 (依赖`ScreenRaycaster `组件)
Hit/td> RaycastHit 光线投射碰撞,由`ScreenRaycaster`提供,在正常显示上很实用
  • FingerUpDetector

      void OnFingerUp( FingerUpEvent e )
    {
    //手指已经持续的时间
    float elapsedTime = e.TimeHeldDown;
    }
  • FingerHoverDetector

      void OnFingerHover( FingerHoverEvent e )
    {
    // 检查状态,是进入还是离开.
    if( e.Phase == FingerHoverPhase.Enter )
    {
    Debug.Log( e.Finger + " entered object: " + e.Selection );
    }
    else if( e.Phase == FingerHoverPhase.Exit )
    {
    Debug.Log( e.Finger + " exited object: " + e.Selection );
    }
    }
  • FingerMotionDetector 

    该识别器可以识别两种事件。

    1、OnFingerMove :当手指位置距离上一帧位置有发生变化。 

    2、OnFingerStationary :当手指与上一帧位置一样。

      void OnFingerMove( FingerMotionEvent e )
    {
    float elapsed = e.ElapsedTime;
    if( e.Phase == FingerMotionPhase.Started )
    Debug.Log( e.Finger + " started moving at " + e.Position);
    else if( e.Phase == FingerMotionPhase.Updated )
    Debug.Log( e.Finger + " moving at " + e.Position );
    else if( e.Phase == FingerMotionPhase.Ended )
    Debug.Log( e.Finger + " stopped moving at " + e.Position );
    }
    void OnFingerStationary( FingerMotionEvent e )
    {
    float elapsed = e.ElapsedTime;
    if( e.Phase == FingerMotionPhase.Started )
    Debug.Log( e.Finger + " started stationary state at " + e.Position );
    else if( e.Phase == FingerMotionPhase.Updated )
    Debug.Log( e.Finger + " is still stationary at " + e.Position );
    else if( e.Phase == FingerMotionPhase.Ended )
    Debug.Log( e.Finger + " stopped being stationary at " + e.Position );
    }

建议:使用.net代理事件

当使用unity的SendMessage()函数广播事件消息很方便。可是效率低并且不够.NET代理事件灵活。

Gesture Events 

每一个手势识别器都暴露一个公共的OnGesture.NET事件,能够匹配手势事件和手指事件。使用方法跟用SendMessage()一样。

    [RequireComponent( typeof( TapGesture ) )]
public class TapTutorial : MonoBehaviour
{
void Start()
{
// 在对象里面寻找轻击事件识别器
TapRecognizer tap = GetComponent<TapRecognizer>();
// 订阅它的.NET事件
tap.OnGesture += MyTapEventHandler;
}
void MyTapEventHandler( TapGesture gesture )
{
Debug.Log( "Tap detected at " + gesture.Position );
}
}

有时候你须要停止监听事件。你能够用下面办法:

    tap.OnGesture -= MyTapEventHandler;

注意停止监听事件时候相关对象的生命周期,有可能会导致内存泄露,这是.NET代理事件的陷阱。

第二种方法是,FingerGestures单例暴露一个全局的OnGestureEvent钩子。能够监听到不论什么手势事件。

        void Start()
{
FingerGestures.OnGestureEvent += FingerGestures_OnGestureEvent;
}
void FingerGestures_OnGestureEvent( Gesture gesture )
{
Debug.Log( gesture.Recognizer.name + " fired its gesture event" );
if( gesture is TapGesture )
Debug.Log( "Tapped: " + ((TapGesture)gesture).Taps );
}
  • Finger Event 

    跟上面类似使用方法。

          FingerUpDetector.OnFingerUp( FingerUpEvent e )
    FingerDownDetector.OnFingerDown( FingerDownEvent e )
    FingerHoverDetector.OnFingerHover( FingerHoverEvent e )
    FingerMotionDetector.OnFingerMove( FingerMotionEvent e )
    FingerMotionDetector.OnFingerStationary( FingerMotionEvent e )
    FingerGestures.OnFingerEvent( FingerEvent e )

--EOF

文件夹



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()较为方便。

  • 属性 

    由同一基类派生出来的各种手势识别器共用一个通用配置和一些函数。

    比如,我们能够看到TapRecognizerSwipeRecognizer组件的配置放置在同一个对象里。

     

    设置: 

    你能够看到,两个组件共用了一部分配置: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;
    }

教程:滑动手势识别器

  • 属性 

    Min Distance: 必须滑动的最小距离。 

    Max Distance:同意滑动的最大距离。 

    Min Velocity:滑动时候最小速度。

    Max Deviation:同意的最大角度偏差。(度)

  • 事件

      void OnSwipe( SwipeGesture gesture )
    {
    // 完整的滑动数据
    Vector2 move = gesture.Move;
    // 滑动的速度
    float velocity = gesture.Velocity;
    // 大概的滑动方向
    FingerGestures.SwipeDirection direction = gesture.Direction;
    }

教程:长按手势识别器

  • 属性 

    Press Duration:最少长按时间。

    Move Tolerance:长按过程中同意的最大移动偏差。

  • 事件

      void OnLongPress( LongPressGesture gesture )
    {
    // 长按持续时间
    float elapsed = gesture.ElapsedTime;
    }

教程:缩放手势识别器

  • 属性 

    Minimum DOT :同意的小向量点积。 

    Minimum Distance:两个手指第一次触屏时候同意的最短路径。

  • 事件

      void OnPinch( PinchGesture gesture )
    {
    // 识别器当前状态(Started/Updated/Ended)
    ContinuousGesturePhase phase = gesture.Phase;
    // 当前两个手指的距离
    float gap = gesture.Gap;
    // 当前与上一帧的变动值
    float delta = gesture.Delta;
    }

教程:旋转手势识别器

  • 属性 

    Minimum DOT :同意的小向量点积。 

    Minimum Rotation:必须的最小自旋角度。

  • 事件

      void OnTwist( TwistGesture gesture )
    {
    // 识别器当前状态 (Started/Updated/Ended)
    ContinuousGesturePhase phase = gesture.Phase;
    // 近期一次角度变化(度)
    float delta = gesture.DeltaRotation;
    // 总的角度变化(度)
    float total = gesture.TotalRotation;
    }
  • 桌面仿真 

    在桌面环境。你能够通过left-CTRL键加上鼠标转轮去调节角度。也能够在Mouse Input Provider配置别的按键。

教程:自己定义手势识别器

自从FingerGestures 3.0之后,能够通过PointCloudRecognizer识别自己定义手势。利用基于$P recognizer 是手势匹配算法实现。

如今仅仅支持单手指操作的识别,将来会支持多点自己定义手势。

 

点云识别器会对照用户输入和已经设置好的手势模板,然后会返回近期接近的匹配结果,会返回匹配得分和差距值。 

点云识别器是规模和方向固定不变的,这就意味着它能够识别画得比較大或者小的,也或者是反方向的(李若:从左到右变成从右到左)。

  • 点云识别器模板 

    一个模板包含要识别的手势的数据。是通过一个编辑器编辑的。 

     

    创建一个模板须要下面步骤: 

    1:在你的项目编码。右击-> create ->PonitCloud Gesture Template 

     

    一个新的模板就好加入到项目里面,能够自己重命名。

    2:选择模板然后在 Inspecrot 面板内点击 Edit。 

     

    3:然后開始绘图案。 

  • 使用点云识别器 

    第一步: 

    1:保证场景对象已经设置好了finger gesture的属性。

    2:创建一个新的Gestures对象。 

    3:加入一个PointCloudRecognizer组件。 

     

    下面属性须要特别注意。

    Max Match Distance:控制识别的精确的程度。数值越低。越精确。 

    Sampling Distance: 连贯动作取样时候,两点间隔的最小距离。

    越小越精确,可是取样会很多其它。 

    Gesture Templates List:我们指定的模板列表。

    第二步: 

    加入刚刚创建的模板拖放到手势模板列表中。 

    第三步: 

    1、创建一个c#文件。此处命名为PointCloudTutorial.cs。 

    2、在PointCloudRecognizer 以下创建一个手势对象。 

    3、编辑c#文件:

      public class PointCloudTutorial : MonoBehaviour
    {
    void OnCustomGesture( PointCloudGesture gesture )
    {
    Debug.Log( "Recognized custom gesture: " + gesture.RecognizedTemplate.name +
    ", match score: " + gesture.MatchScore +
    ", match distance: " + gesture.MatchDistance );
    }
    }

    手势事件保护以下几个重要属性: 

    gesture.RecognizedTemplate: 被觉得是最佳匹配的手势模板。 

    gesture.MatchScore:一个百分比的值,表示匹配的程度。 

    gesture.MatchDistance:一个測量绝对值,表示匹配程度。 

    你还能够使用其它手势的属性。 比如位置和选择对象等属性。

  • 用代码创建模板 

    你能够使用api字自己的编辑器扩展中在执行时候创建手势模板。

      void Awake()
    {
    PointCloudGestureTemplate triangle = ScriptableObject.CreateInstance<PointCloudGestureTemplate>();
    triangle.name = "Triangle Gesture Template";
    triangle.BeginPoints();
    triangle.AddPoint( 0, 1, 1 );
    triangle.AddPoint( 0, 2, 2 );
    triangle.AddPoint( 0, 3, 1 );
    triangle.AddPoint( 0, 1, 1 );
    triangle.EndPoints();
    PointCloudGestureTemplate square = ScriptableObject.CreateInstance<PointCloudGestureTemplate>();
    square.name = "Square Gesture Template";
    square.BeginPoints();
    square.AddPoint( 0, 2, 1 );
    square.AddPoint( 0, 2, 3 );
    square.AddPoint( 0, 4, 3 );
    square.AddPoint( 0, 4, 1 );
    square.AddPoint( 0, 2, 1 );
    square.EndPoints();
    PointCloudRegognizer recognizer = gameObject.AddComponent<PointCloudRegognizer>();
    recognizer.AddTemplate( triangle );
    recognizer.AddTemplate( square );
    }

    第一个參数AddPoint是一个笔画的顺序,该api临时仅仅支持单线笔画的手势。 

    EndPoints()调用时候,手势模板会被格式化,全部的点都会又一次绘制成0到1范围的数。

教程:识别手指事件

FingerGestures 能够识别向上,向下,悬停。移动,长按等单点输入手势。各种FingerEventDetector组件用于识别相应的手指事件。与 GestureRecognizers类似,都是通过广播信息去触发。

  • FingerEventDetector 

    全部的手指事件识别器都派生与一个基础抽象类。

    通常。每一个FingerEventDetector实例监控着全部手指事件信号。

    也能够配置Finger Index Filter属性,让其仅仅跟踪特定的手指事件。

    和手势识别器一样,手指事件识别器传递一个事件数据对象,改该对象派生于FingerEvent类,包括下面属性:

属性 类型 描写叙述
Name string 消息的名字
Detector FingerEventDetector 该次事件中的手指事件识别器
Finger FingerGestures.Finger 该次事件中的手指类
Position Vector2 事件所发生的位置
Selection GameObject 被选中游戏对象 (依赖`ScreenRaycaster `组件)
Hit/td> RaycastHit 光线投射碰撞。由`ScreenRaycaster`提供,在正常显示上很实用
  • FingerUpDetector

      void OnFingerUp( FingerUpEvent e )
    {
    //手指已经持续的时间
    float elapsedTime = e.TimeHeldDown;
    }
  • FingerHoverDetector

      void OnFingerHover( FingerHoverEvent e )
    {
    // 检查状态,是进入还是离开.
    if( e.Phase == FingerHoverPhase.Enter )
    {
    Debug.Log( e.Finger + " entered object: " + e.Selection );
    }
    else if( e.Phase == FingerHoverPhase.Exit )
    {
    Debug.Log( e.Finger + " exited object: " + e.Selection );
    }
    }
  • FingerMotionDetector 

    该识别器可以识别两种事件。 

    1、OnFingerMove :当手指位置距离上一帧位置有发生变化。 

    2、OnFingerStationary :当手指与上一帧位置一样。

      void OnFingerMove( FingerMotionEvent e )
    {
    float elapsed = e.ElapsedTime;
    if( e.Phase == FingerMotionPhase.Started )
    Debug.Log( e.Finger + " started moving at " + e.Position);
    else if( e.Phase == FingerMotionPhase.Updated )
    Debug.Log( e.Finger + " moving at " + e.Position );
    else if( e.Phase == FingerMotionPhase.Ended )
    Debug.Log( e.Finger + " stopped moving at " + e.Position );
    }
    void OnFingerStationary( FingerMotionEvent e )
    {
    float elapsed = e.ElapsedTime;
    if( e.Phase == FingerMotionPhase.Started )
    Debug.Log( e.Finger + " started stationary state at " + e.Position );
    else if( e.Phase == FingerMotionPhase.Updated )
    Debug.Log( e.Finger + " is still stationary at " + e.Position );
    else if( e.Phase == FingerMotionPhase.Ended )
    Debug.Log( e.Finger + " stopped being stationary at " + e.Position );
    }

建议:使用.net代理事件

当使用unity的SendMessage()函数广播事件消息很方便,可是效率低并且不够.NET代理事件灵活。 

Gesture Events 

每一个手势识别器都暴露一个公共的OnGesture.NET事件,能够匹配手势事件和手指事件。

使用方法跟用SendMessage()一样。

    [RequireComponent( typeof( TapGesture ) )]
public class TapTutorial : MonoBehaviour
{
void Start()
{
// 在对象里面寻找轻击事件识别器
TapRecognizer tap = GetComponent<TapRecognizer>();
// 订阅它的.NET事件
tap.OnGesture += MyTapEventHandler;
}
void MyTapEventHandler( TapGesture gesture )
{
Debug.Log( "Tap detected at " + gesture.Position );
}
}

有时候你须要停止监听事件。你能够用下面办法:

    tap.OnGesture -= MyTapEventHandler;

注意停止监听事件时候相关对象的生命周期,有可能会导致内存泄露。这是.NET代理事件的陷阱。

第二种方法是。FingerGestures单例暴露一个全局的OnGestureEvent钩子,能够监听到不论什么手势事件。

        void Start()
{
FingerGestures.OnGestureEvent += FingerGestures_OnGestureEvent;
}
void FingerGestures_OnGestureEvent( Gesture gesture )
{
Debug.Log( gesture.Recognizer.name + " fired its gesture event" );
if( gesture is TapGesture )
Debug.Log( "Tapped: " + ((TapGesture)gesture).Taps );
}
  • Finger Event 

    跟上面类似使用方法。

          FingerUpDetector.OnFingerUp( FingerUpEvent e )
    FingerDownDetector.OnFingerDown( FingerDownEvent e )
    FingerHoverDetector.OnFingerHover( FingerHoverEvent e )
    FingerMotionDetector.OnFingerMove( FingerMotionEvent e )
    FingerMotionDetector.OnFingerStationary( FingerMotionEvent e )
    FingerGestures.OnFingerEvent( FingerEvent e )

--EOF

unity3D的FingerGestures小工具的更多相关文章

  1. 2000条你应知的WPF小姿势 基础篇<45-50 Visual Tree&Logic Tree 附带两个小工具>

    在正文开始之前需要介绍一个人:Sean Sexton. 来自明尼苏达双城的软件工程师.最为出色的是他维护了两个博客:2,000Things You Should Know About C# 和 2,0 ...

  2. 【原】得心应手小工具开发——IE代理快速切换工具

    一.引入 因为公司里上外网要经常换IE代理地址,每次切换地址都要进到Internet Options里去设置一番,经常切换的话很是麻烦,由于用了点时间作个小工具来方便自己. 二.实现思路 其实思路很简 ...

  3. ContentProvider域名替换小工具

    开发项目域名想怎么换就怎么换,就是这么任性! 这是一个很有意思的小工具! 这是一个方便开发人员和测试人员的小工具!! 吐槽: 一直在做Android开发,一直总有一个问题存在:做自己公司的apk开发时 ...

  4. c 小工具的使用

    1. 这是一个gps 数据过滤的小工具,目的是过滤到gps数据中不符合要求的数据,然后转为json 数据 需要两个小工具 bermuda.c   ------>  过滤一定范围的数据 geo2j ...

  5. 偷懒小工具 - SSO单点登录通用类(可跨域)

    写在前面的话 上次发布过一篇同样标题的文章.但是因为跨域方面做得不太理想.我进行了修改,并重新分享给大家. 如果这篇文章对您有所帮助,请您点击一下推荐.以便有动力分享出更多的"偷懒小工具&q ...

  6. [原创] Delphi小工具(Windows资源管理器右键菜单扩展)

    两个小工具 1. 项目临时文件清理 2. Android Ndk 编译 c/c++ jni 源码工具. 下载后,点击Reg.bat就可以完成注册安装.不需要时点击 UnReg.Bat 就可以删除菜单. ...

  7. 介绍两个Ubuntu上的桌面小工具

    经常使用Windows10,Sticky Notes和壁纸自动切换功能挺好用的.我经常会使用Sticky Notes来记录一些信息,内容是实时保存的,而且启动的时候会自动显示在桌面上.其实Ubuntu ...

  8. WPF根据Oracle数据库的表,生成CS文件小工具

    开发小工具的原因: 1.我们公司的开发是客户端用C#,服务端用Java,前后台在通讯交互的时候,会用到Oracle数据库的字段,因为服务器端有公司总经理开发的一个根据Oracle数据库的表生成的cla ...

  9. WPF开发查询加班小工具

    先说一下,我们公司是六点下班,超过7点开始算加班,但是加班的时间是从六点开始计算,以0.5个小时为计数,就是你到了六点半,不算加班半小时,但是加班到七点半,就是加班了一个半小时. 一.打卡记录 首先, ...

随机推荐

  1. res/drawable目录

    在Android Eclipse项目中res/目录下包含有drawable-ldpi/,drawable-mdpi/,drawable-hdpi/,drawable-xhdpi/目录,这几个目录的后缀 ...

  2. Fibinary Numbers

    http://acm.hust.edu.cn/vjudge/contest/view.action?cid=30506#problem/V 题意:从右向左,每一个位数,分别表示一个fibonacci数 ...

  3. 基于visual Studio2013解决C语言竞赛题之1090测量重量

        题目 解决代码及点评 /************************************************************************/ /* ...

  4. 【UML九种图系列】之如何利用三层来绘制类图、时序图?

    UML并发视图:实体之间行为的交互,是动态.分为:时序图.协作图.状态图.活动图 一.时序图简述: 时序图(Sequence Diagram):描述对象之间的交互行为,按照时间顺序排列. 元素: 角色 ...

  5. 你以为在用SharePoint但事实上不是

    博客地址 http://blog.csdn.net/foxdave 原文链接:http://www.techrepublic.com/blog/tech-decision-maker/you-thin ...

  6. 炮塔郝梦主solo

    尊重开发人员的工作,转载时请注明出处:http://blog.csdn.net/haomengzhu/article/details/31885287 或许你会由于它爱上dota: 或许你会由于它爱上 ...

  7. mysql基础:列类型--整型

    mysql列类型--字符串  http://blog.csdn.net/jk110333/article/details/9342301 mysql列类型--时间和日期    http://blog. ...

  8. tc3162目录

    lsbin      dev      lib      proc     tmp      usrboaroot  etc      linuxrc  sbin     userfs   var# ...

  9. Floodlight 处理交换机增加/移除过程

         Floodlight 使用的是Netty架构,在Controller.java 入口函数中显示创建ServerBootstrap,设置套接字选项,ChannelPipeline,此时监听套接 ...

  10. Android studio ElasticDownloadView

    找到个开源项目,地址:https://github.com/Tibolte/ElasticDownload 下载进度效果: watermark/2/text/aHR0cDovL2Jsb2cuY3Nkb ...