התחלה מהירה ל-Cloud עוגן ב-iOS

ARCore Cloud anchor API או שירות ARCore Cloud עוגן, מספק יכולות של Cloud עוגן לאפליקציות ל-iOS, כך שמשתמשים יכולים להשתמש במכשירי iOS וגם ב-Android כדי לשתף חוויות AR.

המדריך הזה מסביר איך:

• הגדרת סביבת הפיתוח כך שתעבוד עם Cloud עוגן
• כדאי לנסות לארח עוגנים ולפתור אותם באפליקציות לדוגמה

דרישות

כדי להשתמש ב-Cloud anchors, צריך:

• Xcode מגרסה 10.1 ואילך

• Cocoapods 1.4.0 ואילך

• מכשיר Apple תואם ARKit שפועל בו iOS מגרסה 11.0 ואילך (נדרש יעד פריסה מגרסה iOS 10.0 ואילך)

  הערה: החל מ-ARCore 1.12, כל המכשירים שתואמים ל-ARKit נתמכים.

שימוש ב-Cloud עוגנים

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

להורדת האפליקציה לדוגמה של Cloud עוגן

1. משכפלים או מורידים את ה-ARCore SDK ל-iOS מ-GitHub כדי לקבל את קוד האפליקציה לדוגמה.

2. פותחים חלון Terminal או Finder, ועוברים לתיקייה שבה שכפולים או מורידים את ה-SDK.

3. קוד האפליקציה לדוגמה נמצא ב-
   /arcore-ios-sdk-master/Examples/CloudAnchorExample.

   קוד האפליקציה לדוגמה עוגנים בענן קבועים נמצא ב
   /arcore-ios-sdk-master/Examples/PersistentCloudAnchorExample.

הגדרת סשן

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

• המערכת יוצרת GARSession
• הגדרת GARSessionDelegate כדי לקבל קריאות חוזרות (callback) מאירוח ופתרון בעיות.
• ליצור ARSession ולהפעיל אותו
• הגדרת ARSessionDelegate.
• מתבצעת העברה של ARFrame שניות לGARSession בשיטה session:didUpdateFrame:.

הגדרת שיתוף של מזהה עוגן ב-Cloud

אפליקציית הדגימה של Cloud anchors משתמשת ב-Firebase כדי לשתף מזהים של עוגן בענן בין מכשירים. אתם יכולים להשתמש בפתרון אחר באפליקציות שלכם.

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

1. פועלים לפי ההוראות להוספת Firebase לאפליקציה ב-Firebase.
2. מורידים את הקובץ GoogleService-Info.plist שנוצר כחלק מהוספת Firebase לאפליקציה.
3. מפעילים אחסון ב-Firebase לדוגמה:
   • נכנסים למסוף Firebase ובוחרים את הפרויקט שהגדרתם לאפליקציה לדוגמה.
   • יש לבחור בחלונית Database.
   • באפשרות Realtime Database, לוחצים על Get Started.
   • התפריט Security rules for Realtime Database נפתח.
     • לצורך הרצת הדוגמה, יש לבחור Start in test mode.
     • הערה: אם משתמשים ב-Firebase לאפליקציה שרוצים לפרסם, צריך להשתמש בכללי אבטחה מגבילים יותר.
4. ב-Xcode, מוסיפים את הקובץ GoogleService-Info.plist לאפליקציה, לצד Info.plist.

הוספת מפתח API

כדי להשתמש ב-Cloud עוגן צריך להוסיף מפתח API לאפליקציה.

1. קבלת מפתח API. למידע נוסף על עבודה עם מפתחות API, מומלץ לעיין בהגדרת מפתחות API במרכז העזרה של Google Cloud Platform Console.

2. מפעילים את ה-ARCore Cloud עוגן API בפרויקט ב-Google Cloud Platform.

3. ב-Xcode יש להוסיף את מפתח ה-API לאפליקציה. כדי לעשות זאת, יש להוסיף את המפתח לקוד הבא ב-CloudAnchorManager.m:

   self.gSession = [GARSession sessionWithAPIKey:@"Replace me with your API key."
                                bundleIdentifier:nil
                                           error:nil];
   

הפעלה של עדכון ה-Pod

האפליקציה CloudanchorExample נשלחת עם Podfile הגדרה מראש עם גרסת ה-SDK של ARCore ו-iOS הנדרשת. כדי להתקין את תלויות אלה:

