• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 /*
2  * Copyright (C) 2008-2009 Google Inc.
3  *
4  * Licensed under the Apache License, Version 2.0 (the "License"); you may not
5  * use this file except in compliance with the License. You may obtain a copy of
6  * the License at
7  *
8  * http://www.apache.org/licenses/LICENSE-2.0
9  *
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
12  * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
13  * License for the specific language governing permissions and limitations under
14  * the License.
15  */
16 
17 package android.inputmethodservice;
18 
19 import android.content.Context;
20 import android.content.res.TypedArray;
21 import android.graphics.Bitmap;
22 import android.graphics.Canvas;
23 import android.graphics.Paint;
24 import android.graphics.PorterDuff;
25 import android.graphics.Rect;
26 import android.graphics.Typeface;
27 import android.graphics.Paint.Align;
28 import android.graphics.Region.Op;
29 import android.graphics.drawable.Drawable;
30 import android.inputmethodservice.Keyboard.Key;
31 import android.media.AudioManager;
32 import android.os.Handler;
33 import android.os.Message;
34 import android.os.UserHandle;
35 import android.provider.Settings;
36 import android.util.AttributeSet;
37 import android.util.TypedValue;
38 import android.view.GestureDetector;
39 import android.view.Gravity;
40 import android.view.LayoutInflater;
41 import android.view.MotionEvent;
42 import android.view.View;
43 import android.view.ViewConfiguration;
44 import android.view.ViewGroup.LayoutParams;
45 import android.view.accessibility.AccessibilityEvent;
46 import android.view.accessibility.AccessibilityManager;
47 import android.widget.PopupWindow;
48 import android.widget.TextView;
49 
50 import com.android.internal.R;
51 
52 import java.util.Arrays;
53 import java.util.HashMap;
54 import java.util.List;
55 import java.util.Map;
56 
57 /**
58  * A view that renders a virtual {@link Keyboard}. It handles rendering of keys and
59  * detecting key presses and touch movements.
60  *
61  * @attr ref android.R.styleable#KeyboardView_keyBackground
62  * @attr ref android.R.styleable#KeyboardView_keyPreviewLayout
63  * @attr ref android.R.styleable#KeyboardView_keyPreviewOffset
64  * @attr ref android.R.styleable#KeyboardView_labelTextSize
65  * @attr ref android.R.styleable#KeyboardView_keyTextSize
66  * @attr ref android.R.styleable#KeyboardView_keyTextColor
67  * @attr ref android.R.styleable#KeyboardView_verticalCorrection
68  * @attr ref android.R.styleable#KeyboardView_popupLayout
69  */
70 public class KeyboardView extends View implements View.OnClickListener {
71 
72     /**
73      * Listener for virtual keyboard events.
74      */
75     public interface OnKeyboardActionListener {
76 
77         /**
78          * Called when the user presses a key. This is sent before the {@link #onKey} is called.
79          * For keys that repeat, this is only called once.
80          * @param primaryCode the unicode of the key being pressed. If the touch is not on a valid
81          * key, the value will be zero.
82          */
onPress(int primaryCode)83         void onPress(int primaryCode);
84 
85         /**
86          * Called when the user releases a key. This is sent after the {@link #onKey} is called.
87          * For keys that repeat, this is only called once.
88          * @param primaryCode the code of the key that was released
89          */
onRelease(int primaryCode)90         void onRelease(int primaryCode);
91 
92         /**
93          * Send a key press to the listener.
94          * @param primaryCode this is the key that was pressed
95          * @param keyCodes the codes for all the possible alternative keys
96          * with the primary code being the first. If the primary key code is
97          * a single character such as an alphabet or number or symbol, the alternatives
98          * will include other characters that may be on the same key or adjacent keys.
99          * These codes are useful to correct for accidental presses of a key adjacent to
100          * the intended key.
101          */
onKey(int primaryCode, int[] keyCodes)102         void onKey(int primaryCode, int[] keyCodes);
103 
104         /**
105          * Sends a sequence of characters to the listener.
106          * @param text the sequence of characters to be displayed.
107          */
onText(CharSequence text)108         void onText(CharSequence text);
109 
110         /**
111          * Called when the user quickly moves the finger from right to left.
112          */
swipeLeft()113         void swipeLeft();
114 
115         /**
116          * Called when the user quickly moves the finger from left to right.
117          */
swipeRight()118         void swipeRight();
119 
120         /**
121          * Called when the user quickly moves the finger from up to down.
122          */
swipeDown()123         void swipeDown();
124 
125         /**
126          * Called when the user quickly moves the finger from down to up.
127          */
swipeUp()128         void swipeUp();
129     }
130 
131     private static final boolean DEBUG = false;
132     private static final int NOT_A_KEY = -1;
133     private static final int[] KEY_DELETE = { Keyboard.KEYCODE_DELETE };
134     private static final int[] LONG_PRESSABLE_STATE_SET = { R.attr.state_long_pressable };
135 
136     private Keyboard mKeyboard;
137     private int mCurrentKeyIndex = NOT_A_KEY;
138     private int mLabelTextSize;
139     private int mKeyTextSize;
140     private int mKeyTextColor;
141     private float mShadowRadius;
142     private int mShadowColor;
143     private float mBackgroundDimAmount;
144 
145     private TextView mPreviewText;
146     private PopupWindow mPreviewPopup;
147     private int mPreviewTextSizeLarge;
148     private int mPreviewOffset;
149     private int mPreviewHeight;
150     // Working variable
151     private final int[] mCoordinates = new int[2];
152 
153     private PopupWindow mPopupKeyboard;
154     private View mMiniKeyboardContainer;
155     private KeyboardView mMiniKeyboard;
156     private boolean mMiniKeyboardOnScreen;
157     private View mPopupParent;
158     private int mMiniKeyboardOffsetX;
159     private int mMiniKeyboardOffsetY;
160     private Map<Key,View> mMiniKeyboardCache;
161     private Key[] mKeys;
162 
163     /** Listener for {@link OnKeyboardActionListener}. */
164     private OnKeyboardActionListener mKeyboardActionListener;
165 
166     private static final int MSG_SHOW_PREVIEW = 1;
167     private static final int MSG_REMOVE_PREVIEW = 2;
168     private static final int MSG_REPEAT = 3;
169     private static final int MSG_LONGPRESS = 4;
170 
171     private static final int DELAY_BEFORE_PREVIEW = 0;
172     private static final int DELAY_AFTER_PREVIEW = 70;
173     private static final int DEBOUNCE_TIME = 70;
174 
175     private int mVerticalCorrection;
176     private int mProximityThreshold;
177 
178     private boolean mPreviewCentered = false;
179     private boolean mShowPreview = true;
180     private boolean mShowTouchPoints = true;
181     private int mPopupPreviewX;
182     private int mPopupPreviewY;
183 
184     private int mLastX;
185     private int mLastY;
186     private int mStartX;
187     private int mStartY;
188 
189     private boolean mProximityCorrectOn;
190 
191     private Paint mPaint;
192     private Rect mPadding;
193 
194     private long mDownTime;
195     private long mLastMoveTime;
196     private int mLastKey;
197     private int mLastCodeX;
198     private int mLastCodeY;
199     private int mCurrentKey = NOT_A_KEY;
200     private int mDownKey = NOT_A_KEY;
201     private long mLastKeyTime;
202     private long mCurrentKeyTime;
203     private int[] mKeyIndices = new int[12];
204     private GestureDetector mGestureDetector;
205     private int mPopupX;
206     private int mPopupY;
207     private int mRepeatKeyIndex = NOT_A_KEY;
208     private int mPopupLayout;
209     private boolean mAbortKey;
210     private Key mInvalidatedKey;
211     private Rect mClipRegion = new Rect(0, 0, 0, 0);
212     private boolean mPossiblePoly;
213     private SwipeTracker mSwipeTracker = new SwipeTracker();
214     private int mSwipeThreshold;
215     private boolean mDisambiguateSwipe;
216 
217     // Variables for dealing with multiple pointers
218     private int mOldPointerCount = 1;
219     private float mOldPointerX;
220     private float mOldPointerY;
221 
222     private Drawable mKeyBackground;
223 
224     private static final int REPEAT_INTERVAL = 50; // ~20 keys per second
225     private static final int REPEAT_START_DELAY = 400;
226     private static final int LONGPRESS_TIMEOUT = ViewConfiguration.getLongPressTimeout();
227 
228     private static int MAX_NEARBY_KEYS = 12;
229     private int[] mDistances = new int[MAX_NEARBY_KEYS];
230 
231     // For multi-tap
232     private int mLastSentIndex;
233     private int mTapCount;
234     private long mLastTapTime;
235     private boolean mInMultiTap;
236     private static final int MULTITAP_INTERVAL = 800; // milliseconds
237     private StringBuilder mPreviewLabel = new StringBuilder(1);
238 
239     /** Whether the keyboard bitmap needs to be redrawn before it's blitted. **/
240     private boolean mDrawPending;
241     /** The dirty region in the keyboard bitmap */
242     private Rect mDirtyRect = new Rect();
243     /** The keyboard bitmap for faster updates */
244     private Bitmap mBuffer;
245     /** Notes if the keyboard just changed, so that we could possibly reallocate the mBuffer. */
246     private boolean mKeyboardChanged;
247     /** The canvas for the above mutable keyboard bitmap */
248     private Canvas mCanvas;
249     /** The accessibility manager for accessibility support */
250     private AccessibilityManager mAccessibilityManager;
251     /** The audio manager for accessibility support */
252     private AudioManager mAudioManager;
253     /** Whether the requirement of a headset to hear passwords if accessibility is enabled is announced. */
254     private boolean mHeadsetRequiredToHearPasswordsAnnounced;
255 
256     Handler mHandler;
257 
KeyboardView(Context context, AttributeSet attrs)258     public KeyboardView(Context context, AttributeSet attrs) {
259         this(context, attrs, com.android.internal.R.attr.keyboardViewStyle);
260     }
261 
KeyboardView(Context context, AttributeSet attrs, int defStyleAttr)262     public KeyboardView(Context context, AttributeSet attrs, int defStyleAttr) {
263         this(context, attrs, defStyleAttr, 0);
264     }
265 
KeyboardView(Context context, AttributeSet attrs, int defStyleAttr, int defStyleRes)266     public KeyboardView(Context context, AttributeSet attrs, int defStyleAttr, int defStyleRes) {
267         super(context, attrs, defStyleAttr, defStyleRes);
268 
269         TypedArray a = context.obtainStyledAttributes(
270                 attrs, android.R.styleable.KeyboardView, defStyleAttr, defStyleRes);
271 
272         LayoutInflater inflate =
273                 (LayoutInflater) context
274                         .getSystemService(Context.LAYOUT_INFLATER_SERVICE);
275 
276         int previewLayout = 0;
277         int keyTextSize = 0;
278 
279         int n = a.getIndexCount();
280 
281         for (int i = 0; i < n; i++) {
282             int attr = a.getIndex(i);
283 
284             switch (attr) {
285             case com.android.internal.R.styleable.KeyboardView_keyBackground:
286                 mKeyBackground = a.getDrawable(attr);
287                 break;
288             case com.android.internal.R.styleable.KeyboardView_verticalCorrection:
289                 mVerticalCorrection = a.getDimensionPixelOffset(attr, 0);
290                 break;
291             case com.android.internal.R.styleable.KeyboardView_keyPreviewLayout:
292                 previewLayout = a.getResourceId(attr, 0);
293                 break;
294             case com.android.internal.R.styleable.KeyboardView_keyPreviewOffset:
295                 mPreviewOffset = a.getDimensionPixelOffset(attr, 0);
296                 break;
297             case com.android.internal.R.styleable.KeyboardView_keyPreviewHeight:
298                 mPreviewHeight = a.getDimensionPixelSize(attr, 80);
299                 break;
300             case com.android.internal.R.styleable.KeyboardView_keyTextSize:
301                 mKeyTextSize = a.getDimensionPixelSize(attr, 18);
302                 break;
303             case com.android.internal.R.styleable.KeyboardView_keyTextColor:
304                 mKeyTextColor = a.getColor(attr, 0xFF000000);
305                 break;
306             case com.android.internal.R.styleable.KeyboardView_labelTextSize:
307                 mLabelTextSize = a.getDimensionPixelSize(attr, 14);
308                 break;
309             case com.android.internal.R.styleable.KeyboardView_popupLayout:
310                 mPopupLayout = a.getResourceId(attr, 0);
311                 break;
312             case com.android.internal.R.styleable.KeyboardView_shadowColor:
313                 mShadowColor = a.getColor(attr, 0);
314                 break;
315             case com.android.internal.R.styleable.KeyboardView_shadowRadius:
316                 mShadowRadius = a.getFloat(attr, 0f);
317                 break;
318             }
319         }
320 
321         a = mContext.obtainStyledAttributes(
322                 com.android.internal.R.styleable.Theme);
323         mBackgroundDimAmount = a.getFloat(android.R.styleable.Theme_backgroundDimAmount, 0.5f);
324 
325         mPreviewPopup = new PopupWindow(context);
326         if (previewLayout != 0) {
327             mPreviewText = (TextView) inflate.inflate(previewLayout, null);
328             mPreviewTextSizeLarge = (int) mPreviewText.getTextSize();
329             mPreviewPopup.setContentView(mPreviewText);
330             mPreviewPopup.setBackgroundDrawable(null);
331         } else {
332             mShowPreview = false;
333         }
334 
335         mPreviewPopup.setTouchable(false);
336 
337         mPopupKeyboard = new PopupWindow(context);
338         mPopupKeyboard.setBackgroundDrawable(null);
339         //mPopupKeyboard.setClippingEnabled(false);
340 
341         mPopupParent = this;
342         //mPredicting = true;
343 
344         mPaint = new Paint();
345         mPaint.setAntiAlias(true);
346         mPaint.setTextSize(keyTextSize);
347         mPaint.setTextAlign(Align.CENTER);
348         mPaint.setAlpha(255);
349 
350         mPadding = new Rect(0, 0, 0, 0);
351         mMiniKeyboardCache = new HashMap<Key,View>();
352         mKeyBackground.getPadding(mPadding);
353 
354         mSwipeThreshold = (int) (500 * getResources().getDisplayMetrics().density);
355         mDisambiguateSwipe = getResources().getBoolean(
356                 com.android.internal.R.bool.config_swipeDisambiguation);
357 
358         mAccessibilityManager = AccessibilityManager.getInstance(context);
359         mAudioManager = (AudioManager) context.getSystemService(Context.AUDIO_SERVICE);
360 
361         resetMultiTap();
362     }
363 
364     @Override
onAttachedToWindow()365     protected void onAttachedToWindow() {
366         super.onAttachedToWindow();
367         initGestureDetector();
368         if (mHandler == null) {
369             mHandler = new Handler() {
370                 @Override
371                 public void handleMessage(Message msg) {
372                     switch (msg.what) {
373                         case MSG_SHOW_PREVIEW:
374                             showKey(msg.arg1);
375                             break;
376                         case MSG_REMOVE_PREVIEW:
377                             mPreviewText.setVisibility(INVISIBLE);
378                             break;
379                         case MSG_REPEAT:
380                             if (repeatKey()) {
381                                 Message repeat = Message.obtain(this, MSG_REPEAT);
382                                 sendMessageDelayed(repeat, REPEAT_INTERVAL);
383                             }
384                             break;
385                         case MSG_LONGPRESS:
386                             openPopupIfRequired((MotionEvent) msg.obj);
387                             break;
388                     }
389                 }
390             };
391         }
392     }
393 
initGestureDetector()394     private void initGestureDetector() {
395         if (mGestureDetector == null) {
396             mGestureDetector = new GestureDetector(getContext(), new GestureDetector.SimpleOnGestureListener() {
397                 @Override
398                 public boolean onFling(MotionEvent me1, MotionEvent me2,
399                         float velocityX, float velocityY) {
400                     if (mPossiblePoly) return false;
401                     final float absX = Math.abs(velocityX);
402                     final float absY = Math.abs(velocityY);
403                     float deltaX = me2.getX() - me1.getX();
404                     float deltaY = me2.getY() - me1.getY();
405                     int travelX = getWidth() / 2; // Half the keyboard width
406                     int travelY = getHeight() / 2; // Half the keyboard height
407                     mSwipeTracker.computeCurrentVelocity(1000);
408                     final float endingVelocityX = mSwipeTracker.getXVelocity();
409                     final float endingVelocityY = mSwipeTracker.getYVelocity();
410                     boolean sendDownKey = false;
411                     if (velocityX > mSwipeThreshold && absY < absX && deltaX > travelX) {
412                         if (mDisambiguateSwipe && endingVelocityX < velocityX / 4) {
413                             sendDownKey = true;
414                         } else {
415                             swipeRight();
416                             return true;
417                         }
418                     } else if (velocityX < -mSwipeThreshold && absY < absX && deltaX < -travelX) {
419                         if (mDisambiguateSwipe && endingVelocityX > velocityX / 4) {
420                             sendDownKey = true;
421                         } else {
422                             swipeLeft();
423                             return true;
424                         }
425                     } else if (velocityY < -mSwipeThreshold && absX < absY && deltaY < -travelY) {
426                         if (mDisambiguateSwipe && endingVelocityY > velocityY / 4) {
427                             sendDownKey = true;
428                         } else {
429                             swipeUp();
430                             return true;
431                         }
432                     } else if (velocityY > mSwipeThreshold && absX < absY / 2 && deltaY > travelY) {
433                         if (mDisambiguateSwipe && endingVelocityY < velocityY / 4) {
434                             sendDownKey = true;
435                         } else {
436                             swipeDown();
437                             return true;
438                         }
439                     }
440 
441                     if (sendDownKey) {
442                         detectAndSendKey(mDownKey, mStartX, mStartY, me1.getEventTime());
443                     }
444                     return false;
445                 }
446             });
447 
448             mGestureDetector.setIsLongpressEnabled(false);
449         }
450     }
451 
setOnKeyboardActionListener(OnKeyboardActionListener listener)452     public void setOnKeyboardActionListener(OnKeyboardActionListener listener) {
453         mKeyboardActionListener = listener;
454     }
455 
456     /**
457      * Returns the {@link OnKeyboardActionListener} object.
458      * @return the listener attached to this keyboard
459      */
getOnKeyboardActionListener()460     protected OnKeyboardActionListener getOnKeyboardActionListener() {
461         return mKeyboardActionListener;
462     }
463 
464     /**
465      * Attaches a keyboard to this view. The keyboard can be switched at any time and the
466      * view will re-layout itself to accommodate the keyboard.
467      * @see Keyboard
468      * @see #getKeyboard()
469      * @param keyboard the keyboard to display in this view
470      */
setKeyboard(Keyboard keyboard)471     public void setKeyboard(Keyboard keyboard) {
472         if (mKeyboard != null) {
473             showPreview(NOT_A_KEY);
474         }
475         // Remove any pending messages
476         removeMessages();
477         mKeyboard = keyboard;
478         List<Key> keys = mKeyboard.getKeys();
479         mKeys = keys.toArray(new Key[keys.size()]);
480         requestLayout();
481         // Hint to reallocate the buffer if the size changed
482         mKeyboardChanged = true;
483         invalidateAllKeys();
484         computeProximityThreshold(keyboard);
485         mMiniKeyboardCache.clear(); // Not really necessary to do every time, but will free up views
486         // Switching to a different keyboard should abort any pending keys so that the key up
487         // doesn't get delivered to the old or new keyboard
488         mAbortKey = true; // Until the next ACTION_DOWN
489     }
490 
491     /**
492      * Returns the current keyboard being displayed by this view.
493      * @return the currently attached keyboard
494      * @see #setKeyboard(Keyboard)
495      */
getKeyboard()496     public Keyboard getKeyboard() {
497         return mKeyboard;
498     }
499 
500     /**
501      * Sets the state of the shift key of the keyboard, if any.
502      * @param shifted whether or not to enable the state of the shift key
503      * @return true if the shift key state changed, false if there was no change
504      * @see KeyboardView#isShifted()
505      */
setShifted(boolean shifted)506     public boolean setShifted(boolean shifted) {
507         if (mKeyboard != null) {
508             if (mKeyboard.setShifted(shifted)) {
509                 // The whole keyboard probably needs to be redrawn
510                 invalidateAllKeys();
511                 return true;
512             }
513         }
514         return false;
515     }
516 
517     /**
518      * Returns the state of the shift key of the keyboard, if any.
519      * @return true if the shift is in a pressed state, false otherwise. If there is
520      * no shift key on the keyboard or there is no keyboard attached, it returns false.
521      * @see KeyboardView#setShifted(boolean)
522      */
isShifted()523     public boolean isShifted() {
524         if (mKeyboard != null) {
525             return mKeyboard.isShifted();
526         }
527         return false;
528     }
529 
530     /**
531      * Enables or disables the key feedback popup. This is a popup that shows a magnified
532      * version of the depressed key. By default the preview is enabled.
533      * @param previewEnabled whether or not to enable the key feedback popup
534      * @see #isPreviewEnabled()
535      */
setPreviewEnabled(boolean previewEnabled)536     public void setPreviewEnabled(boolean previewEnabled) {
537         mShowPreview = previewEnabled;
538     }
539 
540     /**
541      * Returns the enabled state of the key feedback popup.
542      * @return whether or not the key feedback popup is enabled
543      * @see #setPreviewEnabled(boolean)
544      */
isPreviewEnabled()545     public boolean isPreviewEnabled() {
546         return mShowPreview;
547     }
548 
setVerticalCorrection(int verticalOffset)549     public void setVerticalCorrection(int verticalOffset) {
550 
551     }
setPopupParent(View v)552     public void setPopupParent(View v) {
553         mPopupParent = v;
554     }
555 
setPopupOffset(int x, int y)556     public void setPopupOffset(int x, int y) {
557         mMiniKeyboardOffsetX = x;
558         mMiniKeyboardOffsetY = y;
559         if (mPreviewPopup.isShowing()) {
560             mPreviewPopup.dismiss();
561         }
562     }
563 
564     /**
565      * When enabled, calls to {@link OnKeyboardActionListener#onKey} will include key
566      * codes for adjacent keys.  When disabled, only the primary key code will be
567      * reported.
568      * @param enabled whether or not the proximity correction is enabled
569      */
setProximityCorrectionEnabled(boolean enabled)570     public void setProximityCorrectionEnabled(boolean enabled) {
571         mProximityCorrectOn = enabled;
572     }
573 
574     /**
575      * Returns true if proximity correction is enabled.
576      */
isProximityCorrectionEnabled()577     public boolean isProximityCorrectionEnabled() {
578         return mProximityCorrectOn;
579     }
580 
581     /**
582      * Popup keyboard close button clicked.
583      * @hide
584      */
onClick(View v)585     public void onClick(View v) {
586         dismissPopupKeyboard();
587     }
588 
adjustCase(CharSequence label)589     private CharSequence adjustCase(CharSequence label) {
590         if (mKeyboard.isShifted() && label != null && label.length() < 3
591                 && Character.isLowerCase(label.charAt(0))) {
592             label = label.toString().toUpperCase();
593         }
594         return label;
595     }
596 
597     @Override
onMeasure(int widthMeasureSpec, int heightMeasureSpec)598     public void onMeasure(int widthMeasureSpec, int heightMeasureSpec) {
599         // Round up a little
600         if (mKeyboard == null) {
601             setMeasuredDimension(mPaddingLeft + mPaddingRight, mPaddingTop + mPaddingBottom);
602         } else {
603             int width = mKeyboard.getMinWidth() + mPaddingLeft + mPaddingRight;
604             if (MeasureSpec.getSize(widthMeasureSpec) < width + 10) {
605                 width = MeasureSpec.getSize(widthMeasureSpec);
606             }
607             setMeasuredDimension(width, mKeyboard.getHeight() + mPaddingTop + mPaddingBottom);
608         }
609     }
610 
611     /**
612      * Compute the average distance between adjacent keys (horizontally and vertically)
613      * and square it to get the proximity threshold. We use a square here and in computing
614      * the touch distance from a key's center to avoid taking a square root.
615      * @param keyboard
616      */
computeProximityThreshold(Keyboard keyboard)617     private void computeProximityThreshold(Keyboard keyboard) {
618         if (keyboard == null) return;
619         final Key[] keys = mKeys;
620         if (keys == null) return;
621         int length = keys.length;
622         int dimensionSum = 0;
623         for (int i = 0; i < length; i++) {
624             Key key = keys[i];
625             dimensionSum += Math.min(key.width, key.height) + key.gap;
626         }
627         if (dimensionSum < 0 || length == 0) return;
628         mProximityThreshold = (int) (dimensionSum * 1.4f / length);
629         mProximityThreshold *= mProximityThreshold; // Square it
630     }
631 
632     @Override
onSizeChanged(int w, int h, int oldw, int oldh)633     public void onSizeChanged(int w, int h, int oldw, int oldh) {
634         super.onSizeChanged(w, h, oldw, oldh);
635         if (mKeyboard != null) {
636             mKeyboard.resize(w, h);
637         }
638         // Release the buffer, if any and it will be reallocated on the next draw
639         mBuffer = null;
640     }
641 
642     @Override
onDraw(Canvas canvas)643     public void onDraw(Canvas canvas) {
644         super.onDraw(canvas);
645         if (mDrawPending || mBuffer == null || mKeyboardChanged) {
646             onBufferDraw();
647         }
648         canvas.drawBitmap(mBuffer, 0, 0, null);
649     }
650 
onBufferDraw()651     private void onBufferDraw() {
652         if (mBuffer == null || mKeyboardChanged) {
653             if (mBuffer == null || mKeyboardChanged &&
654                     (mBuffer.getWidth() != getWidth() || mBuffer.getHeight() != getHeight())) {
655                 // Make sure our bitmap is at least 1x1
656                 final int width = Math.max(1, getWidth());
657                 final int height = Math.max(1, getHeight());
658                 mBuffer = Bitmap.createBitmap(width, height, Bitmap.Config.ARGB_8888);
659                 mCanvas = new Canvas(mBuffer);
660             }
661             invalidateAllKeys();
662             mKeyboardChanged = false;
663         }
664         final Canvas canvas = mCanvas;
665         canvas.clipRect(mDirtyRect, Op.REPLACE);
666 
667         if (mKeyboard == null) return;
668 
669         final Paint paint = mPaint;
670         final Drawable keyBackground = mKeyBackground;
671         final Rect clipRegion = mClipRegion;
672         final Rect padding = mPadding;
673         final int kbdPaddingLeft = mPaddingLeft;
674         final int kbdPaddingTop = mPaddingTop;
675         final Key[] keys = mKeys;
676         final Key invalidKey = mInvalidatedKey;
677 
678         paint.setColor(mKeyTextColor);
679         boolean drawSingleKey = false;
680         if (invalidKey != null && canvas.getClipBounds(clipRegion)) {
681           // Is clipRegion completely contained within the invalidated key?
682           if (invalidKey.x + kbdPaddingLeft - 1 <= clipRegion.left &&
683                   invalidKey.y + kbdPaddingTop - 1 <= clipRegion.top &&
684                   invalidKey.x + invalidKey.width + kbdPaddingLeft + 1 >= clipRegion.right &&
685                   invalidKey.y + invalidKey.height + kbdPaddingTop + 1 >= clipRegion.bottom) {
686               drawSingleKey = true;
687           }
688         }
689         canvas.drawColor(0x00000000, PorterDuff.Mode.CLEAR);
690         final int keyCount = keys.length;
691         for (int i = 0; i < keyCount; i++) {
692             final Key key = keys[i];
693             if (drawSingleKey && invalidKey != key) {
694                 continue;
695             }
696             int[] drawableState = key.getCurrentDrawableState();
697             keyBackground.setState(drawableState);
698 
699             // Switch the character to uppercase if shift is pressed
700             String label = key.label == null? null : adjustCase(key.label).toString();
701 
702             final Rect bounds = keyBackground.getBounds();
703             if (key.width != bounds.right ||
704                     key.height != bounds.bottom) {
705                 keyBackground.setBounds(0, 0, key.width, key.height);
706             }
707             canvas.translate(key.x + kbdPaddingLeft, key.y + kbdPaddingTop);
708             keyBackground.draw(canvas);
709 
710             if (label != null) {
711                 // For characters, use large font. For labels like "Done", use small font.
712                 if (label.length() > 1 && key.codes.length < 2) {
713                     paint.setTextSize(mLabelTextSize);
714                     paint.setTypeface(Typeface.DEFAULT_BOLD);
715                 } else {
716                     paint.setTextSize(mKeyTextSize);
717                     paint.setTypeface(Typeface.DEFAULT);
718                 }
719                 // Draw a drop shadow for the text
720                 paint.setShadowLayer(mShadowRadius, 0, 0, mShadowColor);
721                 // Draw the text
722                 canvas.drawText(label,
723                     (key.width - padding.left - padding.right) / 2
724                             + padding.left,
725                     (key.height - padding.top - padding.bottom) / 2
726                             + (paint.getTextSize() - paint.descent()) / 2 + padding.top,
727                     paint);
728                 // Turn off drop shadow
729                 paint.setShadowLayer(0, 0, 0, 0);
730             } else if (key.icon != null) {
731                 final int drawableX = (key.width - padding.left - padding.right
732                                 - key.icon.getIntrinsicWidth()) / 2 + padding.left;
733                 final int drawableY = (key.height - padding.top - padding.bottom
734                         - key.icon.getIntrinsicHeight()) / 2 + padding.top;
735                 canvas.translate(drawableX, drawableY);
736                 key.icon.setBounds(0, 0,
737                         key.icon.getIntrinsicWidth(), key.icon.getIntrinsicHeight());
738                 key.icon.draw(canvas);
739                 canvas.translate(-drawableX, -drawableY);
740             }
741             canvas.translate(-key.x - kbdPaddingLeft, -key.y - kbdPaddingTop);
742         }
743         mInvalidatedKey = null;
744         // Overlay a dark rectangle to dim the keyboard
745         if (mMiniKeyboardOnScreen) {
746             paint.setColor((int) (mBackgroundDimAmount * 0xFF) << 24);
747             canvas.drawRect(0, 0, getWidth(), getHeight(), paint);
748         }
749 
750         if (DEBUG && mShowTouchPoints) {
751             paint.setAlpha(128);
752             paint.setColor(0xFFFF0000);
753             canvas.drawCircle(mStartX, mStartY, 3, paint);
754             canvas.drawLine(mStartX, mStartY, mLastX, mLastY, paint);
755             paint.setColor(0xFF0000FF);
756             canvas.drawCircle(mLastX, mLastY, 3, paint);
757             paint.setColor(0xFF00FF00);
758             canvas.drawCircle((mStartX + mLastX) / 2, (mStartY + mLastY) / 2, 2, paint);
759         }
760 
761         mDrawPending = false;
762         mDirtyRect.setEmpty();
763     }
764 
getKeyIndices(int x, int y, int[] allKeys)765     private int getKeyIndices(int x, int y, int[] allKeys) {
766         final Key[] keys = mKeys;
767         int primaryIndex = NOT_A_KEY;
768         int closestKey = NOT_A_KEY;
769         int closestKeyDist = mProximityThreshold + 1;
770         java.util.Arrays.fill(mDistances, Integer.MAX_VALUE);
771         int [] nearestKeyIndices = mKeyboard.getNearestKeys(x, y);
772         final int keyCount = nearestKeyIndices.length;
773         for (int i = 0; i < keyCount; i++) {
774             final Key key = keys[nearestKeyIndices[i]];
775             int dist = 0;
776             boolean isInside = key.isInside(x,y);
777             if (isInside) {
778                 primaryIndex = nearestKeyIndices[i];
779             }
780 
781             if (((mProximityCorrectOn
782                     && (dist = key.squaredDistanceFrom(x, y)) < mProximityThreshold)
783                     || isInside)
784                     && key.codes[0] > 32) {
785                 // Find insertion point
786                 final int nCodes = key.codes.length;
787                 if (dist < closestKeyDist) {
788                     closestKeyDist = dist;
789                     closestKey = nearestKeyIndices[i];
790                 }
791 
792                 if (allKeys == null) continue;
793 
794                 for (int j = 0; j < mDistances.length; j++) {
795                     if (mDistances[j] > dist) {
796                         // Make space for nCodes codes
797                         System.arraycopy(mDistances, j, mDistances, j + nCodes,
798                                 mDistances.length - j - nCodes);
799                         System.arraycopy(allKeys, j, allKeys, j + nCodes,
800                                 allKeys.length - j - nCodes);
801                         for (int c = 0; c < nCodes; c++) {
802                             allKeys[j + c] = key.codes[c];
803                             mDistances[j + c] = dist;
804                         }
805                         break;
806                     }
807                 }
808             }
809         }
810         if (primaryIndex == NOT_A_KEY) {
811             primaryIndex = closestKey;
812         }
813         return primaryIndex;
814     }
815 
detectAndSendKey(int index, int x, int y, long eventTime)816     private void detectAndSendKey(int index, int x, int y, long eventTime) {
817         if (index != NOT_A_KEY && index < mKeys.length) {
818             final Key key = mKeys[index];
819             if (key.text != null) {
820                 mKeyboardActionListener.onText(key.text);
821                 mKeyboardActionListener.onRelease(NOT_A_KEY);
822             } else {
823                 int code = key.codes[0];
824                 //TextEntryState.keyPressedAt(key, x, y);
825                 int[] codes = new int[MAX_NEARBY_KEYS];
826                 Arrays.fill(codes, NOT_A_KEY);
827                 getKeyIndices(x, y, codes);
828                 // Multi-tap
829                 if (mInMultiTap) {
830                     if (mTapCount != -1) {
831                         mKeyboardActionListener.onKey(Keyboard.KEYCODE_DELETE, KEY_DELETE);
832                     } else {
833                         mTapCount = 0;
834                     }
835                     code = key.codes[mTapCount];
836                 }
837                 mKeyboardActionListener.onKey(code, codes);
838                 mKeyboardActionListener.onRelease(code);
839             }
840             mLastSentIndex = index;
841             mLastTapTime = eventTime;
842         }
843     }
844 
845     /**
846      * Handle multi-tap keys by producing the key label for the current multi-tap state.
847      */
getPreviewText(Key key)848     private CharSequence getPreviewText(Key key) {
849         if (mInMultiTap) {
850             // Multi-tap
851             mPreviewLabel.setLength(0);
852             mPreviewLabel.append((char) key.codes[mTapCount < 0 ? 0 : mTapCount]);
853             return adjustCase(mPreviewLabel);
854         } else {
855             return adjustCase(key.label);
856         }
857     }
858 
showPreview(int keyIndex)859     private void showPreview(int keyIndex) {
860         int oldKeyIndex = mCurrentKeyIndex;
861         final PopupWindow previewPopup = mPreviewPopup;
862 
863         mCurrentKeyIndex = keyIndex;
864         // Release the old key and press the new key
865         final Key[] keys = mKeys;
866         if (oldKeyIndex != mCurrentKeyIndex) {
867             if (oldKeyIndex != NOT_A_KEY && keys.length > oldKeyIndex) {
868                 Key oldKey = keys[oldKeyIndex];
869                 oldKey.onReleased(mCurrentKeyIndex == NOT_A_KEY);
870                 invalidateKey(oldKeyIndex);
871                 final int keyCode = oldKey.codes[0];
872                 sendAccessibilityEventForUnicodeCharacter(AccessibilityEvent.TYPE_VIEW_HOVER_EXIT,
873                         keyCode);
874                 // TODO: We need to implement AccessibilityNodeProvider for this view.
875                 sendAccessibilityEventForUnicodeCharacter(
876                         AccessibilityEvent.TYPE_VIEW_ACCESSIBILITY_FOCUS_CLEARED, keyCode);
877             }
878             if (mCurrentKeyIndex != NOT_A_KEY && keys.length > mCurrentKeyIndex) {
879                 Key newKey = keys[mCurrentKeyIndex];
880                 newKey.onPressed();
881                 invalidateKey(mCurrentKeyIndex);
882                 final int keyCode = newKey.codes[0];
883                 sendAccessibilityEventForUnicodeCharacter(AccessibilityEvent.TYPE_VIEW_HOVER_ENTER,
884                         keyCode);
885                 // TODO: We need to implement AccessibilityNodeProvider for this view.
886                 sendAccessibilityEventForUnicodeCharacter(
887                         AccessibilityEvent.TYPE_VIEW_ACCESSIBILITY_FOCUSED, keyCode);
888             }
889         }
890         // If key changed and preview is on ...
891         if (oldKeyIndex != mCurrentKeyIndex && mShowPreview) {
892             mHandler.removeMessages(MSG_SHOW_PREVIEW);
893             if (previewPopup.isShowing()) {
894                 if (keyIndex == NOT_A_KEY) {
895                     mHandler.sendMessageDelayed(mHandler
896                             .obtainMessage(MSG_REMOVE_PREVIEW),
897                             DELAY_AFTER_PREVIEW);
898                 }
899             }
900             if (keyIndex != NOT_A_KEY) {
901                 if (previewPopup.isShowing() && mPreviewText.getVisibility() == VISIBLE) {
902                     // Show right away, if it's already visible and finger is moving around
903                     showKey(keyIndex);
904                 } else {
905                     mHandler.sendMessageDelayed(
906                             mHandler.obtainMessage(MSG_SHOW_PREVIEW, keyIndex, 0),
907                             DELAY_BEFORE_PREVIEW);
908                 }
909             }
910         }
911     }
912 
showKey(final int keyIndex)913     private void showKey(final int keyIndex) {
914         final PopupWindow previewPopup = mPreviewPopup;
915         final Key[] keys = mKeys;
916         if (keyIndex < 0 || keyIndex >= mKeys.length) return;
917         Key key = keys[keyIndex];
918         if (key.icon != null) {
919             mPreviewText.setCompoundDrawables(null, null, null,
920                     key.iconPreview != null ? key.iconPreview : key.icon);
921             mPreviewText.setText(null);
922         } else {
923             mPreviewText.setCompoundDrawables(null, null, null, null);
924             mPreviewText.setText(getPreviewText(key));
925             if (key.label.length() > 1 && key.codes.length < 2) {
926                 mPreviewText.setTextSize(TypedValue.COMPLEX_UNIT_PX, mKeyTextSize);
927                 mPreviewText.setTypeface(Typeface.DEFAULT_BOLD);
928             } else {
929                 mPreviewText.setTextSize(TypedValue.COMPLEX_UNIT_PX, mPreviewTextSizeLarge);
930                 mPreviewText.setTypeface(Typeface.DEFAULT);
931             }
932         }
933         mPreviewText.measure(MeasureSpec.makeMeasureSpec(0, MeasureSpec.UNSPECIFIED),
934                 MeasureSpec.makeMeasureSpec(0, MeasureSpec.UNSPECIFIED));
935         int popupWidth = Math.max(mPreviewText.getMeasuredWidth(), key.width
936                 + mPreviewText.getPaddingLeft() + mPreviewText.getPaddingRight());
937         final int popupHeight = mPreviewHeight;
938         LayoutParams lp = mPreviewText.getLayoutParams();
939         if (lp != null) {
940             lp.width = popupWidth;
941             lp.height = popupHeight;
942         }
943         if (!mPreviewCentered) {
944             mPopupPreviewX = key.x - mPreviewText.getPaddingLeft() + mPaddingLeft;
945             mPopupPreviewY = key.y - popupHeight + mPreviewOffset;
946         } else {
947             // TODO: Fix this if centering is brought back
948             mPopupPreviewX = 160 - mPreviewText.getMeasuredWidth() / 2;
949             mPopupPreviewY = - mPreviewText.getMeasuredHeight();
950         }
951         mHandler.removeMessages(MSG_REMOVE_PREVIEW);
952         getLocationInWindow(mCoordinates);
953         mCoordinates[0] += mMiniKeyboardOffsetX; // Offset may be zero
954         mCoordinates[1] += mMiniKeyboardOffsetY; // Offset may be zero
955 
956         // Set the preview background state
957         mPreviewText.getBackground().setState(
958                 key.popupResId != 0 ? LONG_PRESSABLE_STATE_SET : EMPTY_STATE_SET);
959         mPopupPreviewX += mCoordinates[0];
960         mPopupPreviewY += mCoordinates[1];
961 
962         // If the popup cannot be shown above the key, put it on the side
963         getLocationOnScreen(mCoordinates);
964         if (mPopupPreviewY + mCoordinates[1] < 0) {
965             // If the key you're pressing is on the left side of the keyboard, show the popup on
966             // the right, offset by enough to see at least one key to the left/right.
967             if (key.x + key.width <= getWidth() / 2) {
968                 mPopupPreviewX += (int) (key.width * 2.5);
969             } else {
970                 mPopupPreviewX -= (int) (key.width * 2.5);
971             }
972             mPopupPreviewY += popupHeight;
973         }
974 
975         if (previewPopup.isShowing()) {
976             previewPopup.update(mPopupPreviewX, mPopupPreviewY,
977                     popupWidth, popupHeight);
978         } else {
979             previewPopup.setWidth(popupWidth);
980             previewPopup.setHeight(popupHeight);
981             previewPopup.showAtLocation(mPopupParent, Gravity.NO_GRAVITY,
982                     mPopupPreviewX, mPopupPreviewY);
983         }
984         mPreviewText.setVisibility(VISIBLE);
985     }
986 
sendAccessibilityEventForUnicodeCharacter(int eventType, int code)987     private void sendAccessibilityEventForUnicodeCharacter(int eventType, int code) {
988         if (mAccessibilityManager.isEnabled()) {
989             AccessibilityEvent event = AccessibilityEvent.obtain(eventType);
990             onInitializeAccessibilityEvent(event);
991             String text = null;
992             // This is very efficient since the properties are cached.
993             final boolean speakPassword = Settings.Secure.getIntForUser(
994                     mContext.getContentResolver(), Settings.Secure.ACCESSIBILITY_SPEAK_PASSWORD, 0,
995                     UserHandle.USER_CURRENT_OR_SELF) != 0;
996             // Add text only if password announcement is enabled or if headset is
997             // used to avoid leaking passwords.
998             if (speakPassword || mAudioManager.isBluetoothA2dpOn()
999                     || mAudioManager.isWiredHeadsetOn()) {
1000                 switch (code) {
1001                     case Keyboard.KEYCODE_ALT:
1002                         text = mContext.getString(R.string.keyboardview_keycode_alt);
1003                         break;
1004                     case Keyboard.KEYCODE_CANCEL:
1005                         text = mContext.getString(R.string.keyboardview_keycode_cancel);
1006                         break;
1007                     case Keyboard.KEYCODE_DELETE:
1008                         text = mContext.getString(R.string.keyboardview_keycode_delete);
1009                         break;
1010                     case Keyboard.KEYCODE_DONE:
1011                         text = mContext.getString(R.string.keyboardview_keycode_done);
1012                         break;
1013                     case Keyboard.KEYCODE_MODE_CHANGE:
1014                         text = mContext.getString(R.string.keyboardview_keycode_mode_change);
1015                         break;
1016                     case Keyboard.KEYCODE_SHIFT:
1017                         text = mContext.getString(R.string.keyboardview_keycode_shift);
1018                         break;
1019                     case '\n':
1020                         text = mContext.getString(R.string.keyboardview_keycode_enter);
1021                         break;
1022                     default:
1023                         text = String.valueOf((char) code);
1024                 }
1025             } else if (!mHeadsetRequiredToHearPasswordsAnnounced) {
1026                 // We want the waring for required head set to be send with both the
1027                 // hover enter and hover exit event, so set the flag after the exit.
1028                 if (eventType == AccessibilityEvent.TYPE_VIEW_HOVER_EXIT) {
1029                     mHeadsetRequiredToHearPasswordsAnnounced = true;
1030                 }
1031                 text = mContext.getString(R.string.keyboard_headset_required_to_hear_password);
1032             } else {
1033                 text = mContext.getString(R.string.keyboard_password_character_no_headset);
1034             }
1035             event.getText().add(text);
1036             mAccessibilityManager.sendAccessibilityEvent(event);
1037         }
1038     }
1039 
1040     /**
1041      * Requests a redraw of the entire keyboard. Calling {@link #invalidate} is not sufficient
1042      * because the keyboard renders the keys to an off-screen buffer and an invalidate() only
1043      * draws the cached buffer.
1044      * @see #invalidateKey(int)
1045      */
invalidateAllKeys()1046     public void invalidateAllKeys() {
1047         mDirtyRect.union(0, 0, getWidth(), getHeight());
1048         mDrawPending = true;
1049         invalidate();
1050     }
1051 
1052     /**
1053      * Invalidates a key so that it will be redrawn on the next repaint. Use this method if only
1054      * one key is changing it's content. Any changes that affect the position or size of the key
1055      * may not be honored.
1056      * @param keyIndex the index of the key in the attached {@link Keyboard}.
1057      * @see #invalidateAllKeys
1058      */
invalidateKey(int keyIndex)1059     public void invalidateKey(int keyIndex) {
1060         if (mKeys == null) return;
1061         if (keyIndex < 0 || keyIndex >= mKeys.length) {
1062             return;
1063         }
1064         final Key key = mKeys[keyIndex];
1065         mInvalidatedKey = key;
1066         mDirtyRect.union(key.x + mPaddingLeft, key.y + mPaddingTop,
1067                 key.x + key.width + mPaddingLeft, key.y + key.height + mPaddingTop);
1068         onBufferDraw();
1069         invalidate(key.x + mPaddingLeft, key.y + mPaddingTop,
1070                 key.x + key.width + mPaddingLeft, key.y + key.height + mPaddingTop);
1071     }
1072 
openPopupIfRequired(MotionEvent me)1073     private boolean openPopupIfRequired(MotionEvent me) {
1074         // Check if we have a popup layout specified first.
1075         if (mPopupLayout == 0) {
1076             return false;
1077         }
1078         if (mCurrentKey < 0 || mCurrentKey >= mKeys.length) {
1079             return false;
1080         }
1081 
1082         Key popupKey = mKeys[mCurrentKey];
1083         boolean result = onLongPress(popupKey);
1084         if (result) {
1085             mAbortKey = true;
1086             showPreview(NOT_A_KEY);
1087         }
1088         return result;
1089     }
1090 
1091     /**
1092      * Called when a key is long pressed. By default this will open any popup keyboard associated
1093      * with this key through the attributes popupLayout and popupCharacters.
1094      * @param popupKey the key that was long pressed
1095      * @return true if the long press is handled, false otherwise. Subclasses should call the
1096      * method on the base class if the subclass doesn't wish to handle the call.
1097      */
onLongPress(Key popupKey)1098     protected boolean onLongPress(Key popupKey) {
1099         int popupKeyboardId = popupKey.popupResId;
1100 
1101         if (popupKeyboardId != 0) {
1102             mMiniKeyboardContainer = mMiniKeyboardCache.get(popupKey);
1103             if (mMiniKeyboardContainer == null) {
1104                 LayoutInflater inflater = (LayoutInflater) getContext().getSystemService(
1105                         Context.LAYOUT_INFLATER_SERVICE);
1106                 mMiniKeyboardContainer = inflater.inflate(mPopupLayout, null);
1107                 mMiniKeyboard = (KeyboardView) mMiniKeyboardContainer.findViewById(
1108                         com.android.internal.R.id.keyboardView);
1109                 View closeButton = mMiniKeyboardContainer.findViewById(
1110                         com.android.internal.R.id.closeButton);
1111                 if (closeButton != null) closeButton.setOnClickListener(this);
1112                 mMiniKeyboard.setOnKeyboardActionListener(new OnKeyboardActionListener() {
1113                     public void onKey(int primaryCode, int[] keyCodes) {
1114                         mKeyboardActionListener.onKey(primaryCode, keyCodes);
1115                         dismissPopupKeyboard();
1116                     }
1117 
1118                     public void onText(CharSequence text) {
1119                         mKeyboardActionListener.onText(text);
1120                         dismissPopupKeyboard();
1121                     }
1122 
1123                     public void swipeLeft() { }
1124                     public void swipeRight() { }
1125                     public void swipeUp() { }
1126                     public void swipeDown() { }
1127                     public void onPress(int primaryCode) {
1128                         mKeyboardActionListener.onPress(primaryCode);
1129                     }
1130                     public void onRelease(int primaryCode) {
1131                         mKeyboardActionListener.onRelease(primaryCode);
1132                     }
1133                 });
1134                 //mInputView.setSuggest(mSuggest);
1135                 Keyboard keyboard;
1136                 if (popupKey.popupCharacters != null) {
1137                     keyboard = new Keyboard(getContext(), popupKeyboardId,
1138                             popupKey.popupCharacters, -1, getPaddingLeft() + getPaddingRight());
1139                 } else {
1140                     keyboard = new Keyboard(getContext(), popupKeyboardId);
1141                 }
1142                 mMiniKeyboard.setKeyboard(keyboard);
1143                 mMiniKeyboard.setPopupParent(this);
1144                 mMiniKeyboardContainer.measure(
1145                         MeasureSpec.makeMeasureSpec(getWidth(), MeasureSpec.AT_MOST),
1146                         MeasureSpec.makeMeasureSpec(getHeight(), MeasureSpec.AT_MOST));
1147 
1148                 mMiniKeyboardCache.put(popupKey, mMiniKeyboardContainer);
1149             } else {
1150                 mMiniKeyboard = (KeyboardView) mMiniKeyboardContainer.findViewById(
1151                         com.android.internal.R.id.keyboardView);
1152             }
1153             getLocationInWindow(mCoordinates);
1154             mPopupX = popupKey.x + mPaddingLeft;
1155             mPopupY = popupKey.y + mPaddingTop;
1156             mPopupX = mPopupX + popupKey.width - mMiniKeyboardContainer.getMeasuredWidth();
1157             mPopupY = mPopupY - mMiniKeyboardContainer.getMeasuredHeight();
1158             final int x = mPopupX + mMiniKeyboardContainer.getPaddingRight() + mCoordinates[0];
1159             final int y = mPopupY + mMiniKeyboardContainer.getPaddingBottom() + mCoordinates[1];
1160             mMiniKeyboard.setPopupOffset(x < 0 ? 0 : x, y);
1161             mMiniKeyboard.setShifted(isShifted());
1162             mPopupKeyboard.setContentView(mMiniKeyboardContainer);
1163             mPopupKeyboard.setWidth(mMiniKeyboardContainer.getMeasuredWidth());
1164             mPopupKeyboard.setHeight(mMiniKeyboardContainer.getMeasuredHeight());
1165             mPopupKeyboard.showAtLocation(this, Gravity.NO_GRAVITY, x, y);
1166             mMiniKeyboardOnScreen = true;
1167             //mMiniKeyboard.onTouchEvent(getTranslatedEvent(me));
1168             invalidateAllKeys();
1169             return true;
1170         }
1171         return false;
1172     }
1173 
1174     @Override
1175     public boolean onHoverEvent(MotionEvent event) {
1176         if (mAccessibilityManager.isTouchExplorationEnabled() && event.getPointerCount() == 1) {
1177             final int action = event.getAction();
1178             switch (action) {
1179                 case MotionEvent.ACTION_HOVER_ENTER: {
1180                     event.setAction(MotionEvent.ACTION_DOWN);
1181                 } break;
1182                 case MotionEvent.ACTION_HOVER_MOVE: {
1183                     event.setAction(MotionEvent.ACTION_MOVE);
1184                 } break;
1185                 case MotionEvent.ACTION_HOVER_EXIT: {
1186                     event.setAction(MotionEvent.ACTION_UP);
1187                 } break;
1188             }
1189             return onTouchEvent(event);
1190         }
1191         return true;
1192     }
1193 
1194     @Override
1195     public boolean onTouchEvent(MotionEvent me) {
1196         // Convert multi-pointer up/down events to single up/down events to
1197         // deal with the typical multi-pointer behavior of two-thumb typing
1198         final int pointerCount = me.getPointerCount();
1199         final int action = me.getAction();
1200         boolean result = false;
1201         final long now = me.getEventTime();
1202 
1203         if (pointerCount != mOldPointerCount) {
1204             if (pointerCount == 1) {
1205                 // Send a down event for the latest pointer
1206                 MotionEvent down = MotionEvent.obtain(now, now, MotionEvent.ACTION_DOWN,
1207                         me.getX(), me.getY(), me.getMetaState());
1208                 result = onModifiedTouchEvent(down, false);
1209                 down.recycle();
1210                 // If it's an up action, then deliver the up as well.
1211                 if (action == MotionEvent.ACTION_UP) {
1212                     result = onModifiedTouchEvent(me, true);
1213                 }
1214             } else {
1215                 // Send an up event for the last pointer
1216                 MotionEvent up = MotionEvent.obtain(now, now, MotionEvent.ACTION_UP,
1217                         mOldPointerX, mOldPointerY, me.getMetaState());
1218                 result = onModifiedTouchEvent(up, true);
1219                 up.recycle();
1220             }
1221         } else {
1222             if (pointerCount == 1) {
1223                 result = onModifiedTouchEvent(me, false);
1224                 mOldPointerX = me.getX();
1225                 mOldPointerY = me.getY();
1226             } else {
1227                 // Don't do anything when 2 pointers are down and moving.
1228                 result = true;
1229             }
1230         }
1231         mOldPointerCount = pointerCount;
1232 
1233         return result;
1234     }
1235 
1236     private boolean onModifiedTouchEvent(MotionEvent me, boolean possiblePoly) {
1237         int touchX = (int) me.getX() - mPaddingLeft;
1238         int touchY = (int) me.getY() - mPaddingTop;
1239         if (touchY >= -mVerticalCorrection)
1240             touchY += mVerticalCorrection;
1241         final int action = me.getAction();
1242         final long eventTime = me.getEventTime();
1243         int keyIndex = getKeyIndices(touchX, touchY, null);
1244         mPossiblePoly = possiblePoly;
1245 
1246         // Track the last few movements to look for spurious swipes.
1247         if (action == MotionEvent.ACTION_DOWN) mSwipeTracker.clear();
1248         mSwipeTracker.addMovement(me);
1249 
1250         // Ignore all motion events until a DOWN.
1251         if (mAbortKey
1252                 && action != MotionEvent.ACTION_DOWN && action != MotionEvent.ACTION_CANCEL) {
1253             return true;
1254         }
1255 
1256         if (mGestureDetector.onTouchEvent(me)) {
1257             showPreview(NOT_A_KEY);
1258             mHandler.removeMessages(MSG_REPEAT);
1259             mHandler.removeMessages(MSG_LONGPRESS);
1260             return true;
1261         }
1262 
1263         // Needs to be called after the gesture detector gets a turn, as it may have
1264         // displayed the mini keyboard
1265         if (mMiniKeyboardOnScreen && action != MotionEvent.ACTION_CANCEL) {
1266             return true;
1267         }
1268 
1269         switch (action) {
1270             case MotionEvent.ACTION_DOWN:
1271                 mAbortKey = false;
1272                 mStartX = touchX;
1273                 mStartY = touchY;
1274                 mLastCodeX = touchX;
1275                 mLastCodeY = touchY;
1276                 mLastKeyTime = 0;
1277                 mCurrentKeyTime = 0;
1278                 mLastKey = NOT_A_KEY;
1279                 mCurrentKey = keyIndex;
1280                 mDownKey = keyIndex;
1281                 mDownTime = me.getEventTime();
1282                 mLastMoveTime = mDownTime;
1283                 checkMultiTap(eventTime, keyIndex);
1284                 mKeyboardActionListener.onPress(keyIndex != NOT_A_KEY ?
1285                         mKeys[keyIndex].codes[0] : 0);
1286                 if (mCurrentKey >= 0 && mKeys[mCurrentKey].repeatable) {
1287                     mRepeatKeyIndex = mCurrentKey;
1288                     Message msg = mHandler.obtainMessage(MSG_REPEAT);
1289                     mHandler.sendMessageDelayed(msg, REPEAT_START_DELAY);
1290                     repeatKey();
1291                     // Delivering the key could have caused an abort
1292                     if (mAbortKey) {
1293                         mRepeatKeyIndex = NOT_A_KEY;
1294                         break;
1295                     }
1296                 }
1297                 if (mCurrentKey != NOT_A_KEY) {
1298                     Message msg = mHandler.obtainMessage(MSG_LONGPRESS, me);
1299                     mHandler.sendMessageDelayed(msg, LONGPRESS_TIMEOUT);
1300                 }
1301                 showPreview(keyIndex);
1302                 break;
1303 
1304             case MotionEvent.ACTION_MOVE:
1305                 boolean continueLongPress = false;
1306                 if (keyIndex != NOT_A_KEY) {
1307                     if (mCurrentKey == NOT_A_KEY) {
1308                         mCurrentKey = keyIndex;
1309                         mCurrentKeyTime = eventTime - mDownTime;
1310                     } else {
1311                         if (keyIndex == mCurrentKey) {
1312                             mCurrentKeyTime += eventTime - mLastMoveTime;
1313                             continueLongPress = true;
1314                         } else if (mRepeatKeyIndex == NOT_A_KEY) {
1315                             resetMultiTap();
1316                             mLastKey = mCurrentKey;
1317                             mLastCodeX = mLastX;
1318                             mLastCodeY = mLastY;
1319                             mLastKeyTime =
1320                                     mCurrentKeyTime + eventTime - mLastMoveTime;
1321                             mCurrentKey = keyIndex;
1322                             mCurrentKeyTime = 0;
1323                         }
1324                     }
1325                 }
1326                 if (!continueLongPress) {
1327                     // Cancel old longpress
1328                     mHandler.removeMessages(MSG_LONGPRESS);
1329                     // Start new longpress if key has changed
1330                     if (keyIndex != NOT_A_KEY) {
1331                         Message msg = mHandler.obtainMessage(MSG_LONGPRESS, me);
1332                         mHandler.sendMessageDelayed(msg, LONGPRESS_TIMEOUT);
1333                     }
1334                 }
1335                 showPreview(mCurrentKey);
1336                 mLastMoveTime = eventTime;
1337                 break;
1338 
1339             case MotionEvent.ACTION_UP:
1340                 removeMessages();
1341                 if (keyIndex == mCurrentKey) {
1342                     mCurrentKeyTime += eventTime - mLastMoveTime;
1343                 } else {
1344                     resetMultiTap();
1345                     mLastKey = mCurrentKey;
1346                     mLastKeyTime = mCurrentKeyTime + eventTime - mLastMoveTime;
1347                     mCurrentKey = keyIndex;
1348                     mCurrentKeyTime = 0;
1349                 }
1350                 if (mCurrentKeyTime < mLastKeyTime && mCurrentKeyTime < DEBOUNCE_TIME
1351                         && mLastKey != NOT_A_KEY) {
1352                     mCurrentKey = mLastKey;
1353                     touchX = mLastCodeX;
1354                     touchY = mLastCodeY;
1355                 }
1356                 showPreview(NOT_A_KEY);
1357                 Arrays.fill(mKeyIndices, NOT_A_KEY);
1358                 // If we're not on a repeating key (which sends on a DOWN event)
1359                 if (mRepeatKeyIndex == NOT_A_KEY && !mMiniKeyboardOnScreen && !mAbortKey) {
1360                     detectAndSendKey(mCurrentKey, touchX, touchY, eventTime);
1361                 }
1362                 invalidateKey(keyIndex);
1363                 mRepeatKeyIndex = NOT_A_KEY;
1364                 break;
1365             case MotionEvent.ACTION_CANCEL:
1366                 removeMessages();
1367                 dismissPopupKeyboard();
1368                 mAbortKey = true;
1369                 showPreview(NOT_A_KEY);
1370                 invalidateKey(mCurrentKey);
1371                 break;
1372         }
1373         mLastX = touchX;
1374         mLastY = touchY;
1375         return true;
1376     }
1377 
repeatKey()1378     private boolean repeatKey() {
1379         Key key = mKeys[mRepeatKeyIndex];
1380         detectAndSendKey(mCurrentKey, key.x, key.y, mLastTapTime);
1381         return true;
1382     }
1383 
swipeRight()1384     protected void swipeRight() {
1385         mKeyboardActionListener.swipeRight();
1386     }
1387 
swipeLeft()1388     protected void swipeLeft() {
1389         mKeyboardActionListener.swipeLeft();
1390     }
1391 
swipeUp()1392     protected void swipeUp() {
1393         mKeyboardActionListener.swipeUp();
1394     }
1395 
swipeDown()1396     protected void swipeDown() {
1397         mKeyboardActionListener.swipeDown();
1398     }
1399 
closing()1400     public void closing() {
1401         if (mPreviewPopup.isShowing()) {
1402             mPreviewPopup.dismiss();
1403         }
1404         removeMessages();
1405 
1406         dismissPopupKeyboard();
1407         mBuffer = null;
1408         mCanvas = null;
1409         mMiniKeyboardCache.clear();
1410     }
1411 
removeMessages()1412     private void removeMessages() {
1413         if (mHandler != null) {
1414             mHandler.removeMessages(MSG_REPEAT);
1415             mHandler.removeMessages(MSG_LONGPRESS);
1416             mHandler.removeMessages(MSG_SHOW_PREVIEW);
1417         }
1418     }
1419 
1420     @Override
onDetachedFromWindow()1421     public void onDetachedFromWindow() {
1422         super.onDetachedFromWindow();
1423         closing();
1424     }
1425 
dismissPopupKeyboard()1426     private void dismissPopupKeyboard() {
1427         if (mPopupKeyboard.isShowing()) {
1428             mPopupKeyboard.dismiss();
1429             mMiniKeyboardOnScreen = false;
1430             invalidateAllKeys();
1431         }
1432     }
1433 
handleBack()1434     public boolean handleBack() {
1435         if (mPopupKeyboard.isShowing()) {
1436             dismissPopupKeyboard();
1437             return true;
1438         }
1439         return false;
1440     }
1441 
resetMultiTap()1442     private void resetMultiTap() {
1443         mLastSentIndex = NOT_A_KEY;
1444         mTapCount = 0;
1445         mLastTapTime = -1;
1446         mInMultiTap = false;
1447     }
1448 
checkMultiTap(long eventTime, int keyIndex)1449     private void checkMultiTap(long eventTime, int keyIndex) {
1450         if (keyIndex == NOT_A_KEY) return;
1451         Key key = mKeys[keyIndex];
1452         if (key.codes.length > 1) {
1453             mInMultiTap = true;
1454             if (eventTime < mLastTapTime + MULTITAP_INTERVAL
1455                     && keyIndex == mLastSentIndex) {
1456                 mTapCount = (mTapCount + 1) % key.codes.length;
1457                 return;
1458             } else {
1459                 mTapCount = -1;
1460                 return;
1461             }
1462         }
1463         if (eventTime > mLastTapTime + MULTITAP_INTERVAL || keyIndex != mLastSentIndex) {
1464             resetMultiTap();
1465         }
1466     }
1467 
1468     private static class SwipeTracker {
1469 
1470         static final int NUM_PAST = 4;
1471         static final int LONGEST_PAST_TIME = 200;
1472 
1473         final float mPastX[] = new float[NUM_PAST];
1474         final float mPastY[] = new float[NUM_PAST];
1475         final long mPastTime[] = new long[NUM_PAST];
1476 
1477         float mYVelocity;
1478         float mXVelocity;
1479 
clear()1480         public void clear() {
1481             mPastTime[0] = 0;
1482         }
1483 
addMovement(MotionEvent ev)1484         public void addMovement(MotionEvent ev) {
1485             long time = ev.getEventTime();
1486             final int N = ev.getHistorySize();
1487             for (int i=0; i<N; i++) {
1488                 addPoint(ev.getHistoricalX(i), ev.getHistoricalY(i),
1489                         ev.getHistoricalEventTime(i));
1490             }
1491             addPoint(ev.getX(), ev.getY(), time);
1492         }
1493 
addPoint(float x, float y, long time)1494         private void addPoint(float x, float y, long time) {
1495             int drop = -1;
1496             int i;
1497             final long[] pastTime = mPastTime;
1498             for (i=0; i<NUM_PAST; i++) {
1499                 if (pastTime[i] == 0) {
1500                     break;
1501                 } else if (pastTime[i] < time-LONGEST_PAST_TIME) {
1502                     drop = i;
1503                 }
1504             }
1505             if (i == NUM_PAST && drop < 0) {
1506                 drop = 0;
1507             }
1508             if (drop == i) drop--;
1509             final float[] pastX = mPastX;
1510             final float[] pastY = mPastY;
1511             if (drop >= 0) {
1512                 final int start = drop+1;
1513                 final int count = NUM_PAST-drop-1;
1514                 System.arraycopy(pastX, start, pastX, 0, count);
1515                 System.arraycopy(pastY, start, pastY, 0, count);
1516                 System.arraycopy(pastTime, start, pastTime, 0, count);
1517                 i -= (drop+1);
1518             }
1519             pastX[i] = x;
1520             pastY[i] = y;
1521             pastTime[i] = time;
1522             i++;
1523             if (i < NUM_PAST) {
1524                 pastTime[i] = 0;
1525             }
1526         }
1527 
computeCurrentVelocity(int units)1528         public void computeCurrentVelocity(int units) {
1529             computeCurrentVelocity(units, Float.MAX_VALUE);
1530         }
1531 
computeCurrentVelocity(int units, float maxVelocity)1532         public void computeCurrentVelocity(int units, float maxVelocity) {
1533             final float[] pastX = mPastX;
1534             final float[] pastY = mPastY;
1535             final long[] pastTime = mPastTime;
1536 
1537             final float oldestX = pastX[0];
1538             final float oldestY = pastY[0];
1539             final long oldestTime = pastTime[0];
1540             float accumX = 0;
1541             float accumY = 0;
1542             int N=0;
1543             while (N < NUM_PAST) {
1544                 if (pastTime[N] == 0) {
1545                     break;
1546                 }
1547                 N++;
1548             }
1549 
1550             for (int i=1; i < N; i++) {
1551                 final int dur = (int)(pastTime[i] - oldestTime);
1552                 if (dur == 0) continue;
1553                 float dist = pastX[i] - oldestX;
1554                 float vel = (dist/dur) * units;   // pixels/frame.
1555                 if (accumX == 0) accumX = vel;
1556                 else accumX = (accumX + vel) * .5f;
1557 
1558                 dist = pastY[i] - oldestY;
1559                 vel = (dist/dur) * units;   // pixels/frame.
1560                 if (accumY == 0) accumY = vel;
1561                 else accumY = (accumY + vel) * .5f;
1562             }
1563             mXVelocity = accumX < 0.0f ? Math.max(accumX, -maxVelocity)
1564                     : Math.min(accumX, maxVelocity);
1565             mYVelocity = accumY < 0.0f ? Math.max(accumY, -maxVelocity)
1566                     : Math.min(accumY, maxVelocity);
1567         }
1568 
1569         public float getXVelocity() {
1570             return mXVelocity;
1571         }
1572 
1573         public float getYVelocity() {
1574             return mYVelocity;
1575         }
1576     }
1577 }
1578