chenxin's blog
0%

Android-TV开发按键与焦点深入分析（一）--KeyEvent的分发

发表于 更新于 分类于

Android TV中的按键事件

Android电视应用开发与Android手机应用开发的区别之一就是Android手机是触屏交互而电视是遥控器按键交互。所以入坑电视开发后，那套关于MotionEvent的分发机制在电视上作用不大，转而替代的是KeyEvent。

KeyEvent与MotionEvent都是InputEvent的子类，所以它们的分发逻辑相似，KeyEvent也定义了ACTION_DOWN和ACTION_UP，一次按键事件会被拆分成单独的ACTION_DOWN+KEY_CODE和ACTION_UP+KEY_CODE分发出去；每次KeyEvent分发都有Boolean返回，代表这个KeyEvent是否被消费了，这也和MotionEvent一样。

焦点View获得KeyEvent的过程

1.焦点View的定义

讨论KeyEvent的分发就不得不提及Android电视与Android手机开发的另一个区别–焦点View，因为KeyEvent事件最终是要体现在具体的View上的，但View树下很多View到底哪个被宠幸呢？所以Android定义了只有获得焦点的View才可以处理KeyEvent，View用自己的int型的mPrivateFlags中的第2个bit定义自己是不是有焦点的状态，如果View有焦点这个bit是1，没有是0；同时ViewGroup用成员变量mFocused表示自己的子View中哪个有焦点或者包含焦点View。下面是View的代码中定义的焦点的部分：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
View中   
/* @hide */
public int mPrivateFlags;
static final int PFLAG_FOCUSED                     = 0x00000002;
//flag第2位是否不为0
public boolean hasFocus() {
        return (mPrivateFlags & PFLAG_FOCUSED) != 0;
 }
//在获得焦点时设置标志位为1
void handleFocusGainInternal(@FocusRealDirection int direction, Rect previouslyFocusedRect) {
        if ((mPrivateFlags & PFLAG_FOCUSED) == 0) {
            mPrivateFlags |= PFLAG_FOCUSED;//设置为1
        }
    ......
 }
=============================
 ViewGroup中定义的焦点子View
    // The view contained within this ViewGroup that has or contains focus.
    private View mFocused;

2.获得KeyEvent的过程

当产生了一个KeyEvent，ViewRootImpl就根据mFocused和mPrivateFlags从View树中找出这个焦点View，并把KeyEvent给它处理，调用时序图如下：（具体的代码可以直接搜索对应的方法名字）
dispatchkeyevent .jpg

DecorView是FrameLayout的子类，时序图中DecorView的mFocused是这个ViewGroup1,这个ViewGroup1的mFocused就是这个View1，View1的mPrivateFlags中的第2个bit为1。
这样一个KeyEvent就被顺利分发给了这个有焦点的View了，ViewGroup的dispatchkeyEvent方法如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
ViewGroup中
   // The view contained within this ViewGroup that has or contains focus.
   private View mFocused;

@Override
   public boolean dispatchKeyEvent(KeyEvent event) {
	......
        //自己是有焦点的View，那就自己处理了
       if ((mPrivateFlags & (PFLAG_FOCUSED | PFLAG_HAS_BOUNDS))
               == (PFLAG_FOCUSED | PFLAG_HAS_BOUNDS)) {
           if (super.dispatchKeyEvent(event)) {
               return true;
           }
           //mFocused不为空调用这个View的dispatchKeyEvent
       } else if (mFocused != null && (mFocused.mPrivateFlags & PFLAG_HAS_BOUNDS)
               == PFLAG_HAS_BOUNDS) {
           if (mFocused.dispatchKeyEvent(event)) {
               return true;
           }
       }
       return false;
   }

View的dispatchkeyEvent方法如下：

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
    public boolean dispatchKeyEvent(KeyEvent event) {
		。。。。。
        // Give any attached key listener a first crack at the event.
        //noinspection SimplifiableIfStatement
        ListenerInfo li = mListenerInfo;
        //如果设置了mOnKeyListener就调用mOnKeyListener处理KeyEvent
        if (li != null && li.mOnKeyListener != null && (mViewFlags & ENABLED_MASK) == ENABLED
                && li.mOnKeyListener.onKey(this, event.getKeyCode(), event)) {
            return true;
        }
		//没有设置mOnKeyListener，继续分发
        if (event.dispatch(this, mAttachInfo != null
                ? mAttachInfo.mKeyDispatchState : null, this)) {
            return true;
        }
		.......
        return false;
    }

keyEvent中
    public final boolean dispatch(Callback receiver, DispatcherState state,
            Object target) {
        switch (mAction) {
            case ACTION_DOWN: {
              ......
                  //调用View的onKeyDown
                boolean res = receiver.onKeyDown(mKeyCode, this);
              .......
                return res;
            }
            case ACTION_UP:
			.......
                //调用View的onKeyUp
                return receiver.onKeyUp(mKeyCode, this);
    	   ......
        }
        return false;
    }

可见一个View如果设置了OnKeyListener会先将事件交给OnKeyListener处理，如果OnKeyListener没有消费掉事件继续将事件交给自己的onKeyDown或onKeyUp处理，View的onKeyUp方法中如果这个KeyEvent事件被认为是一次确认按键事件，并且View是clickable的还会触发View的performClick方法。
KeyEvent的分发的大概逻辑就是这样的，一次KeyEvent的分发其实就是把事件交给了焦点View处理，可见焦点View是很特别，那么：

  • 一个View怎样才可以获得焦点？
  • 一个Android手机应用运行在Android电视上可以响应按键事件吗？

请看下篇文章–Android TV开发按键与焦点深入分析（二）–View的焦点模式