LayaAir 定时器 Timer

以你之姓@ 2022-04-10 13:28 524阅读 0赞

**目录**

Timer

编码示例

callLater 延迟调用

延迟执行

间隔循环

时钟暂停与恢复

结束定时器

优化策略

--------------------

# Timer  #

<table> 
 <tbody> 
  <tr> 
   <td style="width:176px;"><strong>Package</strong></td> 
   <td style="width:673px;">laya.utils</td> 
  </tr> 
  <tr> 
   <td style="width:176px;"><strong>类</strong></td> 
   <td style="width:673px;">public class Timer</td> 
  </tr> 
  <tr> 
   <td style="width:176px;"><strong>Inheritance</strong></td> 
   <td style="width:673px;">Timer <img alt="Inheritance" src="https://layaair.ldc.layabox.com/api2/Chinese/images/inherit-arrow.gif"> Object</td> 
  </tr> 
 </tbody> 
</table>

Timer 是时钟管理类，它是一个单例，不要手动实例化此类，应该通过 Laya.timer 访问。

<table> 
 <tbody> 
  <tr> 
   <th colspan="1">Property（属性）</th> 
  </tr> 
  <tr> 
   <td><a href="https://layaair.ldc.layabox.com/api2/Chinese/index.html?category=Core&amp;class=laya.utils.Timer#currFrame" rel="nofollow">currFrame</a> : int = 0 ，当前的帧数。</td> 
  </tr> 
  <tr> 
   <td><a href="https://layaair.ldc.layabox.com/api2/Chinese/index.html?category=Core&amp;class=laya.utils.Timer#currTimer" rel="nofollow">currTimer</a> : Number ，当前帧开始的时间。</td> 
  </tr> 
  <tr> 
   <td><a href="https://layaair.ldc.layabox.com/api2/Chinese/index.html?category=Core&amp;class=laya.utils.Timer#delta" rel="nofollow">delta</a> : int ，[read-only] 两帧之间的时间间隔,单位毫秒。</td> 
  </tr> 
  <tr> 
   <td><a href="https://layaair.ldc.layabox.com/api2/Chinese/index.html?category=Core&amp;class=laya.utils.Timer#scale" rel="nofollow">scale</a> : Number = 1 ，时针缩放。</td> 
  </tr> 
 </tbody> 
</table>

