Chapter 7. TV App Event Lifecycle

Each app has a lifecycle, for example becoming active, performing operations, and becoming inactive. During its lifecycle, the app makes available and visible the views of its user interface. Each user interface view also has a lifecycle. A view is loaded, made visible, and unloaded. The following diagram outlines the updated app lifecycle, including the view states of an app and the methods called during state transitions:

Application Engine Event Reference

Events allow your app to listen to input from the user (i.e. remote control key presses), listen to requests from the Engine, and send requests to the Engine.

The following table defines the events used by apps.

Handler Name

Event Class

Received By

Description

exitToDock

ChildEvent

Engine

Called when the screensaver or a dialog exits to the dock.

exitToFullscreenVideo

ChildEvent

Engine

Called when the screensaver or a dialog exits to fullscreen video.

setFavAction

ChildEvent

Engine

Controls the add/delete bookmark function in the global navigation bar.

setScreensaver

ChildEvent

Engine

Enables the screensaver in fullscreen mode.

Table of Contents