תחילת העבודה עם AR Foundation

AR Foundation של Unity היא מסגרת בפלטפורמות שונות שמאפשרת לכתוב חוויות של מציאות מרובדת פעם אחת, ואז ליצור גרסאות ל-Android או ל-iOS בלי לבצע שינויים נוספים. המסגרת זמינה דרך החבילה AR Foundation של Unity.

החבילה האופציונלית של ARCore, ARCore Extensions for AR Foundation, מוסיפה פונקציונליות נוספת ומאפשרת לכם להשתמש בתכונות כמו Cloud Anchors, מסננים להגדרת המצלמה והקלטה והפעלה באפליקציה.

העברה או שדרוג של פרויקטים קיימים

דרישות

בהתאם לפלטפורמת היעד, החבילה AR Foundation דורשת את הפריטים הבאים:

AndroidiOS

חומרה

  • מכשיר Android או אמולטור שתומכים ב-ARCore
  • כבל USB לחיבור המכשיר למכונה לפיתוח

תוכנה

חומרה

תוכנה

התקנת AR Foundation

כדי להתקין את חבילת Unity‏ AR Foundation, פועלים לפי השלבים הבאים.

  1. פותחים פרויקט קיים ב-Unity או יוצרים פרויקט 3D חדש.
  2. נווט אל Window > Package Manager.

  3. לצד Packages, בוחרים באפשרות Unity Registry.

  4. בסרגל החיפוש, מקלידים 'AR Foundation'.

  5. לוחצים על Install.

  6. הגדרת צינור העיבוד ליצירת תמונה (Render Pipeline)

    AR Foundation 4.xAR Foundation 5.xAR Foundation 6.x

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

חבילת AR Foundation מספקת ממשק למפתחי Unity, אבל היא לא מטמיעה תכונות AR בעצמה. כדי להשתמש ב-AR Foundation במכשיר יעד, צריך גם להתקין חבילות נפרדות ולהפעיל את הפלאגין המתאים לכל פלטפורמה.

AndroidiOS

החבילה ARCore XR Plugin מאפשרת ליצור אפליקציות מציאות רבודה למכשירי Android. אם האפליקציה שלכם מיועדת למכשירי Android, עליכם לפעול לפי השלבים הבאים כדי להתקין אותה בפרויקט ב-Unity. כדי למנוע בעיות תאימות, צריך להשתמש באותה גרסה כמו חבילת AR Foundation.

  1. בפרויקט, עוברים אל Window > Package Manager.

  2. לצד Packages, בוחרים באפשרות Unity Registry.

  3. בסרגל החיפוש, מקלידים 'ARCore XR plugin'.

  4. לוחצים על Install.

  5. נווט אל Edit > Project Settings. ב-XR Plug-in Management, פותחים את הכרטיסייה Android ומפעילים את ARCore.

פלאגין ARKit XR מאפשר ליצור אפליקציות מציאות רבודה למכשירי iOS. אם האפליקציה שלכם מיועדת למכשירי iOS, עליכם לפעול לפי השלבים הבאים כדי להתקין אותה בפרויקט ב-Unity. כדי למנוע בעיות תאימות, צריך להשתמש באותה גרסה כמו חבילת AR Foundation.

  1. בפרויקט, עוברים אל Window > Package Manager.

  2. לצד Packages, בוחרים באפשרות Unity Registry.

  3. בסרגל החיפוש, מקלידים 'ARKit XR plugin'.

  4. לוחצים על Install.

  5. נווט אל Edit > Project Settings. ב-XR Plug-in Management, פותחים את הכרטיסייה iOS ומפעילים את ARKit.

הגדרת סשן AR והוספת רכיבים של AR Foundation לסצנה

כדי להפעיל תהליכי AR, כמו מעקב אחר תנועה, הבנה סביבתית והערכת תאורה, נדרשת לסצנה סשן AR. כדי לתמוך בסשן AR, תצטרכו את אובייקטי המשחק הבאים:

AR Foundation 4.xAR Foundation 5.xAR Foundation 6.x

  • AR Session: קובע את מחזור החיים של חוויית AR.

  • XR Origin: המרת קואורדינטות AR לקווי אורך ורוחב ב-Unity.

