timer

来自于:开发者立即使用

startTimer stopTimer

概述

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对象
  • 描述:返回回调状态
  • 内部字段:
  1. {
  2. status:1 //1:回调时附带的值
  3. }

示例代码

  1. var demo = api.require('timer');
  2. demo.startTimer({
  3. delay:1000,
  4. period:4000,
  5. isLoop:true
  6. },function(ret){
  7. alert(JSON.stringify(ret));
  8. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

stopTimer

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

stopTimer(callback(ret))

callback(ret)

ret:

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

示例代码

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

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本