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

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

المتطلبات الأساسية

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

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

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

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

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

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

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

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

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

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

1. انتقِل إلى المجلد Assets/Android PerformanceTuner/Editor.
2. انقر على الملف Google.Android.PerformanceTuner.Editor لفتحه في أداة Inspector.
3. انقر على مرجع التجميع غير المتوفّر ثم انقر على - لإزالته.

4. انقر على الزر تطبيق.

   الشكل 1. مرجع التجميع غير متوفّر.

5. انتقِل إلى المجلد Assets/Android PerformanceTuner/Runtime.

6. انقر على الملف Google.Android.performanceTuner لفتحه في أداة الفحص.

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

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

9. انتقِل إلى نافذة > Android PerformanceTuner > الإعداد وتأكَّد من عدم ظهور أي أخطاء.

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

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

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

لتهيئة المكون الإضافي، قم بما يلي:

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

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

     اختَر ملف > إعدادات الإصدار وانقر على زر إعدادات اللاعب. ضمن درجة الدقة والعرض التقديمي، حدِّد مربّع الاختيار تحسين سرعة اللقطات.

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

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

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

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

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

   الشكل 2. علامة التبويب "الإعدادات" في المكوِّن الإضافي