awtk/docs/screen_saver.md

# 如何启用屏保

屏保是一个普通窗口，定时切换不同的图片或者动态绘制一些图形，以到达保护屏幕的效果。

## 一、设置屏保定时器时间

用函数 window\_manager\_set\_screen\_saver\_time 设置屏保时间。

```
/**
 * @method window_manager_set_screen_saver_time
 * 设置屏保时间。
 * @annotation ["scriptable"]
 * @param {widget_t*} widget 窗口管理器对象。
 * @param {uint32_t}  screen_saver_time 屏保时间（单位毫秒）。
 *
 * @return {ret_t} 返回 RET_OK 表示成功，否则表示失败。
 */
ret_t window_manager_set_screen_saver_time(widget_t* widget, uint32_t screen_saver_time);
```

```
window_manager_set_screen_saver_time(window_manager(), 180 * 1000);
```

## 二、注册事件并打开屏保窗口

示例：

```
static ret_t close_window_on_event(void* ctx, event_t* e) {
  window_close(WIDGET(ctx));

  return RET_REMOVE;
}

static ret_t on_screen_saver(void* ctx, event_t* e) {
  widget_t* win = NULL;
  const char* screen_saver_win = "image_animation";

  if (widget_child(window_manager(), screen_saver_win) != NULL) {
    log_debug("screen saver exist.\n");
    return RET_OK;
  }

  win = window_open(screen_saver_win);
  widget_on(win, EVT_POINTER_MOVE, close_window_on_event, win);
  widget_on(win, EVT_POINTER_UP, close_window_on_event, win);
  widget_on(win, EVT_KEY_UP, close_window_on_event, win);

  return RET_OK;
}

ret_t application_init() {
  tk_ext_widgets_init();

  /*enable screen saver*/
  window_manager_set_screen_saver_time(window_manager(), 180 * 1000);
  widget_on(window_manager(), EVT_SCREEN_SAVER, on_screen_saver, NULL);

  return show_preload_res_window();
}

```

> 可以在 XML 设置 window 的 fullscreen 属性，让屏保窗口进入全屏状态。

## 三、扩展用法

有时需求可能是这样的：

* 用户 m 秒没有操作，返回到主屏

* 用户 n 秒没有操作，启动屏保

* 用户 k 秒没有操作，进入睡眠。

> 其中 m < n < k

此时可以把 screen\_saver\_time 设置短一点（比如 5s)，每次收到屏保事件则更新用户没有操作的时间，根据这个时间做适当的处理。