top

Setting Screensaver

This topic describes how your application can enable and disable the screensaver functionality on the TV.

The screensaver is used to prevent screen burn when the TV screen displays a still image or the user provides no input for some time. If the screensaver is enabled, it is automatically shown after a defined amount of time with no activity.

You must disable the screensaver during activities when the user is watching the TV without giving input, such as video playback or image slideshows. You can use the AppCommon API to enable and disable the screensaver.

Note

If “Auto Protection Time” is switched off in the TV settings, enabling and disabling the screensaver using the AppCommon API has no effect.

To be published on Samsung Apps TV, your application must enable and disable the screensaver appropriately.

  • To enable the screensaver when media playback is paused or stopped:
webapis.appcommon.setScreenSaver(
  webapis.appcommon.AppCommonScreenSaverState.SCREEN_SAVER_ON,
  function(result) {
    console.log(result);
  }, function(error) {
    console.log(JSON.stringify(error));
  }
);
  • To disable the screensaver when media playback is started or resumed:
webapis.appcommon.setScreenSaver(
  webapis.appcommon.AppCommonScreenSaverState.SCREEN_SAVER_OFF,
  function(result) {
    console.log(result);
  }, function(error) {
    console.log(JSON.stringify(error));
  }
);