kmTimer

来自于：开发者立即使用

概述

kmTimer封装了IOS的NSTimer和Android的Timer功能，不需要其他配置，简单使用。

初始化

var timer = null;
apiready = function(){
  timer = api.require('kmTimer');
}

每定义一个timer，需要增加一个监听事件用于处理timer任务

api.addEventListener({name:"timer"}, function(ret, err){
  console.log(JSON.stringify(ret));
});

start

启动定时器

start({params}, callback(ret, err))

params

event：

类型：字符串
描述：允许自定义事件

delay：

类型：Number
描述：延迟执行时间（秒）
默认值：0-不延时

interval：

类型：Number
描述：循环执行间隔（秒），仅crycle=true有效
默认值：1

crycle:

类型：布尔值
描述：是否循环执行
默认值：false

callback(ret, err)

ret：

类型：JSON对象
内部字段：

err：

类型：JSON对象
内部字段：

示例代码

var params = {"event":"timer","delay":0,"interval":5,"crycle":true};
timer.start(params, function(ret, err) {
    console.log(JSON.stringify(ret));
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

setInterval

修改循环执行时间间隔

setInterval({params}, callback(ret, err))

params

event：

类型：字符串
描述：允许自定义事件

interval：

类型：Number
描述：循环执行间隔（秒），仅crycle=true有效
默认值：1

callback(ret, err)

ret：

类型：JSON对象
内部字段：

err：

类型：JSON对象
内部字段：

示例代码

var params = {"event":"timer","interval":5};
timer.setInterval(params, function(ret, err) {
    console.log(JSON.stringify(ret));
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

stop

关闭定时器

stop({params}, callback(ret, err))

params

event：

类型：字符串
描述：允许自定义事件。

callback(ret, err)

ret：

类型：JSON对象
内部字段：

err：

类型：JSON对象
内部字段：

示例代码

var params = {"event":"timer"};
timer.stop(params, function(ret, err) {
    console.log(JSON.stringify(ret));
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本