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 shim を使用している場合は、タイムスタンプ値を使用していません。もう大丈夫。:)

理由

その理由は、rAF は、理想的な 60 fps を実現するのに役立ちます。60 fps は、1 フレームあたり 16.7 ミリ秒に相当します。しかし、ミリ秒単位の整数で測定すると、観察対象やターゲットの精度は 1/16 になります。

16 ミリ秒と 16 整数ミリ秒のグラフの比較。

上の図に示すように、青色のバーは、新しいフレームをペイントする(60 fps で)前にすべての作業を行う必要がある最大時間を表しています。おそらく 16 個以上の処理を行っていると思いますが、ミリ秒単位の整数では、非常に大まかな単位でしかスケジュール設定や測定ができません。これでは不十分です。

高解像度タイマーは、より正確な数値を提供することで、この問題を解決します。

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

高解像度タイマーは現在、Chrome で window.performance.webkitNow() として利用可能であり、この値は通常、rAF コールバックに渡される新しい引数値と等しくなります。仕様が標準化されると、メソッドから接頭辞が削除され、performance.now() を介して利用できるようになります。

また、上記の 2 つの値は桁数が大きく異なります。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 でリリースされる予定です。このコールバック パラメータをすでに利用している場合は、コードを更新してください。