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

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

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

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

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

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

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

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

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

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

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

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

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

הגדרת הסשן

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

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

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

כדי להגדיר מסד נתונים של 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, קודם צריך להגדיר ARCore API לאפליקציה.

הרצת עדכון pod

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

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

מידע נוסף מופיע בקטע הוספה של 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 שמתארחים בחדר הזה, שמשתמשים באותו מכשיר או במכשיר אחר.

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

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

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

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

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

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

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

השלבים הבאים