AWTK 开源串口屏开发(6) - 定时器的用法

定时器是个常用的功能，AWTK 串口屏提供了丰富的定时器函数，用于定时器的启动、停止、暂停、恢复、修改和重置等功能，本文以计时器的例子来介绍定时器的基本用法。定时器也是一个常用的功能，在 AWTK 串口屏中，可以给每个控件（包括窗口）创建一个定时器，定时器到点后触发 v-on:timer 事件。在 AWTK 串口屏中，提供了 6 个定时器相关函数：

• start_timer启动定时器。
• stop_timer停止定时器。
• suspend_timer暂停定时器。
• resume_timer恢复暂停的定时器。
• reset_timer重置定时器。
• modify_timer修改定时器的时间。

这些函数第一个参数为控件的名字，如果不指定，则默认为当前控件。

1. 功能

本文以计时器的例子来介绍定时器的使用方法。在这里例子中，模型（也就是数据）里只有一个计时变量：

变量名	数据类型	功能说明
计时	整数	无

2. 创建项目

从模板创建项目，将 hmi/template_app 拷贝 hmi/timer 即可。

第一个项目最好不要放到其它目录，因为放到其它目录需要修改配置文件中的路径，等熟悉之后再考虑放到其它目录。路径中也不要中文和空格，避免不必要的麻烦。

3. 制作界面

用 AWStudio 打开上面 timer 目录下的 project.json 文件。里面有一个空的窗口，在上面加入下面的控件：

静态文本

• 4 个按钮

做出类似下面的界面。

定时器设置在静态文本上，所以必须给它取一个在当前窗口内唯一的名称，这里就叫 “tick”。

4. 添加绑定规则

将静态文本绑定到计时变量。添加自定义的属性v-data:value，将值设置为{计时}。

绑定属性	绑定规则	说明
v-data:value	{计时}	变量要用英文大括号括起来。
v-on:timer	{fscript, Args=set(计时，计时+1)}	定时器事件，增加计时

在启动按钮的点击事件启动定时器。

绑定属性	绑定规则	说明
v-on:click	{fscript, Args=start_timer(‘tick’, 1000);}	1000 表示定时器的时间间隔为 1000 毫秒。

在暂停按钮的点击事件暂停定时器。

绑定属性	绑定规则	说明
v-on:click	{fscript, Args=suspend_timer(‘tick’)}	无

在恢复按钮的点击事件恢复定时器。

绑定属性	绑定规则	说明
v-on:click	{fscript, Args=resume_timer(‘tick’)}	无

在停止按钮的点击事件停止定时器。

绑定属性	绑定规则	说明
v-on:click	{fscript, Args=stop_timer(‘tick’);set（计时，0)}	停止定时器，并将计时清零

同样指定窗口的模型为 default。

绑定属性	绑定规则	说明
v-model	default	default 不需要用大括号括起来。

5. 初始化数据

修改资源文件 design/default/data/default_model.json, 将其内容改为：

{ "计时":0}

注意：

• 如果文件内容有中文（非 ASCII 字符），一定要保存为 UTF-8 格式。
• 重新打包资源才能生效。

6. 编译运行

运行 bin 目录下的 demo 程序，启动定时器后，计时自动增加。

7. 注意

本项目并没有编写界面相关的代码，AWStudio 在 src/pages 目录下生成了一些代码框架，这些代码并没有用到，可以删除也可以不用管它，但是不能加入编译。