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

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

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

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

דרישות

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

Android

חומרה

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

תוכנה

iOS

חומרה

תוכנה

התקנת AR Foundation

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

  1. פותחים פרויקט Unity קיים או יוצרים פרויקט תלת-ממדי חדש.

  2. נווט אל Window > Package Manager.

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

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

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

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

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

Android

פלאגין ARCore XR מאפשרת לפתח אפליקציות של מציאות רבודה למכשירי Android. כדי להתקין את האפליקציה בפרויקט Unity, יש לפעול לפי השלבים הבאים אם מטורגט למכשירי Android. משתמשים באותה גרסה של החבילה 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.

iOS

הפלאגין של ARKit XR מאפשר לפתח אפליקציות של מציאות רבודה למכשירי iOS. כדי להתקין את האפליקציה בפרויקט Unity, יש לפעול לפי השלבים הבאים אם מטורגטים למכשירי iOS. להשתמש באותה גרסה של החבילה 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 Fundamentals לסצנה

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

AR Foundation 4.x

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

  • AR Session Origin: ממירים קואורדינטות AR ל-Unity את הקואורדינטות בעולם.

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

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

AR Foundation 5.x

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

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

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

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

קביעת הגדרות הנגן

Android

  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, צריך להסיר אותו כי ב-ARCore עדיין אין תמיכה ב-Vulkan.
    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 כדי לאפשר תמיכה ב-ARM64 בשלב הבא, צריך לבחור באפשרות IL2CPP במקום Mono.

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

    • שימוש ב-Mono + 32 ביט (ARMv7)
    • התקנת FAT (32 ביט + 64 ביט) ARCore APK

    במשלוח לחנות Play:

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

iOS

  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

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