Android TIF 为制造商提供了一个标准 API，供他们创建能够控制 Android TV 的输入模块，并让他们可以通过 TV Input（电视输入源）发布的元数据来搜索和推荐直播电视内容。
具体介绍可以参考官文TV Input framework | Android Open Source Project (google.cn)
对于TIF的按键处理流程，官文中也有介绍，比较简单，如下图所示，当实际遇到问题时就不够用了，所以在这里梳理了一下按键涉及到的code flow。
首先，推荐先阅读Android——按键事件KeyEvent的分发处理流程解析_小欣儿的专栏-CSDN博客_android按键事件分发流程这篇文章，理解一般情况下按键的处理流程。
接下来进入正文，对于TIF框架中，与用户按键交互的时TvView这个class，按键都是通过其中的dispatchKeyEvent()传递给TvInputService.Session的，可以看一下它的注释。
调用TvView中的dispatchKeyEvent的形式也分几种：
- TvView本身可以获取焦点，则默认自动走Activity:dispatchKeyEvent -> TvView:dispatchKeyEvent->TIS, （不override Activity的dispatchKeyEvent）TvView本身不能获取焦点，则需要手动编程，在Activity:dispatchKeyEvent中调用TvView:dispatchKeyEvent ->TIS,（override Activity的dispatchKeyEvent）TvView本身不能获取焦点，则需要手动编程，在Activity:onKeyDown/onKeyUp中调用TvView:dispatchKeyEvent ->TIS,（override Activity的onKeyDown/onKeyUp）
可根据自己的场景选择使用一种；
第1种有弊端就是TvView被遮挡后，就没办法传Key给TvView了。通常后两者比较常用，并且还可以根据需要拦截掉一些不需要传给TvView/TIS去处理的key。
第2种也需要注意的就是当底层消耗掉按键以后，Activity:dispatchKeyEvent理论上是要返回true，Activity的onKeyDown/onKeyUp就不会再被触发。
以第2中为例，
app端按键的发送流程为：Activity:dispatchKeyEvent -> TvView:dispatchKeyEvent-> TvInputManager.Session:dispatchInputEvent
-> TvInputManager.Session:sendInputEventonMainLooperLocked -> TvInputEventSender:sendInputEvent -> nativeSendKeyEvent,
最后通过InputChannel发送给接收方，即通过该TvView创建的TvInputService.Session。
TvInputService.Session端按键的接收流程为：
ITvInputSessionWrapper:TvInputEventReceiver:onInputEvent -> TvInputService.Session:dispatchInputEvent -> keyEvent.dispatch -> mOverlayViewContainer.getViewRootImpl().dispatchInputEvent
其中的keyEvent.dispatch又会继续调用TvInputService.Session中的onKeyDown/onKeyUp，实现了key的传递。如果onKeyDown/onKeyUp返回true，即按键被消耗后，key将不会继续发送给overlayView去处理。
如果是导航键，并且overlayView包含有获取焦点的能力view（不管当前有没有获取到焦点），按键也会被认为被消耗了，返回DISPATCH_HANDLED。否则，走android viewGroup的分发按键的流程，在overlayViewContainer中去查找合适的view去处理按键事件，在Android——按键事件KeyEvent的分发处理流程解析_小欣儿的专栏-CSDN博客_android按键事件分发流程已经介绍过。
if (isNavigationKey && mOverlayViewContainer.hasFocusable()) {
// If mOverlayView has focusable views, navigation key events should be always
// handled. If not, it can make the application UI navigation messed up.
// For example, in the case that the left-most view is focused, a left key event
// will not be handled in ViewRootImpl. Then, the left key event will be handled in
// the application during the UI navigation of the TV input.
mOverlayViewContainer.getViewRootImpl().dispatchInputEvent(event);
return TvInputManager.Session.DISPATCH_HANDLED;
} else {
mOverlayViewContainer.getViewRootImpl().dispatchInputEvent(event, receiver);
return TvInputManager.Session.DISPATCH_IN_PROGRESS;
}
函数最后这里两个不同的return，会影响TvView中的OnUnhandledInputEventListener.onUnhandledInputEvent是否会回调到。
我们在看一下TvView.dispatchKeyEvent
当一次按键分发完成（可能消耗，也可能未消耗）之后，都是回调InputEventSender.dispatchInputEventFinished -> InputEventSender.onInputEventFinished.
对于TIF来讲其实现就是TvInputEventSender。
private final class TvInputEventSender extends InputEventSender {
public TvInputEventSender(InputChannel inputChannel, Looper looper) {
super(inputChannel, looper);
}
@Override
public void onInputEventFinished(int seq, boolean handled) {
finishedInputEvent(seq, handled, false);
}
}
TvInputManager.Session:finishedInputEvent -> TvInputManager.Session:invokeFinishedInputEventCallback -> TvInputManager.PendingEvent:run -> mCallback.onFinishedInputEvent.
其中的mCallback就是在TvInputManager.Session.dispatchInputEvent时，从TvView传递过来的FinishedInputEventCallback，并将其赋值给PendingEvent。
在onFinishedInputEvent有判断，如果key在底层已经消耗了，则直接返回。
否则回调到app设定的OnUnhandledInputEventListener.onUnhandledInputEvent中去。
