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

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

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

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

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

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

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

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

הורדת אפליקציית הדוגמה של 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

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

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

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

הגדרה של ARCore API

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

הרצת עדכון של pod

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

עוגני ענן עמידים

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

השלבים הבאים