三星智能电视Tizen Web应用屏保开关、自定义屏保设置及相关问题咨询

屏保开启/关闭实现 #

可通过AppCommon API的setScreenSaver接口实现屏保的开关控制，示例代码如下：

// 开启屏保
webapis.appcommon.setScreenSaver(
  webapis.appcommon.AppCommonScreenSaverState.SCREEN_SAVER_ON,
  function(result) {
    console.log(result);
  }, function(error) {
    console.log(JSON.stringify(error));
  }
);

// 关闭屏保
webapis.appcommon.setScreenSaver(
  webapis.appcommon.AppCommonScreenSaverState.SCREEN_SAVER_OFF,
  function(result) {
    console.log(result);
  }, function(error) {
    console.log(JSON.stringify(error));
  }
);

注意：
如果电视设置中的"Auto Protection Time"处于关闭状态，使用AppCommon API开启或关闭屏保将不生效。若应用要上架三星应用商店，必须正确控制屏保的开关逻辑。

屏保触发时长设置说明 #

目前三星官方公开的Tizen Web API暂不支持第三方应用查询、修改系统屏保的触发等待时长，该参数属于系统级设置，仅支持用户在电视系统设置页面手动调整。

Auto Protection Time相关说明 #

定义 #

Auto Protection Time即自动保护时间，是三星电视为OLED、QLED等面板设计的防烧屏机制，功能开启后，电视会在无用户操作达到指定时长后自动启动屏保，避免静态画面长时间停留在屏幕上损伤面板。

适配方案 #

• 目前无公开API可直接查询该功能的开关状态，建议在应用需要调用屏保控制接口的场景，弹出引导提示让用户确认系统设置中该功能已开启，避免API调用失效。
• 若应用存在长时间展示静态画面的场景（如视频暂停、静态内容展示），必须在进入该场景时调用关闭屏保接口，退出该场景时立即调用接口恢复屏保开启状态，不符合该规范的应用无法通过三星应用商店的上架审核。

自定义屏保实现方案 #

三星暂未开放可直接替换系统默认屏保的公共API，若需要实现自定义屏保效果，可通过应用内逻辑模拟实现：

• 在应用内自行维护用户无操作计时，达到预设时长后，在当前页面上层弹出全屏的自定义屏保UI层，播放你预设的动画、图片等内容即可。
• 检测到用户遥控器操作后，隐藏自定义屏保UI层，恢复正常应用交互即可。
• 实现该方案时需要同步调用系统API关闭系统屏保，避免自定义屏保播放过程中触发系统默认屏保。

内容的提问来源于stack exchange，提问作者Ronak Chaniyara