לפני שמוסיפים את אובייקטי המשחק החדשים, מוחקים את Main Camera שמוגדרת כברירת מחדל. הוא יוחלף ב-AR Camera חדש ב-XR Origin.

מוסיפים את האובייקטים החדשים של משחק ה-AR לסצנה: לוחצים לחיצה ימנית על החלונית Hierarchy ובוחרים באפשרות XR. מוסיפים אובייקט AR Session חדש ואובייקט XR Origin חדש.

  • AR Session: קובע את מחזור החיים של חוויית AR.

  • XR Origin: המרת קואורדינטות AR לקווי אורך ורוחב ב-Unity.

לפני שמוסיפים את אובייקטי המשחק החדשים, מוחקים את Main Camera שמוגדרת כברירת מחדל. הוא יוחלף ב-AR Camera חדש ב-XR Origin.

מוסיפים את האובייקטים החדשים של משחק ה-AR לסצנה: לוחצים לחיצה ימנית על החלונית Hierarchy ובוחרים באפשרות XR. מוסיפים אובייקט AR Session חדש ואובייקט XR Origin חדש.

הגדרת ההגדרות של הנגן

AndroidiOS
  1. עוברים אל File > Build Settings כדי לפתוח את החלון Build Settings.
  2. בקטע Platform, בוחרים באפשרות Android ולוחצים על Switch Platform.
  3. לוחצים על Player Settings.

  4. מחילים את השינויים הבאים:

    Player Settings > … ערך
    Other Settings > Rendering מבטלים את הסימון של Auto Graphics API.
    אם האפשרות Vulkan מופיעה בקטע Graphics APIs, מסירים אותה כי עדיין אין תמיכה ב-Vulkan ב-ARCore.
    Other Settings > Package Name יוצרים מזהה אפליקציה ייחודי לפי פורמט של שם חבילת Java.
    לדוגמה, משתמשים ב-com.example.helloAR.
    Other Settings > Minimum API Level אם אתם מפתחים אפליקציה עם דרישה ל-AR, מציינים את הערך Android 7.0 'Nougat' (API Level 24) or higher.
    אם אתם מפתחים אפליקציה עם AR אופציונלי, מציינים Android API Level 19 or higher.
    Other Settings > Scripting Backend בוחרים באפשרות IL2CPP במקום Mono כדי לאפשר הפעלה של תמיכה ב-ARM64 בשלב הבא.

    במהלך הפיתוח:

    • שימוש ב-Mono + 32-bit‏ (ARMv7)
    • התקנה של קובץ APK של ARCore בפורמט FAT (32 ביט + 64 ביט)

    כששולחים ל-Play Store:

    • שימוש ב-IL2CPP
    • מפעילים גם 32 ביט (ARMv7) וגם 64 ביט (ARM64) כדי לעמוד בדרישות של חנות Play ל-64 ביט
    • אופציונלי (נתמך בגרסה 2018.3 ואילך): ב-Build Settings, מפעילים את Android App Bundles
    Other Settings > Target Architectures כדי לעמוד בדרישה של Google Play לקוד של 64 סיביות, צריך להפעיל את ARM64 (ARM של 64 ביט). משאירים את האפשרות ARMv7 (ARM 32 ביט) מופעלת כדי לתמוך במכשירים עם 32 ביט.
  1. עוברים אל File > Build Settings כדי לפתוח את החלון Build Settings.
  2. בקטע Platform, בוחרים באפשרות iOS ולוחצים על Switch Platform.
  3. לוחצים על Player Settings.

  4. מגדירים את ההגדרות הבאות:

    Player Settings > … ערך
    Other Settings > Bundle Identifier מוסיפים את שם האפליקציה בפורמט DNS הפוך.
    לדוגמה, משתמשים ב-com.mycompany.myapp.
    Other Settings > Camera usage description מזינים תיאור שמסביר את השימוש שלכם ב-AR (לדוגמה, ARKit).
    Other Settings > Target minimum iOS version 11.0 או יותר
    Other Settings > Architecture ARM64

המאמרים הבאים