تضمين مشاهد قابلة للعنوان

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

تتيح العناصر القابلة للتوجيه للمطوّرين تحميل المحتوى بشكل ديناميكي في وقت التشغيل. يمكن أن يشمل ذلك المشاهد غير المتوفّرة في إعدادات الإصدار في Unity عند إنشاء ملف APK. قبل الإصدار 1.5.1 من Android Performance Tuner، لم يكن هذا الإصدار يتعرّف على هذه المشاهد، وبالتالي لم يكن من الممكن فحصها في Play Console.

المتطلبات

يجب استيفاء المتطلبات التالية لاستخدام مشاهد Addressables:

• الإصدار 1.5.1 أو إصدار أحدث من أداة Android Performance Tuner
• ‫Unity 2019.3 أو إصدار أحدث
• حزمة Addressables 1.19.4 أو إصدار أحدث

إضافة مَشاهد قابلة للعنونة

لجعل أداة Android Performance Tuner تتعرّف على مشاهد Addressables، اتّبِع الخطوات التالية:

1. عندما تكون مستعدًا لاختبار تطبيقك، انتقِل إلى Window > Android Performance Tuner > Setup وافتح علامة التبويب Addressables Settings.

   الشكل 1. نافذة "إعدادات العناصر القابلة للعنونة"

2. انقر على الزر تعديل المشاهد القابلة للعنونة.

بشكلٍ تلقائي، يتم تضمين جميع المشاهد الواردة في AddressableAssetSettingsDefaultObject في Android Performance Tuner. تعرض النافذة الآن قائمة بجميع المشاهد التي تم العثور عليها مع قيمتها المحفوظة في ملف proto.

الشكل 2: مشاهد Addressables المُدرَجة حسب أداة Android Performance Tuner

لتغيير "عنصر إعدادات المحتوى القابل للتوجيه" الذي يتم استرداد المشاهد منه، اتّبِع الخطوات التالية:

1. انتقِل إلى المجلد Assets/AndroidPerformanceTuner_gen/Runtime/Resources وافتح العنصر القابل للبرمجة SetupConfig في "نافذة الفحص".

2. أدرِج مسار "عنصر الإعدادات" المخصّص في الحقل مسار عنصر إعدادات Addressables، بما في ذلك اسم الملف.

ننصحك بتحديث مشاهد Addressables عندما يكون تخطيط المشاهد شبه نهائي لتجنُّب مشاكل التوافق مع الإصدارات القديمة.

لا تجمع أداة Android Performance Tuner البيانات إلا للمشاهد التي كانت مضمّنة في ملف APK الذي تم تحميله إلى Play Console.

إعادة ضبط مَشاهد Addressables

يمكنك إعادة ضبط مشاهد Addressables من خلال النقر على إعادة ضبط مشاهد Addressables في علامة التبويب إعدادات Addressables. ومع ذلك، يؤدي ذلك إلى عدم التوافق مع الإصدار المنشور حاليًا من التطبيق.

سيؤدي تعديل العنصر SetupConfig بشكل ديناميكي في التطبيق بدون نشر إصدار جديد إلى حدوث أخطاء في Play Console لأنّه لن يتم الاحتفاظ بعلاقات قيم المشهد.

ضبط مشاهد Addressables في التعليقات التوضيحية

إذا كنت تستخدم التعليقات التوضيحية التلقائية، يضبط Android Performance Tuner المشهد الصحيح تلقائيًا. إذا كنت تستخدم تعليقات توضيحية مخصّصة، استخدِم الدالة ConvertAddressableScenePathToAPTSceneIndex():

tuner.SetCurrentAnnotation(new Annotation
{
    Scene = (Scene) tuner.ConvertAddressableScenePathToAPTSceneIndex(scenePath),
    Difficulty = Difficulty.Medium
});