1. יש לפתוח חלון טרמינל ולהפעיל את pod update מהתיקייה שבה פרויקט ה-Xcode קיים.
   הפעולה הזו יוצרת קובץ .xcworkspace שבו תשתמשו מאוחר יותר כדי לבנות ולהפעיל את האפליקציה.

לפרטים על הגדרת Podfile באפליקציות שלך, אפשר לעיין במאמר הוספה של ARCore SDK לאפליקציה

1. פותחים את הקובץ .xcworkspace של הפרויקט ב-Xcode.

   כדי להימנע משגיאות ב-build, יש לוודא שברצונך ליצור קובץ מהקובץ .xcworkspace ולא מקובץ ה-.xcodeproj.

שינוי המזהה של App Bundle

ב-Xcode, משנים את מזהה החבילה של האפליקציה כדי שניתן יהיה לחתום על האפליקציה עם הצוות.

יצירה והפעלה של אפליקציה

1. מחברים את המכשיר ומפעילים את האפליקציה ב-Xcode.

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

רוצה לנסות את האפליקציה לדוגמה?

1. יש לבנות את האפליקציה לדוגמה ולהפעיל אותה מהקובץ .xcworkspace כדי להפעיל אותה במכשיר.

2. אם מתבקשים לעשות זאת, מעניקים הרשאות גישה למצלמה. לאחר מכן, התכונה ARKit מתחילה לזהות מטוסים מול המצלמה.

3. יש להקיש על HOST כדי להיכנס למצב אירוח. נוצר קוד לחדר לשיתוף מודעות עוגן ומופיע במסך שלך.

4. יש להקיש על מטוס כדי להתחיל לארח עוגן בענן.

   • האפליקציה ממקמת אובייקט של Android במכשיר המטוס ומקשרת אליו עוגן.
   • בקשת מארח נשלחת אל ARCore Cloud עוגן API. בקשת המארח כוללת נתונים שמייצגים את מיקום העוגן ביחס לתכונות החזותיות שבקרבתו.
   • לאחר שהעוגן מתארח, הוא יקבל מזהה שמשמש לפתרון העוגנים בענן במרחב המשותף הזה.

5. יש להקיש על RESOLVE ולהזין קוד חדר כדי לגשת לחדרים שעמדו קודם לכן בענן, באותו מכשיר או דרך מכשיר אחר.
   

   • בקשה לפתרון נשלחת אל ARCore Cloud עוגן API.
   • הבקשה לפתרון כוללת מזהה עוגן בענן. אם המזהה תואם לעוגן מתארח וההתאמה לשוק המקומי מוצלחת, השרת מחזיר את הטרנספורמציה של העוגן בקואורדינטות המקומיות שלך.
   • האפליקציה לדוגמה משתמשת בטרנספורמציה כדי להוסיף את העוגן לסצנה ולעבד אובייקטים וירטואליים שמצורפים אליה.

הוספת ARCore SDK לאפליקציות

באפליקציות שלך, עליך לעדכן את ה-Podfile כך שיכלול את ה-SDK של ARCore ואת הגרסאות הנתמכות של iOS. לשם כך:

1. יש להוסיף את platform ואת pod הבאים לפרויקט שלך ב-Podfile.

       platform :ios, '11.0'
       pod 'ARCore/CloudAnchors', '~> 1.32.0'
   

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

1. יש לפתוח חלון טרמינל ולהפעיל את pod update מהתיקייה שבה פרויקט שלך ב-Xcode קיים.
   הפעולה הזו יוצרת קובץ .xcworkspace שמשמש אותך כדי לבנות ולהפעיל את האפליקציה.

עוגנים לענן

כפי שמתואר באירוח עוגן בענן, אתם יכולים להגדיר כעוגן בענן תמיכה למשך עד 365 ימים. קוד לדוגמה לשימוש בעוגנים בענן באופן קבוע זמין במאגר /arcore-ios-sdk-master/Examples/PersistentCloudAnchorExample ב-ARCore SDK ל-iOS מ-GitHub.

השלבים הבאים

• עיינו במדריך למפתחים של Cloud עוגן ל-iOS כדי לגלות את קוד האפליקציה לדוגמה ולקבל מידע נוסף על עבודה עם Cloud עוגן באפליקציות שלכם.

• אפשר לקרוא פרטים נוספים בחומר העזר בנושא ARCore iOS API.