timer

来自于:开发者立即使用

概述

timer封装了手机计时器,可设置间隔时间和延时时间,通过计时器可定时循坏的执行一段代码。

模块接口

startTimer

开启计时器。开启计时器后,如果开启循坏(isLoop设为true),模块会在delay毫秒后回调callback,以后会间隔period毫秒回调callback,如果关闭循坏(isLoop设为false),模块只会在delay毫秒后回调callback一次,之后不再会回调。开发者可将要定时执行的js代码放到callback函数中执行。

startTimer({params},callback(ret))

params

delay:

  • 类型:整形
  • 默认:0,无延时,开启计时器后立即执行一次回调.
  • 描述:延时执行回调的时间,单位毫秒.

isLoop:

  • 类型:布尔型
  • 默认:true,开启计时循坏
  • 描述:是否循环执行回调.开启计时器后,如果开启循坏(isLoop设为true),模块会在delay毫秒后回调callback,以后会间隔period毫秒回调callback,如果关闭循坏(isLoop设为false),模块只会在delay毫秒后回调callback一次,之后不再会回调。开发者可将要定时执行的js代码放到callback函数中执行。

period:

  • 类型:整形
  • 默认:3000
  • 描述:间隔执行回调的时间,单位毫秒。只有在isLoop为true时有效.

callback(ret)

ret:

  • 类型:JSON对象
  • 描述:返回回调状态
  • 内部字段:
{
    status:1     //1:回调时附带的值
}

示例代码

var demo = api.require('timer');
    demo.startTimer({
        delay:1000,
        period:4000,
        isLoop:true
},function(ret){
        alert(JSON.stringify(ret));
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

stopTimer

停止计时器,startTimer和stopTimer应一 一对应,调用startTimer后应在适当地方调用stopTimer停止计时器。

stopTimer(callback(ret))

callback(ret)

ret:

  • 类型:JSON对象
  • 内部字段:
{
    status: 1  //1:停止成功,0:停止失败  
}

示例代码

var demo = api.require('timer');
    demo.stopTimer(function(ret){
            alert(JSON.stringify(ret));
    });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本