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