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

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

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

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

يجب استيفاء المتطلبات التالية لدعم مشاهد المحتوى الذي يمكن عرضه:

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

إضافة مشاهد عناصر قابلة للعناوين

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

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

   الشكل 1. نافذة إعدادات العناوين المتاحة.

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

يتم تلقائيًا تضمين كل المشاهد المضمّنة في AddressableAssetSettingsDefaultObject في Android Performance Tuner. تعرض النافذة الآن قائمة بجميع المشاهد التي تم العثور عليها إلى جانب قيمتها كما تم حفظها في ملف Proto.

الشكل 2. المشاهد القابلة للعنوان مدرَجة من أداة Android Performance Tuner

لتغيير عنصر إعدادات Addressable الذي يتم سحب المشاهد منه:

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

2. أدخِل المسار إلى كائن الإعدادات المخصّص في حقل مسار عنصر إعدادات العناوين المطبَّقة، بما في ذلك اسم الملف.

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

لا تجمع أداة Android Performance Tuner سوى بيانات المَشاهد التي كانت متوفّرة في ملف .AP الذي تم تحميله على Play Console.

إعادة ضبط مشاهد العناصر القابلة للعنوان

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

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

ضبط مَشاهد "غير قابلة للعنوان" في التعليقات التوضيحية

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

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