タップ操作

Android SDK を使用すると、Glass のタッチパッドから元データにアクセスできます。

ただし、GDK には、タップ、スワイプ、スクロールなど、Glass の一般的なジェスチャーを自動的に検出するジェスチャー検出器が用意されています。

さらに、シンプルなジェスチャーはデフォルトで D-pad イベントに変換され、ジェスチャー検出器を使用せずに処理を簡単に行うことができます。

D-pad のキーイベントとしてジェスチャーを検出する

デフォルトでは、Glass システムはシンプルなジェスチャーを D-pad のキーイベントに変換します。これにより、アクティビティまたはビューで onKeyDown() イベントと onKeyUp() イベントをリッスンし、次のジェスチャーを D-pad 鍵として処理できます。

次のスニペットは、ユーザーがタッチパッドをタップしたときを検出します。

public class MyActivity extends Activity {
    ...
    @Override
    public boolean onKeyDown(int keycode, KeyEvent event) {
        if (keycode == KeyEvent.KEYCODE_DPAD_CENTER) {
            // user tapped touchpad, do something
            return true;
        }
        ...
        return super.onKeyDown(keycode, event);
    }
}

個々のビューでタップを検出するには、ビューに OnClickListener を実装します。ユーザーがフォーカスされているタッチパッド(D-pad の中央ボタンクリックとして変換)をタップすると、OnClickListener によってビューがイベントを処理できるようになります。

public final class MyActivity extends Activity implements OnClickListener {

    View cardView;

    @Override
    protected void onCreate(Bundle bundle) {
        super.onCreate(bundle);
        cardView = new Card(this).setText("Tap to carry out an action").getView();
        // To receive touch events from the touchpad, the view should be focusable.
        cardView.setOnClickListener(this);
        cardView.setFocusable(true);
        cardView.setFocusableInTouchMode(true);
        setContentView(cardView);
    }

    @Override
    protected void onResume() {
        // To receive touch events from the touchpad, the view should have focus.
        cardView.requestFocus();
        super.onResume();
    }

    @Override
    public void onClick(View v) {
        // perform desired action
    }
}

ジェスチャー検出器によるジェスチャーの検出

ジェスチャー検出器を使用すると、単純なジェスチャーだけでなく、複数の指やスクロールを使用するような複雑なジェスチャーも検出できます。複雑な操作には、対応する D-pad キーがありません。

GestureDetector は、ジェスチャーの通知を受けるために実装できるリスナー インターフェースを提供します。

アクティビティ レベルの操作の検出

UI のどの部分にフォーカスがあってもかまわない場合は、アクティビティ レベルでジェスチャーを検出できます。たとえば、ユーザーがタッチパッドをタップしたときにメニューを表示したい場合は、フォーカスされているビューに関係なく、アクティビティ内で MotionEvent を処理します。

次の例では、以下を実行します。

  1. 認識されたジェスチャーを処理するリスナーを実装する GestureDetector を作成します。
  2. アクティビティの onGenericMotionEvent() メソッドをオーバーライドして、モーション イベントをジェスチャー検出機能の onMotionEvent() メソッドに渡します。

モーション イベントが発生すると、システムがジェスチャー検出機能に渡されます。認識されると、ジェスチャー検出器は、適切なリスナーにイベントを処理するよう通知します。

public class MainActivity extends Activity {
    private GestureDetector mGestureDetector;
    // ...
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        // ...
        mGestureDetector = createGestureDetector(this);
    }

    private GestureDetector createGestureDetector(Context context) {
    GestureDetector gestureDetector = new GestureDetector(context);
        //Create a base listener for generic gestures
        gestureDetector.setBaseListener( new GestureDetector.BaseListener() {
            @Override
            public boolean onGesture(Gesture gesture) {
                if (gesture == Gesture.TAP) {
                    // do something on tap
                    return true;
                } else if (gesture == Gesture.TWO_TAP) {
                    // do something on two finger tap
                    return true;
                } else if (gesture == Gesture.SWIPE_RIGHT) {
                    // do something on right (forward) swipe
                    return true;
                } else if (gesture == Gesture.SWIPE_LEFT) {
                    // do something on left (backwards) swipe
                    return true;
                }
                return false;
            }
        });
        gestureDetector.setFingerListener(new GestureDetector.FingerListener() {
            @Override
            public void onFingerCountChanged(int previousCount, int currentCount) {
              // do something on finger count changes
            }
        });
        gestureDetector.setScrollListener(new GestureDetector.ScrollListener() {
            @Override
            public boolean onScroll(float displacement, float delta, float velocity) {
                // do something on scrolling
            }
        });
        return gestureDetector;
    }

    /*
     * Send generic motion events to the gesture detector
     */
    @Override
    public boolean onGenericMotionEvent(MotionEvent event) {
        if (mGestureDetector != null) {
            return mGestureDetector.onMotionEvent(event);
        }
        return false;
    }
}

ビューレベルの操作の検出

ビューレベルでのジェスチャーの検出は、フォーカスされているビューに応じてさまざまなことを行う場合に適しています。

次の例では、以下を実行します。

  1. dispatchGenericFocusedEvent() メソッドをオーバーライドするカスタムビューを作成します。モーション イベントが発生すると、このメソッドはモーション イベントをジェスチャー検出機能に渡します。
  2. ビューがフォーカス可能であることをイベントを検出するために、ビューがフォーカス可能であることを宣言します。
  3. 認識されたジェスチャーを処理するリスナーを実装する GestureDetector を作成します。

ジェスチャー検出器は、ビューがフォーカスされているときに動きを認識すると、適切なリスナーを呼び出します。

/**
 * TextView that handles touchpad input (currently only TAP).
 */
public class TouchpadHandlingTextView extends TextView
        implements OnAttachStateChangeListener{

    private final GestureDetector mTouchDetector;

    public TouchpadHandlingTextView(Context context, AttributeSet attrs) {
        super(context, attrs);
        mTouchDetector = createGestureDetector(context);
        // must set the view to be focusable
        setFocusable(true);
        setFocusableInTouchMode(true);
    }

    public TouchpadHandlingTextView(Context context) {
        this(context, null);
    }

    @Override
    public void onViewAttachedToWindow(View v) {
        requestFocus();
    }

    @Override
    public void onViewDetachedFromWindow(View v) {
    }

    /**
     * Pass a MotionEvent into the gesture detector
     */
    @Override
    public boolean dispatchGenericFocusedEvent(MotionEvent event) {
        if (isFocused()) {
            return mTouchDetector.onMotionEvent(event);
        }
        return super.dispatchGenericFocusedEvent(event);
    }

    /**
     * Create gesture detector that triggers onClickListener. Implement
     * onClickListener in your Activity and override
     * onClick() to handle the "tap" gesture.
     */
    private GestureDetector createGestureDetector(Context context) {
        GestureDetector gd = new GestureDetector(context);
        gd.setBaseListener(new GestureDetector.BaseListener() {

            @Override
            public boolean onGesture(Gesture gesture) {
                if (gesture == Gesture.TAP) {
                    return performClick();
                }
                return false;
            }
        });
        return gd;
    }
}