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

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

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

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

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

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

    1. ב-Epic Games Launcher, מתקינים את גרסה 5.6.x או 5.8.x של Unreal Engine.

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

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

  4. מתקינים את Android Studio (גרסה Rabbit 2 ‏ | 2026.2.2 ואילך).

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

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

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

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

    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.x או 5.8.x).
  2. בקטע New Project Categories, בוחרים בתבנית מציאות מדומה.
  3. בתפריט Project Defaults, מגדירים את Target Platform ל-Mobile.
  4. מגדירים את Quality Preset (הגדרת איכות מראש) ל-Scalable (ניתן להתאמה) כדי לשפר את הביצועים בחומרת XR לנייד.
  5. בוחרים שם לפרויקט ולוחצים על Create.

קביעת הגדרות ב-Android

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

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

  5. גוללים למטה לקטע Build ובוחרים באפשרות Support Vulkan.

    ‫Vulkan הוא Graphics API מומלץ עם ביצועים גבוהים ל-Android XR.

קביעת הגדרות העיבוד (rendering)

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

  1. עוברים אל Edit > Project Settings (עריכה > הגדרות הפרויקט) ואז אל Engine > Rendering (מנוע > עיבוד).

  2. בקטע Forward Renderer, בוחרים באפשרות Forward Shading.

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

  3. בקטע Default Settings, מגדירים את Anti-Aliasing Method ל-MSAA.

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

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

  5. בקטע VR:

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

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

    2. לוחצים על מסך מפוצל בנייד.

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

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

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