requestAnimationFrame API – jetzt mit Sub-Millisekunden-Genauigkeit

Ilmari Heikkinen

Wenn Sie requestAnimationFrame verwendet haben, wurden Ihre Zeichnungen mit der Aktualisierungsrate des Bildschirms synchronisiert, was zu möglichst originalgetreuen Animationen geführt hat. Außerdem sparen Sie Ihren Nutzern CPU-Lüftergeräusche und Akkuleistung, wenn sie zu einem anderen Tab wechseln.

Ein Teil der API wird sich jedoch bald ändern. Der Zeitstempel, der an Ihre Callback-Funktion übergeben wird, ändert sich von einem typischen Date.now()-ähnlichen Zeitstempel zu einer hochauflösenden Messung von Gleitkomma-Millisekunden seit dem Öffnen der Seite. Wenn Sie diesen Wert verwenden, müssen Sie Ihren Code aktualisieren, wie unten erläutert.

Zur Verdeutlichung:

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

Wenn Sie den gängigen requestAnimFrame-Shim verwenden, der hier bereitgestellt wird, verwenden Sie den Zeitstempelwert nicht. Du bist aus dem Schneider. :)

Warum

Was ist der Grund dafür? Mit rAF können Sie die idealen 60 fps erreichen.60 fps entsprechen 16, 7 ms pro Frame. Wenn wir jedoch mit ganzzahligen Millisekunden messen, haben wir eine Genauigkeit von 1/16 für alles, was wir beobachten und anvisieren möchten.

Vergleich der Diagramme „16 ms“ und „16 ms (ganzzahlig)“.

Wie Sie oben sehen können, stellt der blaue Balken die maximale Zeit dar, die Sie für alle Ihre Arbeiten haben, bevor Sie einen neuen Frame (bei 60 fps) zeichnen. Sie tun wahrscheinlich mehr als 16 Dinge, aber mit ganzzahligen Millisekunden können Sie nur in diesen sehr groben Schritten planen und messen. Das ist nicht gut genug.

Der High Resolution Timer löst dieses Problem, indem er einen weitaus genaueren Wert liefert:

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

Der hochauflösende Timer ist derzeit in Chrome als window.performance.webkitNow() verfügbar. Dieser Wert entspricht im Allgemeinen dem neuen Argumentwert, der an den rAF-Callback übergeben wird. Sobald die Spezifikation weiterentwickelt wird, wird das Präfix entfernt und die Methode ist über performance.now() verfügbar.

Außerdem werden Sie feststellen, dass die beiden oben genannten Werte um viele Größenordnungen voneinander abweichen. performance.now() ist ein Messwert in Gleitkomma-Millisekunden seit dem Beginn des Ladens der jeweiligen Seite (genauer gesagt, seit performance.navigationStart).

Genutzt

Das Hauptproblem, das auftritt, sind Animationsbibliotheken, die dieses Designmuster verwenden:

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));
}

Das lässt sich ganz einfach beheben: Erweitern Sie startTime und now, um window.performance.now() zu verwenden.

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

Dies ist eine recht einfache Implementierung, bei der keine Methode mit dem Präfix now() verwendet wird. Außerdem wird davon ausgegangen, dass Date.now() unterstützt wird, was in IE8 nicht der Fall ist.

Feature-Erkennung

Wenn Sie das obige Muster nicht verwenden und nur feststellen möchten, welche Art von Callback-Wert Sie erhalten, können Sie diese Methode verwenden:

requestAnimationFrame(function(timestamp){

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

    // ...

Die Überprüfung von if (timestamp < 1e12) ist ein schneller Duck-Test, um zu sehen, wie groß die Zahl ist, mit der wir es zu tun haben. Technisch gesehen könnte es zu einem falsch positiven Ergebnis kommen, aber nur, wenn eine Webseite 30 Jahre lang ununterbrochen geöffnet ist. Wir können jedoch nicht testen, ob es sich um eine Gleitkommazahl handelt (und nicht um eine abgerundete Ganzzahl). Wenn Sie genügend Timer mit hoher Auflösung anfordern, erhalten Sie irgendwann ganzzahlige Werte.

Wir planen, diese Änderung in Chrome 21 einzuführen. Wenn Sie diesen Callback-Parameter also bereits verwenden, sollten Sie Ihren Code aktualisieren.