<table> 
 <tbody> 
  <tr> 
   <th>Method（方法）</th> 
  </tr> 
  <tr> 
   <td> <p><a href="https://layaair.ldc.layabox.com/api2/Chinese/index.html?category=Core&amp;class=laya.utils.Timer#callLater%28%29" rel="nofollow">callLater</a>(caller:*, method:Function, args:Array = null):void ，延迟执行。</p> </td> 
  </tr> 
  <tr> 
   <td> <p><a href="https://layaair.ldc.layabox.com/api2/Chinese/index.html?category=Core&amp;class=laya.utils.Timer#clear%28%29" rel="nofollow">clear</a>(caller:*, method:Function):void ，清理定时器。</p> </td> 
  </tr> 
  <tr> 
   <td> <p><a href="https://layaair.ldc.layabox.com/api2/Chinese/index.html?category=Core&amp;class=laya.utils.Timer#clearAll%28%29" rel="nofollow">clearAll</a>(caller:*):void ，清理对象身上的所有定时器。</p> </td> 
  </tr> 
  <tr> 
   <td> <p><a href="https://layaair.ldc.layabox.com/api2/Chinese/index.html?category=Core&amp;class=laya.utils.Timer#frameLoop%28%29" rel="nofollow">frameLoop</a>(delay:int, caller:*, method:Function, args:Array = null, coverBefore:Boolean = true):void ，定时重复执行(基于帧率)。</p> </td> 
  </tr> 
  <tr> 
   <td> <p><a href="https://layaair.ldc.layabox.com/api2/Chinese/index.html?category=Core&amp;class=laya.utils.Timer#frameOnce%28%29" rel="nofollow">frameOnce</a>(delay:int, caller:*, method:Function, args:Array = null, coverBefore:Boolean = true):void ，定时执行一次(基于帧率)。</p> </td> 
  </tr> 
  <tr> 
   <td> <p><a href="https://layaair.ldc.layabox.com/api2/Chinese/index.html?category=Core&amp;class=laya.utils.Timer#loop%28%29" rel="nofollow">loop</a>(delay:int, caller:*, method:Function, args:Array = null, coverBefore:Boolean = true, jumpFrame:Boolean = false):void</p> <p>定时重复执行。</p> </td> 
  </tr> 
  <tr> 
   <td> <p><a href="https://layaair.ldc.layabox.com/api2/Chinese/index.html?category=Core&amp;class=laya.utils.Timer#once%28%29" rel="nofollow">once</a>(delay:int, caller:*, method:Function, args:Array = null, coverBefore:Boolean = true):void ，定时执行一次。</p> </td> 
  </tr> 
  <tr> 
   <td> <p><a href="https://layaair.ldc.layabox.com/api2/Chinese/index.html?category=Core&amp;class=laya.utils.Timer#pause%28%29" rel="nofollow">pause</a>():void ，暂停时钟</p> </td> 
  </tr> 
  <tr> 
   <td> <p><a href="https://layaair.ldc.layabox.com/api2/Chinese/index.html?category=Core&amp;class=laya.utils.Timer#resume%28%29" rel="nofollow">resume</a>():void ，恢复时钟</p> </td> 
  </tr> 
  <tr> 
   <td> <p><a href="https://layaair.ldc.layabox.com/api2/Chinese/index.html?category=Core&amp;class=laya.utils.Timer#runCallLater%28%29" rel="nofollow">runCallLater</a>(caller:*, method:Function):void ，立即执行 callLater 。</p> </td> 
  </tr> 
  <tr> 
   <td> <p><a href="https://layaair.ldc.layabox.com/api2/Chinese/index.html?category=Core&amp;class=laya.utils.Timer#runTimer%28%29" rel="nofollow">runTimer</a>(caller:*, method:Function):void ，立即提前执行定时器，执行之后从队列中删除</p> </td> 
  </tr> 
 </tbody> 
</table>

# 编码示例 #

## [callLater][] 延迟调用 ##

> /\*\*延迟执行一次  
>  \* @param   caller 执行域(this)。  
>  \* @param   method 定时器回调函数——只会执行一次  
>  \* @param   args 回调参数。  
>  \*/  
> callLater(caller: any, method: Function, args?: Array<any>): void;

![20190107162135293.gif][]

实现上述效果有很多的方式，这里以使用 callLater 函数为例进行说明。为 label 绑定单击事件，每点击一次label，则调用一次 callLater 方法，callLater 函数会执行一次自己的回调函数，在回调函数中修改 label  的透明度 alpha。

纯粹是为了演示用法，这个需求并不适合使用 callLater 函数，实现代码如下：

