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

במדריך הזה מפורטות הגרסאות המומלצות של העורך, הגדרות הגרפיקה, הגדרות 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, עוברים אל Edit (עריכה) > Project Settings (הגדרות הפרויקט) > Player (נגן).
  2. בוחרים בכרטיסייה Android ועוברים אל הגדרות אחרות > עיבוד.
  3. אם ההגדרה Auto Graphics API מופעלת, צריך להשבית אותה כדי להציג את הקטע Graphics APIs.

  4. בקטע Graphics APIs, לוחצים על הלחצן Add (+) ובוחרים באפשרות Vulkan בתפריט הנפתח.

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

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

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

Universal Render Pipeline

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

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

הגדרה

מיקום

ערך מומלץ

HDR

נכס Universal Render Pipeline

מצב מושבת

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

נתונים של מעבד תצוגה אוניברסלי

מצב מושבת

הגדרות של נכס 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, באפשרות Minimal API level, בוחרים באפשרות 24 או ברמה גבוהה יותר.

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

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

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

חלונות קופצים

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

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

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

למידע נוסף

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