Understanding the TV App Lifecycle

The diagram below outlines the various states of the app user interface and the transitions between these states that are activated by keypresses on the remote control. The viewport and overlay states for the dock and the sidebar support the same transitions (see the state pairs 2-3, 6-7, 4-5, 8-9). In order to simplify the state transition diagram below, the keypress transitions from the viewport states that are the same as those from the paired overlay states have not been diagramed. The diagram's legend is described in the Remote Control Keypress Transitions section.

User Interface States

The first state of the app user interface is fullscreen pass-thru video, which is generally broadcast TV. By pressing the Yahoo TV Key, the app user interface is launched and supports transitions to various states based on remote control keypresses. The following list corresponds to the 13 user interface states pictured above:

  1. Fullscreen Pass-thru Video

    This state is basic broadcast TV. This state also supports video that is not from an app (for example, DVR, on-demand, DVD, or set-top device). Pressing the Yahoo TV Key brings up the dock.

  2. Dock Overlaid Pass-thru Video

    The Yahoo TV Key has been pressed, bringing up the dock overlaid pass-thru video. The BLUE key toggles the UI to viewport mode. The RED key and the Yahoo TV Key exit to fullscreen pass-thru video. Sidebars and fullscreen user interfaces can be launched from this state using the OK key.

  3. Dock Viewport Pass-thru Video

    The BLUE key has been pressed, toggling the UI to viewport mode. All state transitions are similar to those from the dock overlaid pass-thru video state. Pressing the BLUE key again will toggle the UI to overlay mode.

  4. Dock Overlaid Streaming Video

    The dock is displayed over streaming video. Pressing the Yahoo TV Key will close the dock. Pressing the BLUE key will toggle the UI to viewport mode. Pressing the RED key once will close the dock. Pressing the RED key again will close the streaming video and display fullscreen pass-thru video.

  5. Dock Viewport Streaming Video

    The BLUE key has been pressed, toggling the UI to viewport mode. All state transitions are similar to those from the dock overlaid streaming video state. Pressing the BLUE key again will toggle the UI to overlay mode.

  6. Sidebar Overlaid Pass-thru Video

    The sidebar is displayed over pass-thru video. The BLUE key toggles the UI to viewport mode. The Yahoo TV Key brings up the dock. The RED key exits to fullscreen pass-thru video.

  7. Sidebar Viewport Pass-thru Video

    The BLUE key has been pressed, toggling the UI to viewport mode. All state transitions are similar to those from the sidebar overlaid pass-thru video state. Pressing the BLUE key again will toggle the UI to overlay mode.

  8. Sidebar Overlaid Streaming Video

    The sidebar is displayed over streaming video. Pressing the Yahoo TV Key will bring up the dock. Pressing the BLUE key will toggle the UI to viewport mode. Pressing the RED key once will close the sidebar. Pressing the RED key again will close the streaming video and display fullscreen pass-thru video.

  9. Sidebar Viewport Streaming Video

    The BLUE key has been pressed, toggling the UI to viewport mode. All state transitions are similar to those from the sidebar overlaid streaming video state. Pressing the BLUE key again will toggle the UI to overlay mode.

  10. Fullscreen UI

    The screen is covered with graphical elements. No video is played. Pressing the Yahoo TV Key can bring up a dialog or bring up the dock, based on a configuration parameter. Pressing the RED key exits to fullscreen pass-thru video. In the fullscreen UI state, the GREEN, YELLOW, and BLUE keys are controlled by the app.

  11. Fullscreen UI Pass-thru Video

    The screen has both graphical elements and pass-thru video. Pressing the Yahoo TV Key can bring up a dialog or bring up the dock, based on a configuration parameter. Pressing the RED key exits to fullscreen pass-thru video. In the fullscreen UI state, the GREEN, YELLOW, and BLUE keys are controlled by the app. This state may not be supported by all device partners. Refer to the Yahoo Connected TV Developer Forum (https://developer.yahoo.com/forum/Connected TV) for the latest support status.

  12. Fullscreen UI Streaming Video

    The screen may have both graphical elements and streaming video. Pressing the Yahoo TV Key can bring up a dialog or bring up the dock, based on a configuration parameter. Pressing the RED key exits to fullscreen pass-thru video. In the fullscreen UI state, the GREEN, YELLOW, and BLUE keys are controlled by the app.

  13. Dialog over Fullscreen UI

    The Yahoo TV Key has been pressed from the fullscreen UI state, and a configuration has been set to bring up a dialog. The consumer can choose to stop the app and view the dock overlaid pass-thru video or resume the app's fullscreen UI.

Remote Control Keypress Transitions

The legend in the diagram above outlines the follow remote control keypress transitions:

  • The purple arrow represents pressing the Yahoo TV Key on the remote control.
  • The red arrow represents pressing the RED key on the remote control.
  • The blue arrow represents pressing the BLUE key on the remote control.
  • The black arrow represents a transition initiated by the OK or BACK keys and is programmable by the app developer.
  • The dashed double-lined arrow represents the transition initiated by pressing the Transport STOP key to stop video playback.

Table of Contents