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

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

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

الشروط

يشمل دعم مشاهد العناوين الرئيسية المتطلبات التالية:

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

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

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

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

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

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

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

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

لتغيير كائن الإعدادات القابل للعناوين الذي يتم سحب المشاهد منه:

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

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

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

لا تجمع أداة 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
});