התכונה "תצוגה מקדימה ישירה" מאפשרת לבדוק אינטראקציות מורכבות ולחזור עליהן ישירות ב-Unreal Editor באמצעות נתונים בזמן אמת ממכשיר Android XR. במצב Direct Preview, המכונה המארחת מעבדת את התוכן ומנפה בו באגים, מעבירה בסטרימינג את אזור התצוגה החזותי ישירות למכשיר Android XR הפיזי, ומעבירה בסטרימינג תוספים נתמכים של OpenXR בחזרה למארח בזמן אמת.
כדי להגדיר את Direct Preview לפרויקט ב-Unreal Engine, פועלים לפי המדריך הזה.
דרישות מוקדמות
לפני שמתחילים, צריך לוודא שסביבת הפיתוח עומדת בדרישות הבאות:
- גרסת Unreal Engine: Unreal Engine 5.6.x או 5.8.x.
- הגדרת הפרויקט: מבצעים את כל השלבים במדריך הגדרת פרויקט ב-Unreal Engine.
- Android XR Engine Hub: מבצעים את כל השלבים בקטע תחילת העבודה במדריך של Android XR Engine Hub כדי להתקין ולהגדיר את המכונה המארחת לגרסת טרום-השקה (Preview) ישירה.
חומרה:
- משתמשים במחשב מארח עם Windows 11.
- להשתמש בכרטיס גרפי מודרני עם תמיכה בקידוד וידאו של Vulkan.
הגדרת פלאגינים של Android XR
מגדירים את Unreal Engine עם הפלאגינים הנדרשים של Android XR:
פועלים לפי השלבים שמפורטים במדריך למתחילים בנושא Android XR Extensions for Unreal Engine.
אם בהמשך תיצרו פרויקט חדש או תפתחו פרויקט שלא השתמשתם בו עם Direct Preview, תצטרכו לבצע שוב את אותם השלבים.
בכל פרויקט, מוודאים שיש קישור סימבולי לתיקיית הפלאגינים של הספק.
קביעת הגדרות הפרויקט
כדי להגדיר את הגדרות הפרויקט לסטרימינג ב-Direct Preview:
- עוברים אל Project Settings > Platforms > Windows (הגדרות הפרויקט > פלטפורמות > Windows).
- מ-RHI ל-Vulkan.
- עוברים אל Edit > Plugins (עריכה > פלאגינים).
- מפעילים את הפלאגין AndroidXRStreaming.
- עוברים אל Edit (עריכה) > Project Settings (הגדרות הפרויקט) > Description (תיאור).
- מפעילים את האפשרות התחלה במציאות מדומה.
הפעלת סביבת זמן הריצה של הסטרימינג
אחרי שהפעלתם את הפלאגין AndroidXRStreaming בפרויקט, בדקו אם סביבת זמן הריצה של Android XR Streaming קיימת:
- עוברים אל Project Settings > Plugins > AndroidXRStreaming.
לוחצים על הפעלת סטרימינג ב-AndroidXR.
מפעילים מחדש את Unreal Engine כדי להחיל את השינויים.
הגדרת לקוח הסטרימינג
מגדירים את לקוח הסטרימינג עם אפשרויות שונות לפרויקט:
- עוברים אל Project Settings > Plugins (הגדרות הפרויקט > פלאגינים).
בקטע AndroidXRStreamingClient, בודקים כל אחת מהאפשרויות הבאות ומפעילים או משביתים אותן בהתאם לצרכים של הפרויקט:
- Auto Start Client On Preview: כשהאפשרות הזו מופעלת, אפליקציית הלקוח של גרסת טרום-ההשקה מופעלת בכל מכשיר תקין שנבחר כשלוחצים על Start VR Preview בכלי העריכה.
- Auto Stop Client On Preview: כשמפעילים את האפשרות הזו, הלקוח של התצוגה המקדימה נסגר כשמפסיקים את התצוגה המקדימה של ה-VR מהעורך.
- בחירה אוטומטית של מכשיר תואם: כשההגדרה הזו מופעלת, המערכת בוחרת באופן אוטומטי את המכשיר התואם הראשון שמחובר למכונה בזמן חיפוש מכשירים.
- הצגת תיבות דו-שיח של שגיאות: כשמפעילים את האפשרות הזו, מוצגות תיבות דו-שיח נוספות של שגיאות (לדוגמה, תיבת דו-שיח של שגיאה מוצגת אם מנסים להפעיל תצוגה מקדימה של VR בלי לבחור מכשיר לקוח). כדי להסתיר את תיבות הדו-שיח האלה, צריך להשבית את האפשרות הזו.
- רענון: כשהאפשרות הזו מופעלת, הלחצן רענון מחפש מכשירים מחוברים ומציג את המכשירים התואמים (לפי הנוכחות של אפליקציית הלקוח של Direct Preview ב-Android XR Engine Hub).
התחלת התצוגה המקדימה הישירה
מפעילים את Direct Preview כדי להעביר סטרימינג ישירות מ-Unreal Engine:
מחברים את מכשיר Android XR למכונה המארחת באמצעות כבל USB-C איכותי.
אם אף פעם לא השתמשתם במכשיר הזה עם "תצוגה מקדימה ישירה", חברו והגדירו את המכשיר ל"תצוגה מקדימה ישירה" ב-Android XR Engine Hub לפני שתתחילו את "תצוגה מקדימה ישירה" דרך מנוע המשחק.
ב-Unreal Editor, לוחצים על Play level in VR. אל תשתמשו באפשרות הרגילה Play in Editor כשאתם מפעילים את Direct Preview.