aboutsummaryrefslogtreecommitdiff
path: root/src/com/google/android/droiddriver/util/Events.java
blob: a905851b0888d7b968f5c333a3e5eb7c60584c48 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
/*
 * Copyright (C) 2013 DroidDriver committers
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package com.google.android.droiddriver.util;

import android.os.SystemClock;
import android.util.Log;
import android.view.InputDevice;
import android.view.InputEvent;
import android.view.KeyEvent;
import android.view.MotionEvent;

import com.google.android.droiddriver.actions.InputInjector;
import com.google.android.droiddriver.exceptions.ActionException;

/**
 * Helper methods to create InputEvents.
 */
public class Events {
  /**
   * @return a touch down event at the specified coordinates
   */
  private static MotionEvent newTouchDownEvent(int x, int y) {
    long downTime = SystemClock.uptimeMillis();
    MotionEvent event = MotionEvent.obtain(downTime, downTime, MotionEvent.ACTION_DOWN, x, y, 1);
    event.setSource(InputDevice.SOURCE_TOUCHSCREEN);
    return event;
  }

  /**
   * @return a touch up event at the specified coordinates
   */
  private static MotionEvent newTouchUpEvent(long downTime, int x, int y) {
    long eventTime = SystemClock.uptimeMillis();
    MotionEvent event = MotionEvent.obtain(downTime, eventTime, MotionEvent.ACTION_UP, x, y, 1);
    event.setSource(InputDevice.SOURCE_TOUCHSCREEN);
    return event;
  }

  /**
   * @return a touch move event at the specified coordinates
   */
  private static MotionEvent newTouchMoveEvent(long downTime, int x, int y) {
    long eventTime = SystemClock.uptimeMillis();
    MotionEvent event = MotionEvent.obtain(downTime, eventTime, MotionEvent.ACTION_MOVE, x, y, 1);
    event.setSource(InputDevice.SOURCE_TOUCHSCREEN);
    return event;
  }

  private static KeyEvent newKeyEvent(long downTime, long eventTime, int action, int keyCode,
      int metaState) {
    KeyEvent event = new KeyEvent(downTime, eventTime, action, keyCode, 0 /* repeat */, metaState);
    event.setSource(InputDevice.SOURCE_KEYBOARD);
    return event;
  }

  /**
   * Injects {@code event}. {@code event} is recycled and should not be used
   * after.
   *
   * @throws ActionException if injection failed
   */
  private static void injectEvent(InputInjector injector, InputEvent event) {
    injectEvent(Log.DEBUG, injector, event);
  }

  private static void injectEvent(int priority, InputInjector injector, InputEvent event) {
    Logs.call(priority, injector, "injectInputEvent", event);
    try {
      if (!injector.injectInputEvent(event)) {
        throw new ActionException("Failed to inject " + event);
      }
    } finally {
      if (event instanceof MotionEvent) {
        ((MotionEvent) event).recycle();
      }
    }
  }

  public static long touchDown(InputInjector injector, int x, int y) {
    MotionEvent downEvent = newTouchDownEvent(x, y);
    long downTime = downEvent.getDownTime();
    injectEvent(injector, downEvent);
    return downTime;
  }

  public static void touchUp(InputInjector injector, long downTime, int x, int y) {
    injectEvent(injector, newTouchUpEvent(downTime, x, y));
  }

  public static void touchMove(InputInjector injector, long downTime, int x, int y) {
    injectEvent(Log.VERBOSE, injector, newTouchMoveEvent(downTime, x, y));
  }

  public static long keyDown(InputInjector injector, int keyCode, int metaState) {
    long downTime = SystemClock.uptimeMillis();
    KeyEvent downEvent = newKeyEvent(downTime, downTime, KeyEvent.ACTION_DOWN, keyCode, metaState);
    injectEvent(injector, downEvent);
    return downTime;
  }

  public static void keyUp(InputInjector injector, long downTime, int keyCode, int metaState) {
    injectEvent(injector,
        newKeyEvent(downTime, SystemClock.uptimeMillis(), KeyEvent.ACTION_UP, keyCode, metaState));
  }

  private Events() {}
}