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

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

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

المتطلبات

يتطلّب دعم مشاهد "عنوان URL" المتطلبات التالية:

  • الإصدار 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 Settings الذي يتم سحب المشاهد منه:

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

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

ننصحك بتعديل مشاهد "عناوين معنونة" عندما يكون تنسيق المَشاهد نصف النهائية لتجنب مشكلات التوافق مع الأنظمة القديمة.

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

جارٍ إعادة ضبط مَشاهد عناوين URL

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

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

تعيين مشاهد عناوين URL في التعليقات التوضيحية

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

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