手勢辨識 UIGestureRecognizer 物件

  

手勢辨識，是 iOS Device 不可或缺的互動條件之一，辨識的方法除了使用 UITouch 來做觸碰點的擷取外，你也可以例用 UIGestureRecognizer 物件來幫助你做簡單的手勢辨識，UIGestureRecognizer 已經替使用者定義的一些現成的手勢，像是滑動、掐、點擊、旋轉、拖曳或是按住不放等，下面就示範了如何透過 UIGestureRecognizer 物件，使用程式碼和 Storyboard 介面設計的方式來做手勢的辨識。

UIGestureRecognizer 提供的辨識種類

UIGestureRecognizer 目前提供 6 種不同的手勢辨識，你可以在元件庫中找到由 UIGestureRecognizer 所衍生出來的這些元件。

//點擊動作手勢辨識
UITapGestureRecognizer;

//掐擠動作的手勢辨識
UIPinchGestureRecognizer;

//旋轉動作的手勢辨識
UIRotationGestureRecognizer;

//滑動動作的手勢辨識
UISwipeGestureRecognizer;

//拖曳動作的手勢辨識
UIPanGestureRecognizer;

//久按動作的手勢辨識
UILongPressGestureRecognizer;

由 UIGestureRecognizer 所衍生出的 6 種不同的手勢辨識元件

使用 Storyboard 或是 xib 檔做設定
使用介面設計的方式來實作 UIGestureRecognizer 的手勢辨識，有下幾個步驟：

• 將欲使用的手勢辨識元件拖曳至想要互動的 UIView 上。

在拖曳完成之後，回到你的手勢辨識元件上，檢視 Connections Inspector 中的 Referencing Outlet Collections ，確認有與想要互動的 UIView 做好連結。

將手勢辨識元件與欲互動的 UIView 做好連結

• 設定手勢辨識元件的行為

手勢辨識元件決定了與 UIView 的互動方式，但是在相同的互動方式下，還有著更多的細項可以做設定，在此，我們暫且稱這些設定為「行為」，例如 UISwipeGestureRecognizer 互動元件有著曹向不同方向滑動的行為，或是使用不同數量的手指做滑動的行為，而這些行為都可以從該元件的 Attributes Inspector 中做詳細的設定。

在 UISwipeGestureRecognizer 元件中設定以 3 之手指做向下滑動的行為

• 設定成功辨識手勢之後所要觸發的方法函式

在手勢辨識成功之後，還必須設定一個方法函式來響應這個事件，設定的方式非常簡單，就如同設定按鈕事件般，將事件與對應的方法函式做拖曳的連結即可即可（對 ViewController 做連結，並非First Responder）。

設定成功辨識手勢時所響應的方法函式

- (IBAction)swipeDownByThreeFingers:(id)sender {
    [gestureLabel setText:@"三隻手指向下滑動"];
}

• 補充說明

當完成上述步驟後，在你的 Storyboard 或是 xib 的物件檢視器中，應該會看到類似下面的布局。

UISwipeGestureRecognizer 物件的 Connections Inspector

欲互動區域 UIView 物件的 Connections Inspector

在欲互區域 UIView 物件的 Connections Inspector 裡，可以看到在 Outlet Collections 部分有一個白色的警示驚嘆號，其原因是當我們在拖曳 UIGestureRecognizer 至互動區域做連結設定時，並未在該 UIView 的 Class 中宣告一個 gestureRecognizers 物件來做連結，導致在 Connections Inspector 會出現找不到名稱為 gestureRecognizers 物件的警告，不過這並不會影響執行的結果。

使用程式碼做設定
//宣告一個點擊手勢辨識的物件
UITapGestureRecognizer *tapGestureRecognizer = [[UITapGestureRecognizer alloc]initWithTarget:self action:@selector(tapThreeTimesByOneFinger)];

//設定行為
[tapGestureRecognizer setNumberOfTouchesRequired:1];
[tapGestureRecognizer setNumberOfTapsRequired:3];

//加入欲互動區的 UIView 中
[recognizerView addGestureRecognizer:tapGestureRecognizer];

在上述程式碼中，我們建立了一個點擊手勢辨識的物件，並且設定在成功辨識時必須觸發相同類別中的 tapThreeTimesByOneFinger 方法函式；在行為方面，設定為單一手指連續點擊三下，最後，將此手勢辨識的物件 tapGestureRecognizer 加入到欲互動的 UIView 中。

ps:如果是針對滑動的手勢辨識，你可以參考簡單判斷 Swipe 手勢劃過方向的方法一文，在同一個方法函式中，使用 UISwipeGestureRecognizerDirection 來判斷不同方向的滑動手勢。

判斷 UIGestureRecognizer 的狀態

這是一個比較進階的用法，當你想要自訂一些比較特殊且複雜的手勢時，可以參考使用 UIGestureRecognizer 的 state 來幫助判斷，在 UIGestureRecognizer.h 中，可以發現 UIGestureRecognizer 包含以下幾種狀態。

typedef NS_ENUM(NSInteger, UIGestureRecognizerState) {
    UIGestureRecognizerStatePossible, // the recognizer has not yet recognized its gesture, but may be evaluating touch events. this is the default state

    UIGestureRecognizerStateBegan, // the recognizer has received touches recognized as the gesture. the action method will be called at the next turn of the run loop
    UIGestureRecognizerStateChanged, // the recognizer has received touches recognized as a change to the gesture. the action method will be called at the next turn of the run loop
    UIGestureRecognizerStateEnded, // the recognizer has received touches recognized as the end of the gesture. the action method will be called at the next turn of the run loop and the recognizer will be reset to UIGestureRecognizerStatePossible
    UIGestureRecognizerStateCancelled, // the recognizer has received touches resulting in the cancellation of the gesture. the action method will be called at the next turn of the run loop. the recognizer will be reset to UIGestureRecognizerStatePossible

    UIGestureRecognizerStateFailed, // the recognizer has received a touch sequence that can not be recognized as the gesture. the action method will not be called and the recognizer will be reset to UIGestureRecognizerStatePossible

    UIGestureRecognizerStateRecognized = UIGestureRecognizerStateEnded // the recognizer has received touches recognized as the gesture. the action method will be called at the next turn of the run loop and the recognizer will be reset to UIGestureRecognizerStatePossible
};

UIGestureRecognizer 的狀態並不會是單一存在的，而是有一種既定的順序，因此在設計自訂的手勢時，必須要能很清楚的分辨每個階段，如下圖。

一些可能的 UIGestureRecognizer 狀態改變（圖片來源自 iOS Developer Library）

大多數的手勢辨識都是由 UIGestureRecognizerStatePossible 做開始，在 UIGestureRecognizerStateRecognized 或是 UIGestureRecognizerStateFailed 做結束，表示辨識成功與失敗，你可以在 iOS DeveloperLibrary上的 Gesture Recognizers, Creating Custom Gesture Recognizers 章節內，找到更多的應用。