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

מכשירי XR שמתאימים לשימוש

ההנחיות האלה יעזרו לכם ליצור חוויות למכשירי XR מהסוגים הבאים.

מידע על סוגי מכשירי XR →

מידע על סוגי מכשירי XR →

במדריך הזה מפורטות גרסאות המנוע המומלצות, ערכות ה-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 (Panda 4‏ | 2025.3.4 Patch 1 ואילך).

התקנת תמיכה ב-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.
   • מגדירים את Target SDK Version (גרסת ה-SDK לטירגוט) ל-34 (או לגרסה גבוהה יותר).

5. גוללים למטה לקטע Build ובוחרים באפשרות Support 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.

      השבתה של High Dynamic Range בנייד מפחיתה באופן משמעותי את התקורה של הפוסט-פרוססינג.

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

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

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

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