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及更高版本