requestAnimationFrame API - 精确到亚毫秒

Ilmari Heikkinen

如果您一直在使用 requestAnimationFrame,您会很高兴看到绘制操作与屏幕刷新率同步,从而实现尽可能高保真的动画。此外,当用户切换到其他标签页时,您还可以为用户节省 CPU 风扇噪音和电池电量。

不过,API 的一部分即将发生变化。传递到回调函数中的时间戳将从典型的 Date.now() 类时间戳更改为自页面打开以来以浮点毫秒为单位的高分辨率测量值。如果您使用此值,则需要根据以下说明更新代码。

为清楚起见,我指的是以下内容:

// assuming requestAnimationFrame method has been normalized for all vendor prefixes..
requestAnimationFrame(function(timestamp){
    // the value of timestamp is changing
});

如果您使用的是此处提供的通用 requestAnimFrame 垫片,则不会使用时间戳值。你已摆脱嫌疑。:)

原因

为什么呢?rAF 可帮助您实现理想的 60 fps 帧速率,即每帧 16.7 毫秒。但以整数毫秒为单位进行测量意味着,对于我们想要观察和定位的所有内容,精度都是 1/16。

16 毫秒与 16 整数毫秒图表对比。

如上图所示,蓝色条表示您在绘制新帧(以 60fps 的速率)之前完成所有工作所需的最长时间。您可能需要执行 16 项以上的操作,但如果使用整数毫秒,您只能以这些非常大的增量进行调度和测量。这还不够。

高分辨率计时器通过提供更精确的数字解决了这个问题:

Date.now()         //  1337376068250
performance.now()  //  20303.427000007

高分辨率计时器目前在 Chrome 中以 window.performance.webkitNow() 的形式提供,此值通常等于传递到 rAF 回调的新参数值。随着规范在标准中进一步推进,该方法将去掉前缀,并通过 performance.now() 提供。

您还会注意到,上述两个值相差多个数量级。performance.now() 是自特定网页开始加载(具体而言,即 performance.navigationStart)以来经过的浮点毫秒数。

正在使用

出现的主要问题是使用此设计模式的动画库:

function MyAnimation(duration) {
    this.startTime = Date.now();
    this.duration = duration;
    requestAnimFrame(this.tick.bind(this));
}
MyAnimation.prototype.tick = function(time) {
    var now = Date.now();
    if (time > now) {
        this.dispatchEvent("ended");
        return;
    }
    ...
    requestAnimFrame(this.tick.bind(this));
}

只需进行简单的修改即可解决此问题:扩充 startTime 和 now 以使用 window.performance.now()。

this.startTime = window.performance.now ?
                    (performance.now() + performance.timing.navigationStart) :
                    Date.now();

这是一种相当简单的实现,它不使用带前缀的 now() 方法,并且还假设支持 Date.now(),而 IE8 中没有该方法。

功能检测

如果您不使用上述模式,而只是想确定您获得的回调值类型,则可以使用以下方法:

requestAnimationFrame(function(timestamp){

    if (timestamp < 1e12){
        // .. high resolution timer
    } else {
        // integer milliseconds since unix epoch
    }

    // ...

检查 if (timestamp < 1e12) 是一种快速的鸭子测试,可了解我们要处理的数字有多大。从技术上讲,这可能会导致假正例,但前提是网页连续打开 30 年。但我们无法测试它是否为浮点数(而不是向下取整为整数)。如果请求足够多的高分辨率计时器,您一定会得到整数值。

我们计划在 Chrome 21 中推出此项更改,因此,如果您已经在使用此回调参数,请务必更新您的代码!