Terminating Applications

This topic describes how you can implement an application exit: through user interaction, or internally based on the application logic.

Related Info

When the user exits a TV application, JavaScript execution is paused, and the current application state is not stored. When the application is launched again, the application state is reset.

Implementing the Exit

There are 2 ways to terminate a TV application:

  • Through user interaction, when the user long-presses the remote control "Return/Exit" key.
    Figure 1. "Return/Exit" key

  • Based on the application logic, by calling the exit() method

    The getCurrentApplication().exit() method of the Application API terminates the application.

    tizen.application.getCurrentApplication().exit();

    Call this method to implement the "Yes" button on an exit confirmation popup.

Return Key Policy

The Samsung Apps TV policy defines requirements for the implementation of the "Return/Exit" key click:

  • From a detail page within an application, clicking the "Return/Exit" key must display the previous page.
  • From the home page of an application, clicking the "Return/Exit" key must display an exit confirmation popup.

    The application is only terminated if the user clicks "Yes" in the popup.

    Figure 2. "Return/Exit" key click process