官网 demo：[https://layaair.ldc.layabox.com/demo2/?language=ch&category=2d&group=Timer&name=CallLater][https_layaair.ldc.layabox.com_demo2_language_ch_category_2d_group_Timer_name_CallLater]

## 延迟执行 ##

> /\*\*  
>  \* 定时执行一次。  
>  \* @param   delay   延迟时间(单位为毫秒)。  
>  \* @param   caller  执行域(this)。  
>  \* @param   method  定时器回调函数。  
>  \* @param   args    回调参数。  
>  \* @param   coverBefore 是否覆盖之前的延迟执行，默认为 true 。  
>  \*/  
> once(delay: number, caller: any, method: Function, args?: Array<any>, coverBefore?: boolean): void;

> /\*\*  
>  \* 定时执行一次(基于帧率)。  
>  \* @param   delay   延迟几帧(单位为帧)。  
>  \* @param   caller  执行域(this)。  
>  \* @param   method  定时器回调函数。  
>  \* @param   args    回调参数。  
>  \* @param   coverBefore 是否覆盖之前的延迟执行，默认为 true 。  
>  \*/  
> frameOnce(delay: number, caller: any, method: Function, args?: Array<any>, coverBefore?: boolean): void;

![20190107165445658.gif][]

实现代码如下：

官网 demo：[https://layaair.ldc.layabox.com/demo2/?language=ch&category=2d&group=Timer&name=DelayExcute][https_layaair.ldc.layabox.com_demo2_language_ch_category_2d_group_Timer_name_DelayExcute]

## 间隔循环 ##

> /\*\*  
>  \* 定时重复执行。  
>  \* @param   delay   间隔时间(单位毫秒)。  
>  \* @param   caller  执行域(this)。  
>  \* @param   method  定时器回调函数。  
>  \* @param   args    回调参数。  
>  \* @param   coverBefore 是否覆盖之前的延迟执行，默认为 true 。  
>  \* @param   jumpFrame 时钟是否跳帧。基于时间的循环回调，单位时间间隔内，如能执行多次回调，出于性能考虑，引擎默认只执行一次，设置jumpFrame=true后，则回调会连续执行多次  
>  \*/  
> loop(delay: number, caller: any, method: Function, args?: Array<any>, coverBefore?: boolean, jumpFrame?: boolean): void;

/\*\*  
 \* 定时重复执行(基于帧率)。  
 \* @param       delay   间隔几帧(单位为帧)。  
 \* @param       caller  执行域(this)。  
 \* @param       method  定时器回调函数。  
 \* @param       args    回调参数。  
 \* @param       coverBefore     是否覆盖之前的延迟执行，默认为 true 。  
 \*/  
frameLoop(delay: number, caller: any, method: Function, args?: Array<any>, coverBefore?: boolean): void;

![20190107171628663.gif][]

实现代码如下：

## 时钟暂停与恢复 ##

> /\*\*  
>  \* 暂停时钟————暂停所有 Timer  
>  \*/  
> pause(): void;  
> /\*\*  
>  \* 恢复时钟————恢复所有 Timer  
>  \*/  
> resume(): void;

![20190107173052778.gif][]

实现代码如下：

## 结束定时器 ##

> /\*\*  
>  \* 清理定时器。  
>  \* @param   caller 执行域(this)。——定时器与 clear 必须是同一个对象  
>  \* @param   method 定时器回调函数。——定时器回调函数的名称  
>  \*/  
> clear(caller: any, method: Function): void;

> /\*\*  
>  \* 清理对象身上的所有定时器。  
>  \* @param   caller 执行域(this)。——定时器与 clear 必须是同一个对象  
>  \*/  
> clearAll(caller: any): void;

对于在某个时刻需要清理/结束的定时器，在指定定时器与清理定时时，执行域都指定为 Laya.stage，而不再是 this。

![20190107174657619.gif][]

实现代码如下：

当一个对象的生命周期结束时，记得清除其内部的Timer。

# 优化策略 #

1、不要在 Timer 的循环里创建对象及复杂计算。

2、由于Timer的loop()与frameLoop()方法里会不断的循环执行，当创建对象及复杂计算时，会导致大量的性能消耗出现在循环里，因此尽可能不要在循环里创建对象及复杂计算。

[callLater]: https://layaair.ldc.layabox.com/api2/Chinese/index.html?category=Core&class=laya.utils.Timer#callLater%28%29
[20190107162135293.gif]: /images/20220330/79b54392a22049c7840741bc8ba8166b.png
[https_layaair.ldc.layabox.com_demo2_language_ch_category_2d_group_Timer_name_CallLater]: https://layaair.ldc.layabox.com/demo2/?language=ch&category=2d&group=Timer&name=CallLater
[20190107165445658.gif]: /images/20220330/2fae8e11d47e4531bb2c538c2e8cc19f.png
[https_layaair.ldc.layabox.com_demo2_language_ch_category_2d_group_Timer_name_DelayExcute]: https://layaair.ldc.layabox.com/demo2/?language=ch&category=2d&group=Timer&name=DelayExcute
[20190107171628663.gif]: /images/20220330/a22b0af7384948b484d0b0502d277f98.png
[20190107173052778.gif]: /images/20220330/b73ffab4ccd74b4b95a9b78557bca5c6.png
[20190107174657619.gif]: /images/20220330/3b4a75121d3a462494850aca38317b51.png