# 定时器([name])

此类是 [page:Clock] 的替代品，具有不同的 API 设计和行为。目标是避免随着时间的推移 [page:Clock] 中变得明显的概念缺陷。

- [name] 具有 [page:.update]() 方法，用于更新其内部状态。这使得可以在模拟步骤中多次调用 [page:.getDelta]() 和 [page:.getElapsed]() 而不会得到不同的值。
- 该类使用页面可见性 API（Page Visibility API），以避免在应用程序处于非活动状态（例如切换标签或浏览器隐藏）时出现大的时间差值。

## 引入

[name] 是一个附加组件，必须显式导入。请参阅 [link:#manual/introduction/Installation Installation / Addons].

`import { Timer } from 'three/addons/misc/Timer.js';`

## 代码示例

`const timer = new Timer(); function animate( timestamp ) { requestAnimationFrame( animate ); // timestamp is optional timer.update( timestamp ); const delta = timer.getDelta(); // do something with delta renderer.render( scene, camera ); }`

## 例子

[example:webgl_morphtargets_sphere WebGL / morphtargets / sphere]

## 构造函数

### Timer()

## 方法

### [method:Number getDelta]()

返回以秒为单位的时间增量。

### [method:Number getElapsed]()

返回经过的时间（以秒为单位）。

### [method:this setTimescale]( [param:Number timescale] )

设置一个时间刻度，缩放 [page:.update]() 中的时间增量。

### [method:this reset]()

重置当前模拟步骤的时间计算。

### [method:this dispose]()

可用于释放所有内部资源。通常在不再需要计时器实例时调用。

### [method:this update]( [param:Number timestamp] )

timestamp -- （可选）当前时间（以毫秒为单位）。可以从 [link:https://developer.mozilla.org/en-US/docs/Web/API/window/requestAnimationFrame requestAnimationFrame] 回调参数中获取 。如果未提供，当前时间将由 [link:https://developer.mozilla.org/en-US/docs/Web/API/Performance/now performance.now] 确定。
更新定时器的内部状态。该方法应该在每个模拟步骤以及对计时器执行查询之前调用一次（例如通过 [page:.getDelta]()）。

## 源代码

[link:https://github.com/mrdoob/three.js/blob/master/examples/jsm/misc/Timer.js examples/jsm/misc/Timer.js]