يوضّح هذا الدليل كيفية استخدام مكوّن إضافي من Unity لتسجيل بيانات وقت عرض اللقطة وتحميلها من Unity 2017.4 أو إصدار أحدث.
بالنسبة إلى محرّكات الألعاب التي تستخدم لغة C أو C++ ، راجِع دليل محرّكات الألعاب الأصلية.
معلومات أساسية
من العناصر الرئيسية في تجربة اللعبة عرض الأداء. يكون أداء العرض نتيجة للمدخلين التاليين:
- عدد اللقطات في الثانية: عدد المرات التي يتم فيها رسم إطار
- إعدادات الجودة الرسومية: مستوى دقّة عرض الإطار، بما في ذلك دقّة المحاكاة والرسومات
في الألعاب، يتم تعريف أداء العرض الجيد على النحو التالي:
- تحقيق عدد إطارات ثابت وثابت (أي النسبة المئوية للقطات في الثانية التي يتم عرضها بالمعدّل المطلوب)
- عرض الإطارات بأعلى معدل تكرار ممكن مع الحفاظ على الثبات، أي بمعدّل 30 أو 60 لقطة في الثانية اعتمادًا على نوع اللعبة
- يتم زيادة مستوى التفاصيل للمستخدم إلى أقصى حدّ وفقًا لحجم الشاشة وكثافتها، مع تحقيق عدد لقطات ثابت ومطلوب في الثانية.
تحد مكتبة سرعة عرض الإطارات في Android من العديد من الاختلافات في أوقات عرض اللقطات، ما يوفّر لعدد لقطات ثابتًا في الألعاب. ويعود التباين المتبقي في أوقات عرض اللقطات إلى مستوى التفاصيل المعروضة خلال مشاهد معيّنة في أسلوب اللعب والإمكانات الرسومية للجهاز. باستخدام Android Performance Tuner، يمكنك تحديد الأوقات أثناء اللعب عندما يكون وقت عرض اللقطة أبطأ أو أسرع من القيمة المستهدَفة، وربط هذه المشاكل وفرص التحسين من أجل:
- إعدادات جودة معيّنة
- مَشاهد محدَّدة في لعبتك
- طُرز أجهزة أو مواصفات أجهزة معيّنة
تسجيل البيانات وتحميلها
تعتمد مكتبة ضبط "الشوكة" على إحدى دوال التجزئة التي يُطلق عليها اسم كل إطار من مكتبة سرعة إطار Android (أو من خلال محرّك Unity للإصدارات القديمة من Unity التي لا تتوفّر فيها مكتبة Frame Pacing Library). وداخل المكتبة، يتم تجميع معلومات المؤشرات هذه في مدرّجات تكرارية يتم تحميلها بعد ذلك بشكل دوري إلى Google Play من خلال نقطة نهاية HTTP. ويتم تسجيل كل علامة على أنّها مرتبطة بمفتاح أداة وتعليق توضيحي. يمكنك تحديد التعليقات التوضيحية باستخدام المكوِّن الإضافي Unity.
مفاتيح الآلات الموسيقية
يشير مفتاح الأداة إلى المكان الذي تأتي منه علامة التجزئة في الإطار وهو عدد صحيح يجب تمريره إلى كل استدعاء دالة التجزئة. يتم ذلك تلقائيًا بواسطة المكون الإضافي Unity. إذا كان خيار "معدل سرعة اللقطات المحسّن" مفعّلاً في إعدادات Unity (المتوفّرة في الإصدار 2019.3.14 أو الإصدارات الأحدث من Unity)، ستستخدم أداة Android Performance Tuner معلومات من مكتبة Android Frame Pacing لتسجيل المقاييس المحسَّنة.
التعليقات التوضيحية
تقدّم التعليقات التوضيحية معلومات سياقية حول ما تفعله لعبتك عند تسجيل علامة. على سبيل المثال، يمكن أن يحدد التعليق التوضيحي أيًا مما يلي:
- مستوى اللعبة الحالي
- جارٍ تحميل مشهد معيّن
- يظهر "وحش كبير" على الشاشة
- أي معلومات أخرى ذات صلة بحالة اللعبة
يتم تحديد التعليقات التوضيحية في مربع حوار يوفره المكون الإضافي Unity.
داخليًا، تستخدم مكتبة Tuning Fork تنسيق المخزن المؤقت للبروتوكولات من Google لتخزين التعليقات التوضيحية ومعلمات الدقة. هذا بروتوكول محدد جيدًا ومتعدد اللغات للبيانات المنظَّمة القابلة للتوسُّع. لمزيد من المعلومات، اطّلِع على مستندات الموارد الاحتياطية للبروتوكول.
مَعلَمات الدقّة
تؤثر مَعلَمات الدقّة في أداء لعبتك ودقتها التصويرية، مثل مستوى تفاصيل التداخل ودقّة الصورة وطريقة تنعيم الحواف. مثل التعليقات التوضيحية، يتم تحديد معلمات الدقة في مربع حوار يوفره المكون الإضافي Unity.
النفقات العامة للذاكرة ووحدة المعالجة المركزية (CPU)
يتم تخصيص كل الذاكرة التي تستخدمها مكتبة "الشوكة الرنانة" عند التهيئة لتجنب المفاجآت أثناء اللعب. يعتمد حجم البيانات على عدد مفاتيح الأداة وعدد التعليقات التوضيحية المحتملة وعدد المجموعات في كل مدرج تكراري؛ وهو مضاعف لجميع هذه الأوقات الأربعة البايت لكل مجموعة. هناك أيضًا نسختان من جميع المدرجات التكرارية للسماح بالإرسال بطريقة التخزين المؤقت المزدوج.
يتم إرسال المسودة في سلسلة محادثات منفصلة، ولا يتم حظر طلبات تبادل المعلومات. إذا لم يتوفّر اتصال تحميل، ستتم إضافة المحتوى المُرسل إلى قائمة الانتظار لتحميله لاحقًا.
هناك القليل من أعباء المعالجة التي تتطلّب استدعاء دالة التجزئة، فهي تحتسب فقط الفهرس في مصفوفة مجموعات المدرّج التكراري وتزيد من عدد الأعداد الصحيحة.
طلبات الويب
ترسل المكتبة نوعين من الطلبات إلى نقطة نهاية الخادم:
- طلب
generateTuningParameters
عند الإعداد - بشكل دوري أثناء اللعب، هناك طلب من
uploadTelemetry
لإرسال البيانات إلى الخادم
اللاعبون بلا إنترنت
وإذا لم يكن هناك اتصال متاح عند التهيئة، تتم إعادة محاولة الطلب عدة مرات مع زيادة وقت التراجع. وإذا لم يتوفّر اتصال عند التحميل، يتم تخزين المحتوى مؤقتًا. يتم تخزين عمليات التحميل كملفات في مساحة تخزين مؤقتة.
المتطلبات الأساسية
لاستخدام المكوّن الإضافي في لعبتك، استخدِم إصدارًا متوافقًا من Unity:
- الإصدار 2017.4 من نظام التشغيل Unity أو إصدار أحدث والإصدار 4.6 من.NET
- لاستخدام ملفات توسيع APK، يجب توفّر Unity 2018.2
- لتحسين وتيرة عرض اللقطات وقياسات وحدة معالجة الرسومات، يجب توفّر إصدار Unity 2019.3.14 أو إصدار أحدث
- للحصول على دعم مشاهد ميزة Addressables، يجب توفّر الإصدار Unity 2019.3 أو إصدار أحدث وحزمة Addressables 1.19.4 أو إصدار أحدث.
دمج أداة Android Performance Tuner في Unity
للحصول على معلومات حول دمج أداة Android Performance Tuner في Unity، يمكنك الاطّلاع على مقالة تفعيل واجهة برمجة التطبيقات.