תחילת השימוש בתוספי ARCore למען קרן AR

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

דרישות

כדי לפתח עם תוספי ARCore for AR Foundation, צריך את הדברים הבאים:

Android

חומרה

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

תוכנה

• Unity 2019.4.3f1 ואילך עם תמיכה ב-Android Build
• AR Foundation 4.1.5 ואילך (מותקן באופן אוטומטי עם ARCore Extensions for AR Foundation SDK)
• פלאגין ARCore XR 4.1.5 ואילך (מותקן באופן אוטומטי עם תוספי ARCore עבור AR Foundation SDK)

iOS

חומרה

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

תוכנה

• Unity 2019.4.3f1 ואילך עם תמיכה ב-iOS Build
• AR Foundation 4.1.5 ואילך (מותקן באופן אוטומטי עם ARCore Extensions for AR Foundation SDK)
• ARKit XR Plugin 4.1.5 ואילך (מותקן באופן אוטומטי עם ARCore Extensions for AR Foundation SDK)
• Xcode 11.0 ואילך

התקנת החבילה של תוספי ARCore

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

יחסי תלות בחבילה

1. מוודאים ש-AR Foundation מותקן ומוגדר בסביבת הפיתוח.
2. פותחים או יוצרים פרויקט חדש ב-Unity.
3. בוחרים את פלטפורמת היעד הרצויה לפיתוח:
   1. מהתפריט File, יש לבחור Build Settings.
   2. בוחרים באפשרות Android או iOS, בהתאם לפלטפורמת היעד הרצויה.
   3. לוחצים על Switch Platform.

4. ייבוא החבילה העדכנית ביותר של תוספי ARCore:

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

   2. לחצו על הלחצן ובחרו באפשרות Add package from git URL... מהתפריט הנפתח.
      

   3. מדביקים את כתובת ה-URL הבאה בשדה הטקסט:

      https://github.com/google-ar/arcore-unity-extensions.git
      

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

ללא EDM4U

כברירת מחדל, תוספי ARCore כלולים בחבילה עם יחסי תלות נוספים. כשמשתמשים בספריות אחרות (למשל ב-Firebase Analytics) שתלויות בגרסה אחרת של 'מנהל תלות חיצוני ל-Unity', יכול להיות שהתנהגות לא מוגדרת תתרחש וכתוצאה מכך המשתמשים התלויים יפסיקו לפעול כראוי.

כדי למנוע התנגשויות בין גרסאות של ספריות, מתקינים תוספי ARCore ללא יחסי תלות בחבילה:

1. מורידים את תוספי ARCore ללא גרסת EDM4U ו-com.google.external-dependency-manager,
2. פועלים לפי ההוראות לייבוא חבילות UPM עם קובצי .tgz, והתקנת החבילות לפי הסדר הבא:
   1. com.google.external-dependency-manager,
   2. תוספי ARCore (ללא EDM4U).

כשמתקינים את ARCore Extensions, מערכת Unity גם תתקין באופן אוטומטי גרסה מתאימה של יחסי התלות הנדרשים:

• AR Foundation
• ARCore XR Plugin (לשימוש כשמטרגטים ל-Android)
• ARKit XR Plugin (לשימוש כשמטרגטים ל-iOS)

יכול להיות שיחסי התלות האלה לא מופיעים בתצוגה Package Manager > Package: In project. עם זאת, ניתן לראות את החבילות בחלון Project מתחת ל-Packages

הגדרה של תוספי ARCore

קרן AR 4.x

1. בחלונית Hierarchy, לוחצים לחיצה ימנית ומוסיפים את אובייקטי המשחק הבאים (אם עדיין לא נוספו):

   • XR > AR Session
   • XR > AR Session Origin
   • XR > ARCore Extensions

2. בחלונית Hierarchy, בוחרים את החבילה ARCore Extensions.

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

   • Session: שימוש בקטע AR Session של הסצנה.
   • AR Session Origin: שימוש בAR Session Origin של הסצנה.
   • Camera Manager: שימוש בקטע AR Camera של הסצנה.

