הגדרה של תצוגה מקדימה ישירה ב-Unreal Engine

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

במדריך הזה מוסבר איך להגדיר תצוגה מקדימה ישירה לפרויקט ב-Unreal Engine.

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

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

• גרסת Unreal Engine: Unreal Engine 5.6.1 ואילך.
• הגדרת הפרויקט: צריך להשלים את כל השלבים במדריך הגדרת פרויקט ב-Unreal Engine.

• ‫Android XR Engine Hub: כדי להתקין ולהגדיר את המחשב המארח לתצוגה מקדימה ישירה, צריך לבצע את כל השלבים בקטע תחילת העבודה במדריך Android XR Engine Hub.

• חומרה:

  • להשתמש במחשב מארח עם Windows 11.
  • להשתמש בכרטיס גרפי מודרני עם תמיכה בקידוד וידאו ב-Vulkan.

הגדרת פלאגינים של Android XR

מגדירים את Unreal Engine עם הפלאגינים הנדרשים של Android XR:

1. פועלים לפי השלבים במדריך Android XR Extensions for Unreal Engine quickstart.

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

2. לכל פרויקט, מוודאים שיש קישור סמלי לתיקיית הפלאגינים של הספק.

הגדרת הגדרות הפרויקט

הגדרת ההגדרות של הפרויקט לסטרימינג של תצוגה מקדימה ישירה:

1. עוברים אל הגדרות הפרויקט > פלטפורמות > Windows.
2. מ-RHI ל-Vulkan.
3. עוברים אל עריכה > תוספים.
4. מפעילים את הפלאגין AndroidXRStreaming.
5. עוברים אל עריכה > הגדרות הפרויקט > תיאור.
6. מפעילים את האפשרות הפעלה במצב VR.

הפעלת זמן הריצה של הסטרימינג

אחרי שמפעילים את הפלאגין AndroidXRStreaming בפרויקט, בודקים אם זמן הריצה של Android XR Streaming קיים:

1. עוברים אל Project Settings > Plugins > AndroidXRStreaming.

2. לוחצים על הפעלת סטרימינג של AndroidXR.

   

3. מפעילים מחדש את Unreal Engine כדי להחיל את השינויים האלה.

הגדרת לקוח הסטרימינג

מגדירים את לקוח הסטרימינג עם אפשרויות שונות לפרויקט:

1. עוברים אל Project Settings > Plugins (הגדרות הפרויקט > תוספים).

2. בקטע AndroidXRStreamingClient, בודקים כל אחת מהאפשרויות הבאות ומפעילים או משביתים אותן בהתאם למה שנדרש לפרויקט:

   • הפעלה אוטומטית של הלקוח בתצוגה מקדימה: אם האפשרות הזו מופעלת, אפליקציית הלקוח של התצוגה המקדימה מופעלת בכל מכשיר תקף שנבחר כשלוחצים על התחלת תצוגה מקדימה של VR מהכלי לעריכה.
   • הפסקה אוטומטית של הלקוח בתצוגה המקדימה: אם האפשרות הזו מופעלת, הלקוח של התצוגה המקדימה מסתיים כשמפסיקים את התצוגה המקדימה של ה-VR מהכלי לעריכה.
   • בחירה אוטומטית של מכשיר תואם: כשהאפשרות הזו מופעלת, המערכת בוחרת אוטומטית את המכשיר התואם הראשון שמחובר למכונה כשמחפשים מכשירים.
   • הצגת תיבות דו-שיח עם שגיאות: אם האפשרות הזו מופעלת, מוצגות תיבות דו-שיח נוספות עם שגיאות (לדוגמה, תיבת דו-שיח עם שגיאה מוצגת אם מנסים להתחיל תצוגה מקדימה של VR בלי לבחור מכשיר לקוח). כדי להסתיר את תיבות הדו-שיח האלה, משביתים את האפשרות הזו.
   • רענון: כשהאפשרות הזו מופעלת, הלחצן רענון מחפש מכשירים מחוברים ומציג רשימה של מכשירים תואמים (התאימות נקבעת לפי הנוכחות של אפליקציית הלקוח Direct Preview במרכז Android XR Engine).

הפעלת תצוגה מקדימה ישירה

כדי להתחיל תצוגה מקדימה ישירה לסטרימינג ישירות מ-Unreal Engine:

1. מחברים את מכשיר Android XR למחשב המארח באמצעות כבל USB-C איכותי.

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

3. בעורך Unreal, לוחצים על Play level in VR (הפעלת הרמה ב-VR). כשמפעילים את התצוגה המקדימה הישירה, לא משתמשים באפשרות הרגילה הפעלה בעורך.