从源码出发浅析Android TV的焦点移动原理

本文禁止转载。之前我已经在微信公众号发过一次，有兴趣的可以看一下从源码出发浅析Android TV的焦点移动原理-上篇
和 从源码出发浅析Android TV的焦点移动原理-下篇

焦点：

焦点（Focus）可以理解为选中态，在Android TV上起很重要的作用。一个视图控件只有在获得焦点的状态下，才能响应按键的Click事件。

上图中，外面有一个绿色光圈的视图，就是当前有焦点的视图。

相对于手机上用手指点击屏幕产生的Click事件， 在使用Android TV的过程中，遥控器是一个主流的操作工具，通过点击遥控器的方向键来控制焦点的移动。当焦点移动到目标控件上之后，按下遥控器的确定键，才会触发一个Click事件，进而去做下一步的处理。焦点的移动如下图所示。

基础的用法：

在处理焦点的时候，有一些基础的用法需要知道。
首先，isFocusable()需要为true，一个控件才有资格可以获取到焦点，可以通过setFocusable(boolean)方法来设置。如果想要在触摸模式下获取焦点（在我们用手机开发的过程中），需要isFocusableInTouchMode()为true，可以通过setFocusableInTouchMode(boolean)来设置。也可以直接在xml布局文件中指定：

<Button
    ...
    android:focusable="true"
    android:focusableInTouchMode="true"/>

然后，就是控制焦点的移动了。在谷歌官方文档中提到：
焦点移动的时候（默认的情况下），会按照一种算法去找在指定移动方向上最近的邻居。在一些情况下，焦点的移动可能跟开发者的意图不符，这时开发者可以在布局文件中使用下面这些XML属性来指定下一个焦点对象：

nextFocusDown
nextFocusLeft
nextFocusRight
nextFocusUp 

在Java代码中，让一个指定的View获取焦点，可以调用它的requestFocus()方法。

遇到的问题：

尽管有了官方文档中提到的基础用法，但是在进行Android TV开发的过程中，还是经常会遇到一些焦点方面的问题或者疑问，如

• “明明指定了焦点id，焦点却跑丢了”
• “onKeyDown里居然截获不到按键事件”
• “我没有做任何焦点处理，焦点是怎么自己跑到那个View上的”

接下来，带着这些问题，我们就从源码的角度出发，简单分析一下焦点的移动原理。本文以API 23作为参考。

KeyEvent

在手机上，当手指触摸屏幕时，会产生一个的触摸事件，MotionEvent，进而完成点击，长按，滑动等行为。
而当按下遥控器的按键时，会产生一个按键事件，就是KeyEvent，包含“上”，“下”，“左”，“右”，“返回”，“确定”等指令。焦点的处理就在KeyEvent的分发当中完成。
首先，KeyEvent会流转到ViewRootImpl中开始进行处理，具体方法是内部类ViewPostImeInputStage中的processKeyEvent。（在API 17之前，是deliverKeyEventPostIme这个方法，逻辑大体一致，本文仅以processKeyEvent作为参考）

private int processKeyEvent(QueuedInputEvent q) {
        final KeyEvent event = (KeyEvent)q.mEvent;
        ...
        // Deliver the key to the view hierarchy.
        // 1. 先去执行mView的dispatchKeyEvent
        if (mView.dispatchKeyEvent(event)) {
            return FINISH_HANDLED;
        }
        ...
        // Handle automatic focus changes.
        if (event.getAction() == KeyEvent.ACTION_DOWN) {
            int direction = 0;
            ...
            if (direction != 0) {
                View focused = mView.findFocus();
                if (focused != null) {
                    // 2. 之后会通过focusSearch去找下一个焦点视图
                    View v = focused.focusSearch(direction);
                    if (v != null && v != focused) {
                        ...
                        if (v.requestFocus(direction, mTempRect)) {
                            ...
                            return FINISH_HANDLED;
                        }
                    }

                    // Give the focused view a last chance to handle the dpad key.
                    if (mView.dispatchUnhandledMove(focused, direction)) {
                        return FINISH_HANDLED;
                    }
                } else {
                    // find the best view to give focus to in this non-touch-mode with no-focus
                    // 3. 如果当前本来就没有焦点视图，也会通过focusSearch找一个视图
                    View v = focusSearch(null, direction);
                    if (v != null && v.requestFocus(direction)) {
                        return FINISH_HANDLED;
                    }
                }
            }
        }
        return FORWARD;
    }

从几处关键的代码，可以看到这里的逻辑是：
1. 先去执行mView的dispatchKeyEvent
2. 之后会通过focusSearch去找下一个焦点视图
3. 如果当前本来就没有焦点View，也会通过focusSearch找一个视图

ViewRootImpl就是ViewRoot，继承了ViewParent，但本身并不是一个View，可以看作是View树的管理者。而这里的成员变量mView就是DecorView，它指向的对象跟Window和Activity的mDecor指向的对象是同一个对象。所有的View组成了一个View树，每一个View都是树中的一个节点，如下图所示：