دمج المكوّن الإضافي

توضّح هذه الصفحة كيفية تنزيل المكوّن الإضافي Unity واستيراده وضبطه لأداة Android Performance Tuner.

المتطلبات

لاستخدام المكوّن الإضافي في لعبتك، استخدِم إصدارًا متوافقًا من Unity:

  • الإصدار 2017.4 من Unity أو إصدار أحدث والإصدار 4.6 من ‎.NET
  • لاستخدام ملفات البيانات الموسّعة لحزمة APK، يجب توفُّر الإصدار Unity 2018.2
  • لتحسين قياسات معدّل عرض اللقطات ووحدة معالجة الرسومات، يجب استخدام الإصدار 2019.3.14 من Unity أو إصدار أحدث
  • لإتاحة مشاهد Addressables، يجب استخدام الإصدار 2019.3 من Unity أو إصدار أحدث والإصدار 1.19.4 من حزمة Addressables أو إصدار أحدث.

تنزيل المكوّن الإضافي

نزِّل المكوّن الإضافي من مستودع GitHub. اختَر ملف .unitypackage الذي تم تنزيله.

استيراد المكوّن الإضافي

قبل استيراد المكوّن الإضافي، تأكَّد من أنّ مشروعك يستخدم الإصدار 4 .6 من ‎.NET. ينطبق ذلك على الإصدار 2018.4 من Unity والإصدارات الأقدم (تحتوي الإصدارات الأحدث من Unity على الإصدار 4 .6 من ‎.NET فقط).

  1. اختَر File (ملف) > Build Settings (إعدادات الإصدار). تأكَّد من اختيار Android كنظام أساسي حالي.
  2. انقر على الزر إعدادات المشغّل.
  3. ضمن إعدادات أخرى (Other Settings)، ابحث عن إصدار وقت تشغيل النصوص البرمجية (Scripting Runtime Version) واختَر NET 4.6..

يتم توفير المكوّن الإضافي كحزمة Unity يمكنك استيرادها في مشروعك. انقر على مواد العرض > استيراد حزمة > حزمة مخصّصة واختَر ملف .unitypackage الذي نزّلته.

الإصدار 1.5.1 أو إصدار أحدث من أداة Android Performance Tuner مع الإصدار Unity 2017

يتطلّب استخدام الإصدار 1.5.1 أو إصدار أحدث من أداة Android Performance Tuner مع Unity 2017 اتّباع الخطوات الإضافية التالية عند استيراد المكوّن الإضافي:

  1. انتقِل إلى المجلد Assets/AndroidPerformanceTuner/Editor.
  2. انقر على ملف Google.Android.PerformanceTuner.Editor لفتحه في Inspector.
  3. انقر على مرجع التجميع المفقود، ثم انقر على - لإزالته.
  4. انقر على الزر تطبيق.

    نافذة Unity Inspector لـ Google.Android.PerformanceTuner.Editor تعرض مرجع تجميع مفقودًا
    الشكل 1. مرجع التجميع غير متوفّر.
  5. انتقِل إلى المجلد Assets/AndroidPerformanceTuner/Runtime.

  6. انقر على ملف Google.Android.PerformanceTuner لفتحه في "المفتّش" (Inspector).

  7. كرِّر الخطوة 3 لإزالة مرجعَي التجميع المفقودَين.

  8. أعِد تشغيل Unity.

  9. انتقِل إلى Window > AndroidPerformanceTuner > Setup وتأكَّد من عدم ظهور أي أخطاء.

إعادة استيراد المكوّن الإضافي بعد حذفه

في حال إعادة استيراد المكوّن الإضافي بعد إزالته من المشروع، يجب أولاً إزالة ANDROID_PERFORMANCE_TUNER_UTILITIES من إعدادات المشغّل > رموز تعريف النصوص البرمجية.

ضبط المكوّن الإضافي

لضبط المكوّن الإضافي، اتّبِع الخطوات التالية:

  1. بالنسبة إلى الإصدار 2019.3.14 من Unity أو الإصدارات الأحدث:

    • فعِّل مكتبة Android Frame Pacing. ستستخدم أداة Android Performance Tuner هذه المكتبة لقياس أداء لعبتك، بما في ذلك مقاييس أكثر تفصيلاً من تلك التي تقدّمها Unity وحدها.

      اختَر ملف > إعدادات الإصدار وانقر على زر إعدادات المشغّل. ضِمن الدقة والعرض (Resolution and Presentation)، ضَع علامة في المربّع بجانب تحسين معدّل عرض اللقطات (Optimized Frame Pacing).

    • مزامنة عرض الإطارات مع الفراغات العمودية

      من "إعدادات المشغّل" (Player Settings)، اختَر علامة التبويب الجودة (Quality) وابحث عن قائمة عدد المزامنة العمودية (VSync Count). استخدِم أي خيار (باستثناء عدم المزامنة). تتيح الخيارات الأخرى غير عدم المزامنة إجراء قياسات أكثر دقة مع مكتبة Android Frame Pacing.

  2. (بالنسبة إلى إصدارات Unity قبل 2019) اضبط نظام التصميم على Gradle. انقر على File (ملف) > Build Settings (إعدادات الإصدار). ابحث عن نظام التصميم (Build System) واختَر Gradle.

  3. أضِف إمكانية الوصول إلى الإنترنت. ضمن إعدادات أخرى، ابحث عن إمكانية الوصول إلى الإنترنت واختَر مطلوب.

  4. أدخِل مفتاح واجهة برمجة التطبيقات. بعد تثبيت المكوّن الإضافي، يمكنك الدخول إليه من قائمة Window > Android Performance Tuner > Setup. في مربّع الحوار هذا، اختَر علامة التبويب الإعدادات وأدخِل مفتاح واجهة برمجة التطبيقات من مشروعك على Google Cloud في حقل مفتاح واجهة برمجة التطبيقات.

    علامة التبويب "الإعدادات" في المكوّن الإضافي لأداة Android Performance Tuner في Unity، والتي تعرض حقل مفتاح واجهة برمجة التطبيقات
    الشكل 2 علامة التبويب "الإعدادات" في المكوّن الإضافي