شامل صحنه های Addressables

این صفحه نحوه پیکربندی Android Performance Tuner را برای گنجاندن صحنه‌های Addressables در Unity توضیح می‌دهد.

Addressable ها به توسعه دهندگان این امکان را می دهند که به صورت پویا محتوا را در زمان اجرا بارگذاری کنند. این می تواند شامل صحنه هایی باشد که در تنظیمات ساخت Unity در هنگام ساخت apk وجود ندارند. قبل از Android Performance Tuner 1.5.1، آن صحنه ها توسط Android Performance Tuner شناسایی نمی شدند و نمی توانستند در کنسول Play بررسی شوند.

الزامات

پشتیبانی از صحنه های Addressable دارای شرایط زیر است:

• Android Performance Tuner 1.5.1 یا بالاتر
• یونیتی 2019.3 یا بالاتر
• بسته آدرس‌پذیر 1.19.4 یا بالاتر

افزودن صحنه های Addressables

برای اینکه Android Performance Tuner صحنه‌های Addressables شما را تشخیص دهد، موارد زیر را انجام دهید:

1. هنگامی که برای آزمایش برنامه خود آماده شدید، به Window > Android Performance Tuner > Setup بروید و تب Addressables Settings را باز کنید.

   شکل 1. پنجره تنظیمات Addressables.

2. روی دکمه Update Addressables Scenes کلیک کنید.

به طور پیش فرض، تمام صحنه های موجود در AddressableAssetSettingsDefaultObject در Android Performance Tuner گنجانده شده است. اکنون پنجره فهرستی از تمام صحنه هایی که پیدا شده اند همراه با مقدار ذخیره شده در فایل پروتو نمایش می دهد.

شکل 2. صحنه های آدرس پذیر لیست شده توسط Android Performance Tuner.

برای تغییر شیء Addressable Settings که صحنه ها از آن کشیده می شوند:

1. به پوشه Assets/AndroidPerformanceTuner_gen/Runtime/Resources بروید و شیء قابل اسکریپت SetupConfig را در Inspector باز کنید.

2. مسیر شی تنظیمات سفارشی خود را در قسمت Addressables Settings Object Path وارد کنید، از جمله نام فایل.

توصیه می کنیم زمانی که طرح صحنه های شما نیمه نهایی است، صحنه های Addressables را به روز کنید تا از مشکلات سازگاری با عقب جلوگیری کنید.

Android Performance Tuner فقط داده‌های صحنه‌هایی را جمع‌آوری می‌کند که در فایل apk. که در Play Console آپلود شده بود وجود داشت.

بازنشانی صحنه های Addressables

با کلیک بر روی Reset Addressables Scenes در تب Addressables Settings می توانید صحنه های Addressables خود را بازنشانی کنید. با این حال، این امر سازگاری با نسخه منتشر شده فعلی برنامه را از بین می برد.

به‌روزرسانی پویا شی SetupConfig در برنامه بدون انتشار نسخه جدید، منجر به خطا در کنسول Play می‌شود زیرا روابط صحنه-مقدار حفظ نمی‌شود.

تنظیم صحنه های Addressables در حاشیه نویسی

اگر از حاشیه نویسی های پیش فرض استفاده می کنید، Android Performance Tuner به طور خودکار صحنه صحیح را تنظیم می کند. اگر از حاشیه نویسی سفارشی استفاده می کنید، با ConvertAddressableScenePathToAPTSceneIndex() تماس بگیرید:

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