מדריך למתחילים לשימוש בעוגנים בענן ב-iOS

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

במדריך הזה תלמדו:

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

דרישות מוקדמות

  • Xcode מגרסה 13.0 ואילך
  • Cocoapods 1.4.0 ואילך אם משתמשים ב-Cocoapods
  • מכשיר Apple תואם ל-ARKit עם iOS מגרסה 12.0 ואילך (נדרש יעד פריסה של iOS 12.0 ואילך)

שימוש בעוגנים בענן

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

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

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

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

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

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

הגדרת הסשן

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

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

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

כדי להגדיר מסד נתונים של 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.

הגדרת ה-ARCore API

כדי להשתמש ב-Cloud anchors, צריך קודם להגדיר את ARCore API לאפליקציה.

הפעלת עדכון של pod

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

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

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

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

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

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

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

פיתוח והפעלה של האפליקציה

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

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

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

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

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

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

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

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

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

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

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

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

  1. מוסיפים את הערכים platform ו-pod הבאים ל-Podfile של הפרויקט:

        platform :ios, '11.0'
    pod 'ARCore/CloudAnchors', '~> 1.41.0'
  1. פותחים חלון Terminal ומריצים את pod update מהתיקייה שבה קיים פרויקט ה-Xcode.
    הפעולה הזו יוצרת קובץ .xcworkspace שמשמש ליצירה ולהרצה של האפליקציה.

עוגנים מתמשכים בענן

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

השלבים הבאים