4. אפשר ליצור ולחבר את הנכסים הבאים עבור Cloud anchors ומסננים של הגדרות מצלמה.

   1. בחלונית Project > Assets לוחצים לחיצה ימנית ובוחרים באפשרות Create > XR > ARCore Extensions Config.

   2. בחלונית Project > Assets לוחצים לחיצה ימנית ובוחרים באפשרות Create > XR > Camera Config Filter.

   3. בחלונית Hierarchy, בוחרים את החבילה ARCore Extensions.

   4. בשדה ARCore Extensions Config בחלונית Inspector, לוחצים על לחצן היעד ומתחברים לנכס ARCoreExtensionsConfig.

   5. בשדה Camera Config Filter בחלונית Inspector, לוחצים על לחצן היעד ומתחברים לנכס ARCoreExtensionsCameraConfigFilter.

      למידע נוסף, קראו את המדריך למפתחים של Cloud anchors ואת המדריך להגדרת המצלמה.

   6. אם אתם משתמשים בגרסת Unity שקודמת לגרסה 2020.3:

      • בוחרים באפשרות Custom Gradle Properties Template (תבנית מאפיינים מותאמים אישית של Gradle) בקטע Project Settings > Player > Android > Android > Publishing Settings > Build.

כשכל השדות של תוספי ARCore שלמעלה מקושרים בצורה תקינה, החלונית Inspector של תוספי ARCore נראית כך:

קרן AR 5.x

1. בחלונית Hierarchy, לוחצים לחיצה ימנית ומוסיפים את אובייקטי המשחק הבאים (אם עדיין לא נוספו):

   • XR > AR Session
   • XR > XR Origin (Mobile AR)
   • XR > ARCore Extensions

2. בחלונית Hierarchy, בוחרים את החבילה ARCore Extensions.

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

   • Session: שימוש בקטע AR Session של הסצנה.
   • XR Origin: שימוש בXR Origin של הסצנה.
   • Camera Manager: שימוש בקטע AR Camera של הסצנה.

4. אפשר ליצור ולחבר את הנכסים הבאים עבור Cloud anchors ומסננים של הגדרות מצלמה.

   1. בחלונית Project > Assets לוחצים לחיצה ימנית ובוחרים באפשרות Create > XR > ARCore Extensions Config.

   2. בחלונית Project > Assets לוחצים לחיצה ימנית ובוחרים באפשרות Create > XR > Camera Config Filter.

   3. בחלונית Hierarchy, בוחרים את החבילה ARCore Extensions.

   4. בשדה ARCore Extensions Config בחלונית Inspector, לוחצים על לחצן היעד ומתחברים לנכס ARCoreExtensionsConfig.

   5. בשדה Camera Config Filter בחלונית Inspector, לוחצים על לחצן היעד ומתחברים לנכס ARCoreExtensionsCameraConfigFilter.

      למידע נוסף, קראו את המדריך למפתחים של Cloud anchors ואת המדריך להגדרת המצלמה.

   6. אם אתם משתמשים בגרסת Unity שקודמת לגרסה 2020.3:

      • בוחרים באפשרות Custom Gradle Properties Template (תבנית מאפיינים מותאמים אישית של Gradle) בקטע Project Settings > Player > Android > Android > Publishing Settings > Build.

כשכל השדות של תוספי ARCore שלמעלה מקושרים בצורה תקינה, החלונית Inspector של תוספי ARCore נראית כך:

למידע נוסף על הגדרת מאפיינים, קראו את המדריך של Unity לעריכת נכסים.

פרויקטים לדוגמה

חבילות של תוספי ARCore for AR Foundation הם פרויקטים לדוגמה שתוכלו להשתמש בהם כדי להתחיל ביצירת פרויקטים משלכם.

1. מהתפריט Window, פותחים את Package Manager ובוחרים את החבילה ARCore Extensions.

2. בקטע Samples, לוחצים על Import לפרויקט לדוגמה שמתואר למטה.

הפרויקטים הבאים לדוגמה מיובאים ממאגר GitHub:

• גיאו-מרחבי (Android בלבד) – אפשר ליצור חוויות AR בקנה מידה גלובלי ולצרף תוכן מרחוק לכל אזור שנכלל ב-Google Street View. מידע נוסף זמין במבוא ל-API של Geospatial.

• PersistentCloudAnchors (Android ו-iOS) – יוצרים חוויות AR מתמשכות בעולם האמיתי באמצעות שכבות אינטראקטיביות של מידע דיגיטלי שמתמקד במיקומים בפועל, וחוויות עיצוב שיכולות להיות משותפות לאורך זמן בין מספר אנשים במכשירים שונים. למידע נוסף, עיינו במבוא ל-Cloud anchors.

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

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

• המדריך למפתחים של Cloud anchors
• מדריך להגדרת המצלמה