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

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

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

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

דרישות

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

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

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

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

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

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

iOS

הפלאגין ARKit XR Plugin מאפשר ליצור אפליקציות של מציאות רבודה למכשירי 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 לסצנה

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

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

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

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

    כשמשלוחים לחנות Play:

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

iOS

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

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

    Player Settings > … Value
    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

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