requestAnimationFrame API - اکنون با دقت زیر میلی‌ثانیه

Ilmari Heikkinen

اگر از requestAnimationFrame استفاده کرده‌اید، از دیدن همگام‌سازی رنگ‌هایتان با نرخ بازآوری صفحه‌نمایش لذت برده‌اید که منجر به ایجاد پویانمایی‌هایی با بالاترین کیفیت ممکن می‌شود. به‌علاوه، وقتی کاربران به برگه دیگری می‌روند، صدای فن CPU و مصرف باتری را برای آن‌ها کاهش می‌دهید.

بااین‌حال، بخشی از میانای برنامه‌سازی کاربردی به‌زودی تغییر خواهد کرد. «مُهر زمان» که به تابع بازخوانی شما ارسال می‌شود از مُهر زمان معمولی شبیه Date.now() به اندازه‌گیری با وضوح بالا از میلی‌ثانیه‌های ممیز شناور از زمان باز شدن صفحه تغییر می‌کند. اگر از این مقدار استفاده می‌کنید، باید کدتان را به‌روز کنید، براساس توضیح زیر.

برای اینکه واضح باشد، منظورم این است:

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

اگر از requestAnimFrame shim ارائه‌شده در اینجا استفاده می‌کنید، از مقدار مُهر زمان استفاده نمی‌کنید. از مخمصه نجات پیدا کردید. :)

چرا

چرا؟ ‫rAF به شما کمک می‌کند به نهایت ۶۰ فریم در ثانیه که ایده‌آل است برسید، و ۶۰ فریم در ثانیه به ۱۶٫۷ میلی‌ثانیه در هر فریم ترجمه می‌شود. اما اندازه‌گیری با عدد صحیح میلی‌ثانیه به این معنی است که ما برای هر چیزی که می‌خواهیم مشاهده و هدف‌یابی کنیم، دقت ۱/۱۶ داریم.

مقایسه نمودار ۱۶ میلی‌ثانیه دربرابر ۱۶ میلی‌ثانیه عدد صحیح.

همان‌طور که در بالا می‌بینید، نوار آبی نشان‌دهنده حداکثر زمانی است که برای انجام همه کارهایتان قبل‌از رنگ‌آمیزی قاب جدید (با سرعت ۶۰ فریم در ثانیه) دارید. احتمالاً بیش‌از ۱۶ کار انجام می‌دهید، اما با میلی‌ثانیه‌های عدد صحیح فقط می‌توانید در آن افزایش‌های بسیار بزرگ زمان‌بندی و اندازه‌گیری کنید. این کافی نیست.

زمان‌سنج با وضوح بالا این مشکل را با ارائه رقمی بسیار دقیق‌تر حل می‌کند:

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

زمان‌سنج با وضوح بالا درحال‌حاضر در Chrome به‌عنوان window.performance.webkitNow() دردسترس است و این مقدار معمولاً با مقدار آرگومان جدیدی که به فراخوان rAF ارسال می‌شود برابر است. وقتی مشخصات بیشتر در استانداردها پیشرفت کند، این روش پیشوند را حذف می‌کند و ازطریق performance.now() دردسترس خواهد بود.

You'll also notice the two above values are many orders of magnitude different. ‫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));
}

An edit to fix this is pretty easy... augment the startTime and now to use 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) یک آزمون سریع است تا ببینیم با چه عدد بزرگی سروکار داریم. Technically it could false positive but only if a webpage is open continuously for 30 years. اما نمی‌توانیم آزمایش کنیم که آیا عدد ممیز شناور است (به‌جای اینکه به عدد صحیح گرد شده باشد). اگر به‌اندازه کافی زمان‌سنج با وضوح بالا درخواست کنید، درنهایت مقادیر عدد صحیح دریافت خواهید کرد.

قصد داریم این تغییر را در Chrome 21 اعمال کنیم، بنابراین اگر درحال‌حاضر از این پارامتر فراخوانی استفاده می‌کنید، حتماً کدتان را به‌روز کنید!