android TIF 3

TvView类概述：
显示TV内容。TvView类为应用程序提供了一个高级接口，以显示实现TvInputService的各种TV信号源的节目。（注意系统上可用的TV Inputs列表可以通过调用 TvInputManager.getTvInputList()来获取。

一旦应用程序提供了特定TV通道的URL给tune(String, Uri)方法，它负责下层的服务绑定（和解除绑定如果当前的TvView已经绑定到一个服务)并且根据需要自动的分配或者释放资源。除了一些控制内容如何呈现的基本方法，它也提供了一个给已经连接的TvInputService分发输入事件的办法，以允许为Tv Input客制化按键动作。

TvView类概述：
显示TV内容。TvView类为应用程序提供了一个高级接口，以显示实现TvInputService的各种TV信号源的节目。（注意系统上可用的TV Inputs列表可以通过调用TvInputManager.getTvInputList()来获取。
一旦应用程序提供了特定TV通道的URL给tune(String, Uri)方法，它负责下层的服务绑定（和解除绑定如果当前的TvView已经绑定到一个服务)并且根据需要自动的分配或者释放资源。除了一些控制内容如何呈现的基本方法，它也提供了一个给已经连接的TvInputService分发输入事件的办法，以允许为Tv Input客制化按键动作。

Tv Input的选择和显示是通过TvView的tune方法来做的，我们看一下tune的实现:

/**
     * Tunes to a given channel.
     *
     * @param inputId The ID of TV input which will play the given channel.
     * @param channelUri The URI of a channel.
     * @param params Extra parameters which might be handled with the tune event.
     * @hide
     */
    @SystemApi
    public void tune(String inputId, Uri channelUri, Bundle params) {
        ...
        if (mSessionCallback != null && mSessionCallback.mInputId.equals(inputId)) {
            if (mSession != null) {
                mSession.tune(channelUri, params);
            } else {
                // Session is not created yet. Replace the channel which will be set once the
                // session is made.
                mSessionCallback.mChannelUri = channelUri;
                mSessionCallback.mTuneParams = params;
            }
        } else {
            resetInternal();
            // When createSession() is called multiple times before the callback is called,
            // only the callback of the last createSession() call will be actually called back.
            // The previous callbacks will be ignored. For the logic, mSessionCallback
            // is newly assigned for every createSession request and compared with
            // MySessionCreateCallback.this.
            mSessionCallback = new MySessionCallback(inputId, channelUri, params);
            if (mTvInputManager != null) {
                mTvInputManager.createSession(inputId, mSessionCallback, mHandler);
            }
        }
    }

tune方法有三个参数，我们只关注第一个参数inputId，每个Tv Input都有一个唯一的inputId和TvInputInfo实例，inputId由 TvInputInfo.getId()获取。第一次调用tune的时候，mSessionCallback为null，所以首先执行 mSessionCallback = new MySessionCallback(inputId, channelUri, params)创建一个SessionCallback实例，然后通过 mTvInputManager.createSession(inputId, mSessionCallback, mHandler)来跟TvInputService之间创建一个会话，当会话创建成功以后，mSessionCallback被回调回来，createSession的具体细节我们忽略掉，最终会调用到TvInputService的createSession，

          public void createSession(InputChannel channel, ITvInputSessionCallback cb,
                    String inputId) {
                if (channel == null) {
                    Log.w(TAG, "Creating session without input channel");
                }
                if (cb == null) {
                    return;
                }
                SomeArgs args = SomeArgs.obtain();
                args.arg1 = channel;
                args.arg2 = cb;
                args.arg3 = inputId;
                mServiceHandler.obtainMessage(ServiceHandler.DO_CREATE_SESSION, args).sendToTarget();
            }

接着ServiceHandler.handleMessage

public final void handleMessage(Message msg) {
            switch (msg.what) {
                case DO_CREATE_SESSION: {
                    SomeArgs args = (SomeArgs) msg.obj;
                    InputChannel channel = (InputChannel) args.arg1;
                    ITvInputSessionCallback cb = (ITvInputSessionCallback) args.arg2;
                    String inputId = (String) args.arg3;
                    args.recycle();
                    Session sessionImpl = onCreateSession(inputId);
                    ...
  else {
                        SomeArgs someArgs = SomeArgs.obtain();
                        someArgs.arg1 = sessionImpl;
                        someArgs.arg2 = stub;
                        someArgs.arg3 = cb;
                        someArgs.arg4 = null;
                        mServiceHandler.obtainMessage(ServiceHandler.DO_NOTIFY_SESSION_CREATED,
                                someArgs).sendToTarget();
                    }
                    return;
                }
                case DO_NOTIFY_SESSION_CREATED: {
                    SomeArgs args = (SomeArgs) msg.obj;
                    Session sessionImpl = (Session) args.arg1;
                    ITvInputSession stub = (ITvInputSession) args.arg2;
                    ITvInputSessionCallback cb = (ITvInputSessionCallback) args.arg3;
                    IBinder hardwareSessionToken = (IBinder) args.arg4;
                    try {
                        cb.onSessionCreated(stub, hardwareSessionToken);
                    } catch (RemoteException e) {
                        Log.e(TAG, "error in onSessionCreated");
                    }
                    if (sessionImpl != null) {
                        sessionImpl.initialize(cb);
                    }
                    args.recycle();
                    return;
                }

先调用onCreateSession(inputId)创建一个Session，然后通知Session创建成功，即调用cb.onSessionCreated，最终会调到TvView.MySessionCallback.onSessionCreated，

public void onSessionCreated(Session session) {
           ...
            mSession = session;
            if (session != null) {
                synchronized (sMainTvViewLock) {
                    if (hasWindowFocus() && TvView.this == sMainTvView.get()) {
                        mSession.setMain();          ---<1>
                    }
                }
                // mSurface may not be ready yet as soon as starting an application.
                // In the case, we don't send Session.setSurface(null) unnecessarily.
                // setSessionSurface will be called in surfaceCreated.
                if (mSurface != null) {
                    setSessionSurface(mSurface);      ---<2>
                    if (mSurfaceChanged) {
                        dispatchSurfaceChanged(mSurfaceFormat, mSurfaceWidth, mSurfaceHeight);
                    }
                }
                createSessionOverlayView();
                if (mCaptionEnabled != CAPTION_DEFAULT) {
                    mSession.setCaptionEnabled(mCaptionEnabled == CAPTION_ENABLED);
                }
                mSession.tune(mChannelUri, mTuneParams);    ---<3>
                if (mHasStreamVolume) {
                    mSession.setStreamVolume(mStreamVolume);
                }
             ...
            }  

• <1> 设置当前的Session为主Session，setMain最终会调到TvInputService.Session.onSetMain，如果TV Input Service是管理HDMI CEC逻辑设备，需要实现onSetMain这个方法来选择对应的HDMI CEC逻辑设备作为源设备，主Session对应的Tv Input为当前活动的源设备（Active Source)。

• <2> 为当前的Input Session设置Surface，Tv Input会在这个surface上渲染视频，setSessionSurface会最终调到TvInputService.Session.setSurface，接着会调到TvInputHardwareManager.setSurface，最后调用到TvInputHal.addOrUpdateStream让HAL来做相关的配置。这一步是关键，Tv Input端口的选择以及视频通道的配置都是这一部完成的。

• <3> 调谐到对应的频道，主要是指模拟电视或者数字电视。