הגדרת פרויקט ב-Unreal Engine

במדריך הזה מפורטות גרסאות המנוע המומלצות, ערכות ה-SDK הנדרשות והגדרות הפרויקט ב-Android כשמפתחים אפליקציית Unreal Engine ל-Android XR.

דרישות מוקדמות

כדי להגדיר את Unreal Engine לפיתוח Android XR, צריך להתקין את האפליקציות והכלים הבאים:

1. מורידים ומתקינים את Epic Games Launcher.

   1. מ-Epic Games Launcher, מתקינים את גרסה 5.6.1 (או גרסה מתקדמת יותר) של Unreal Engine.

2. מגדירים את המערכת כדי ליצור קוד C++‎ (לדוגמה, באמצעות Visual Studio 2022‎ ל-Windows או Xcode ל-macOS). מידע נוסף זמין במאמר של Epic בנושא הגדרת סביבת פיתוח בשפת C++‎.

3. מתקינים את NET 8.0 SDK.

4. מתקינים את Android Studio (Quail 4‏ | 2026.1.4 ומעלה).

התקנת תמיכה ב-build של Android

מכיוון ש-Android XR מסתמך על גרסאות ספציפיות של SDK, צריך להתקין את כלי הבנייה הנכונים של Android לצד Unreal Engine.

1. פותחים את Epic Games Launcher.

2. לוחצים על החץ של התפריט הנפתח לצד הגרסה המותקנת של המנוע (לחצן ההפעלה) ולוחצים על אפשרויות.

   1. גוללים למטה לאפשרויות ההתקנה, בוחרים באפשרות Android ולוחצים על Apply.
   2. אם מופיעה בקשה, מאשרים למנוע לרשום את כל סיומות הקבצים שהוא צריך.

3. מתקינים את Java JDK 17.

4. ב-Android Studio, משתמשים ב-SDK Manager כדי להתקין את הגרסאות הספציפיות הבאות שנדרשות לדוגמאות של Android XR:

   • פלטפורמות SDK: 34,‏ 35 ו-36
   • ‫NDK: ‏ 29.0.x
   • כלי שורת הפקודה (כל הפריטים)

5. כדי להגדיר את משתני סביבת המערכת הבאים, פועלים לפי המדריך המתקדם להגדרה ולפתרון בעיות של Epic:

   • ANDROID_HOME
   • JAVA_HOME
   • NDK_ROOT

יצירת פרויקט Unreal XR

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

1. מפעילים את Unreal Engine 5.6.1.
2. בקטע New Project Categories (קטגוריות חדשות של פרויקטים), בוחרים בתבנית Virtual Reality (מציאות מדומה).
3. בתפריט Project Defaults (ברירות מחדל של הפרויקט), מגדירים את Target Platform (פלטפורמת היעד) לMobile (נייד).
4. מגדירים את הגדרה קבועה מראש של איכות לניתן להתאמה כדי לשפר את הביצועים במכשירי XR לנייד.
5. בוחרים שם לפרויקט ולוחצים על יצירה.

הגדרת הגדרות Android

אחרי שפותחים את הפרויקט, מבצעים את השלבים הבאים כדי להגדיר את רמות ה-API הנדרשות של Android ואת הגדרות הגרפיקה ל-Android XR:

1. עוברים אל עריכה > הגדרות הפרויקט.
2. עוברים אל Platforms > Android (פלטפורמות > Android).
3. אם הלחצן Accept SDK License (אישור רישיון ה-SDK) מודגש באדום, לוחצים עליו.
4. בקטע APKPackaging:
   • מגדירים את גרסת ה-SDK המינימלית ל-34.
   • מגדירים את גרסת ה-SDK לטירגוט ל-34 (או לגרסה גבוהה יותר).

5. גוללים עוד למטה לקטע Build (גרסה) ובוחרים באפשרות Support Vulkan (תמיכה ב-Vulkan).

   ‫Vulkan הוא ממשק ה-API המומלץ לגרפיקה ב-Android XR, והוא מספק ביצועים גבוהים.

הגדרת הגדרות העיבוד

כדי להשיג את קצב הפריימים הגבוה והחדות החזותית שנדרשים ל-Android XR, צריך גם להגדיר את Unreal Engine כך שישתמש בנתיב העיבוד האופטימלי לנייד:

1. עוברים אל עריכה > הגדרות הפרויקט ואז אל מנוע > עיבוד.

2. בקטע Forward Renderer (העברת רנדר), בוחרים באפשרות Forward Shading (העברת הצללה).

   מנוע הרינדור הקדמי מהיר משמעותית ב-VR בנייד בהשוואה למנוע הרינדור המוגדר כברירת מחדל. הערה: כדי להפעיל את האפשרות הזו צריך להפעיל מחדש את העורך ולבצע קומפילציה של shader.

3. בקטע Default Settings (הגדרות ברירת מחדל), מגדירים את Anti-Aliasing Method (שיטת החלקת קצוות) ל-MSAA.

4. בקטע Mobile, מגדירים את Mobile MSAA לערך 4x.

   ‫MSAA מספק את התוצאות החדות ביותר ל-VR בלי אפקטי הטשטוש שנגרמים על ידי Temporal AA ‏ (TAA).

5. בקטע VR:

   1. מבטלים את הסימון של Mobile HDR (תמונות HDR בנייד).

      השבתה של High Dynamic Range בנייד מפחיתה באופן משמעותי את התקורה של העיבוד שאחרי הצילום.

   2. בוחרים באפשרות מבט משולב בנייד.

      כך המנוע יכול לעבד את שתי העיניים במעבר אחד, ולשפר משמעותית את ביצועי המעבד.

עוד באותו הקשר

הוראות מפורטות לפריסת פרויקט תבנית במכשיר עם Android זמינות במאמר הגדרת פרויקטים של Unreal Engine לפיתוח ל-Android.