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

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

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

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

כדי לפתח באמצעות Unity, צריך להוריד ולהתקין את Unity Hub.

מתקינים את גרסה 6000.0.58f2 ואילך של Unity Editor ואת Android Build Support, שכולל:

  • OpenJDK
  • Android SDK
  • Android NDK Tools

בחירת מנוע עיבוד

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

  1. ב-Unity, עוברים אל עריכה > הגדרות הפרויקט > המשחק.
  2. לוחצים על הכרטיסייה Android ועוברים אל הגדרות אחרות > עיבוד.
  3. אם האפשרות Auto Graphics API (ממשק API אוטומטי לגרפיקה) מופעלת, צריך להשבית אותה כדי להציג את הקטע Graphics APIs (ממשקי API לגרפיקה).

  4. בקטע ממשקי API של גרפיקה, לוחצים על הלחצן הוספה (+) ובוחרים באפשרות Vulkan בתפריט הנפתח.

    דוגמה שמראה איך לשנות את הגדרות ה-API של הגרפיקה בממשק המשתמש

  5. משנים את הסדר של ממשקי ה-API לגרפיקה באמצעות נקודות האחיזה (=) כך ש-Vulkan יופיע ראשון.

  6. אופציונלי: בוחרים ממשקי API אחרים של גרפיקה ולוחצים על הלחצן הסרה (–) כדי להסיר אותם.

Universal Render Pipeline

‫Android XR תואם ל-Universal Render Pipeline‏ (URP). אם אתם מתכננים להשתמש בתכונת ה-Passthrough, כדאי לעדכן את הגדרות ברירת המחדל של URP כדי לקבל את הביצועים הכי טובים של Passthrough ב-Android XR.

בטבלה הבאה מפורטות ההגדרות המומלצות של Unity URP, שמוסברות בפירוט רב יותר בקטעים הבאים.

הגדרה

מיקום

ערך מומלץ

HDR

נכס של צינור עיבוד אוניברסלי

מושבתת

עיבוד תמונה (Post Processing)

נתונים של Universal Renderer

מושבתת

הגדרות של נכס Universal Render Pipeline

כדי לבצע אופטימיזציה של נכס Universal Render Pipeline ל-Android XR:

  1. מאתרים את Universal Render Pipeline Asset של הפרויקט. אחת הדרכים לעשות זאת היא להקליד t:UniversalRenderPipelineAsset בסרגל החיפוש של חלון Project.

  2. בקטע איכות, משביתים את האפשרות HDR.

    נכס Universal Render Pipeline שמוצג עם הגדרות מומלצות

הגדרות נתונים של Universal Renderer

כדי לבצע אופטימיזציה של נתוני Universal Renderer ל-Android XR:

  1. מאתרים את נכס הנתונים של Universal Renderer בפרויקט. אחת הדרכים לעשות זאת היא להקליד t:UniversalRendererData בסרגל החיפוש של חלון Project.

  2. בכלי הבדיקה, בקטע Post-processing (עיבוד אחרי), מבטלים את הסימון של Enabled (מופעל).

    נתונים של Universal Renderer שמוצגים עם הגדרות מומלצות

רמת ה-API המינימלית ב-Android

מגדירים את הפרויקט לרמת API מינימלית של 24, שנדרשת על ידי OpenXR Loader. אחרת, יכול להיות שהגרסאות שלכם ייכשלו.

כדי להגדיר את רמת ה-API המינימלית של Android, צריך לבצע את השלבים הבאים.

  1. עוברים אל עריכה > הגדרות הפרויקט > נגן.
  2. בוחרים בכרטיסייה Android ופותחים את הגדרות אחרות.
  3. בקטע Identification, בוחרים באפשרות 24 או גרסה מתקדמת יותר עבור Minimal API level.

נקודת כניסה לאפליקציה

מגדירים את ההגדרות הבאות לנקודת הכניסה לאפליקציה:

  1. עוברים אל עריכה > הגדרות הפרויקט > נגן.
  2. בוחרים בכרטיסייה Android ופותחים את הגדרות אחרות.
  3. בקטע Configuration, מוודאים שהאפשרות Application Entry Point מסומנת ב-GameActivity ולא מסומנת ב-Activity.

תיבות דו-שיח

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

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

  1. עוברים אל עריכה > הגדרות הפרויקט > נגן.
  2. לוחצים על הכרטיסייה Android ופותחים את הרזולוציה והמצגת.
  3. בקטע רזולוציה, מפעילים את האפשרות פעילות שניתן לשנות את הגודל שלה.

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

‫OpenXR™‎ והלוגו של OpenXR הם סימנים מסחריים בבעלות The Khronos Group Inc. ‎ והם רשומים כסימן מסחרי בסין, באיחוד האירופי, ביפן ובבריטניה.