הכללת סצנות שניתנות לכתובת

בדף הזה מוסבר איך להגדיר את Android Performance Tuner כך שיכלול סצנות של Addressables ב-Unity.

Addressables מאפשרים למפתחים לטעון תוכן באופן דינמי בזמן הריצה. זה יכול לכלול סצנות שלא מופיעות בהגדרות הבנייה של Unity כשקובץ ה-APK נבנה. לפני Android Performance Tuner 1.5.1, הסצנות האלה לא זוהו על ידי Android Performance Tuner ולא ניתן היה לבדוק אותן ב-Play Console.

דרישות

כדי להשתמש בתמיכה בסצנות Addressables, צריך לעמוד בדרישות הבאות:

• ‫Android Performance Tuner בגרסה 1.5.1 ואילך
• ‫Unity 2019.3 ואילך
• חבילת Addressables בגרסה 1.19.4 ואילך

הוספת סצנות של Addressables

כדי ש-Android Performance Tuner יזהה את סצנות Addressables, צריך לבצע את הפעולות הבאות:

1. כשמוכנים לבדוק את האפליקציה, עוברים אל Window > Android Performance Tuner > Setup ופותחים את הכרטיסייה Addressables Settings.

   איור 1. חלון ההגדרות של כתובות שאפשר להציג בהן מודעות.

2. לוחצים על הלחצן עדכון סצנות עם כתובות.

כברירת מחדל, כל הסצנות שמופיעות ב-AddressableAssetSettingsDefaultObject נכללות ב-Android Performance Tuner. בחלון מוצגת רשימה של כל הסצנות שנמצאו, יחד עם הערך שלהן כפי שנשמר בקובץ הפרוטו.

איור 2. סצנות Addressables שמופיעות ב-Android Performance Tuner.

כדי לשנות את אובייקט ההגדרות של המודעות שניתן לטרגט, שממנו נשלפים הסצנות:

1. עוברים לתיקייה Assets/AndroidPerformanceTuner_gen/Runtime/Resources ופותחים את אובייקט הסקריפט SetupConfig בכלי Inspector.

2. מזינים את הנתיב לאובייקט ההגדרות המותאם אישית בשדה Addressables Settings Object Path (נתיב לאובייקט ההגדרות של Addressables), כולל שם הקובץ.

כדי להימנע מבעיות בתאימות לאחור, מומלץ לעדכן את סצנות Addressables כשהפריסה של הסצנות היא חצי סופית.

הכלי Android Performance Tuner אוסף נתונים רק לגבי סצנות שהיו בקובץ ה-APK שהועלה ל-Play Console.

איפוס של סצנות שניתן להוסיף להן כתובות

כדי לאפס את סצנות ה-Addressables, לוחצים על Reset Addressables Scenes (איפוס סצנות ה-Addressables) בכרטיסייה Addressables Settings (הגדרות ה-Addressables). עם זאת, זה פוגע בתאימות לגרסה שפורסמה כרגע של האפליקציה.

עדכון דינמי של אובייקט SetupConfig באפליקציה בלי לפרסם גרסה חדשה יגרום לשגיאות ב-Play Console, כי לא יישמרו יחסי הערכים של הסצנה.

הגדרת סצנות שניתן להוסיף להן כתובות בהערות

אם אתם משתמשים בהערות ברירת מחדל, הכלי Android Performance Tuner מגדיר אוטומטית את הסצנה הנכונה. אם אתם משתמשים בהערות בהתאמה אישית, צריך להתקשר אל ConvertAddressableScenePathToAPTSceneIndex():

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