API requestAnimationFrame, ora con una precisione inferiore al millisecondo

Ilmari Heikkinen

Se hai utilizzato requestAnimationFrame, hai potuto apprezzare la sincronizzazione dei paint con la frequenza di aggiornamento dello schermo, ottenendo animazioni con la massima fedeltà possibile. Inoltre, risparmi agli utenti il rumore della ventola della CPU e il consumo della batteria quando passano a un'altra scheda.

Tuttavia, è prevista una modifica a una parte dell'API. Il timestamp passato alla funzione di callback sta cambiando da un tipico timestamp simile a Date.now() a una misurazione ad alta risoluzione di millisecondi in virgola mobile dall'apertura della pagina. Se utilizzi questo valore, dovrai aggiornare il codice in base alla spiegazione riportata di seguito.

Per maggiore chiarezza, ecco di cosa sto parlando:

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

Se utilizzi lo shim requestAnimFrame comune fornito qui, non utilizzi il valore del timestamp. Sei fuori dai guai. :)

Perché

Perché? rAF ti aiuta a ottenere i 60 fps ideali, che si traducono in 16,7 ms per frame. Tuttavia, la misurazione con millisecondi interi significa che abbiamo una precisione di 1/16 per tutto ciò che vogliamo osservare e scegliere come target.

Confronto tra i grafici di 16 ms e 16 ms interi.

Come puoi vedere sopra, la barra blu rappresenta la quantità massima di tempo a tua disposizione per svolgere tutto il lavoro prima di disegnare un nuovo frame (a 60 f/s). Probabilmente stai facendo più di 16 cose, ma con i millisecondi interi hai solo la possibilità di pianificare e misurare in incrementi molto ampi. Non è sufficiente.

Il timer ad alta risoluzione risolve questo problema fornendo un dato molto più preciso:

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

Il timer ad alta risoluzione è attualmente disponibile in Chrome come window.performance.webkitNow() e questo valore è generalmente uguale al nuovo valore dell'argomento passato al callback rAF. Una volta che la specifica progredisce ulteriormente attraverso gli standard, il metodo perderà il prefisso e sarà disponibile tramite performance.now().

Noterai anche che i due valori precedenti sono diversi di molti ordini di grandezza. performance.now() è una misurazione dei millisecondi in virgola mobile dall'inizio del caricamento della pagina specifica (per l'esattezza, performance.navigationStart).

In uso

Il problema principale che si presenta sono le librerie di animazione che utilizzano questo pattern di progettazione:

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

Una modifica per risolvere il problema è piuttosto semplice: migliora startTime e now per utilizzare window.performance.now().

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

Si tratta di un'implementazione piuttosto semplice, che non utilizza un metodo now() con prefisso e presuppone anche il supporto di Date.now(), che non è presente in IE8.

Rilevamento delle caratteristiche

Se non utilizzi il pattern riportato sopra e vuoi solo identificare il tipo di valore di callback che ricevi, puoi utilizzare questa tecnica:

requestAnimationFrame(function(timestamp){

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

    // ...

Il controllo di if (timestamp < 1e12) è un rapido test per capire l'entità del numero con cui abbiamo a che fare. Tecnicamente potrebbe verificarsi un falso positivo, ma solo se una pagina web rimane aperta ininterrottamente per 30 anni. Tuttavia, non siamo in grado di verificare se si tratta di un numero in virgola mobile (anziché di un numero intero arrotondato per difetto). Se richiedi un numero sufficiente di timer ad alta risoluzione, a un certo punto otterrai inevitabilmente valori interi.

Abbiamo in programma di implementare questa modifica in Chrome 21, quindi se stai già utilizzando questo parametro di callback, assicurati di aggiornare il codice.