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
משכפלים או מורידים את ARCore SDK ל-iOS מ-GitHub כדי לקבל את קוד האפליקציה לדוגמה.
פותחים חלון Terminal או Finder ומנווטים לתיקייה שבה שכפלתם או הורדתם את ה-SDK.
קוד האפליקציה לדוגמה מופיע ב
/arcore-ios-sdk-master/Examples/CloudAnchorExample
.קוד האפליקציה לדוגמה של מודעות עוגן בענן נמצא ב-
/arcore-ios-sdk-master/Examples/PersistentCloudAnchorExample
.
הגדרת הסשן
האפליקציה לדוגמה מבצעת את המשימות החשובות הבאות כחלק מהגדרת הסשן:
- יצירת
GARSession
- יצירה של
ARSession
והפעלה שלו - הגדרה של
ARSessionDelegate
. - מתבצעת העברה של
ARFrame
s אלGARSession
בשיטהsession:didUpdateFrame:
.
הגדרת שיתוף של מזהה עוגן בענן
באפליקציה לדוגמה של Cloud anchors נעשה שימוש ב-Firebase לצורך שיתוף מזהים של Cloud anchor בין מכשירים. אפשר להשתמש בפתרון אחר באפליקציות שלכם.
כדי להגדיר מסד נתונים של Firebase באפליקציה לדוגמה:
- פועלים לפי ההוראות של Firebase להוספת Firebase לאפליקציה.
- מורידים את קובץ
GoogleService-Info.plist
שנוצר כחלק מהוספת Firebase לאפליקציה. - מפעילים אחסון ב-Firebase עבור הדוגמה:
- נכנסים למסוף Firebase ובוחרים את הפרויקט שהגדרתם עבור האפליקציה לדוגמה.
- בוחרים בחלונית Database.
- באפשרות Realtime Database, לוחצים על Get Started.
- התפריט Security rules for Realtime Database נפתח.
- כדי להריץ את הדוגמה, יש לבחור באפשרות Start in test mode.
- שימו לב שאם אתם משתמשים ב-Firebase לאפליקציה שאתם מתכננים לפרסם, עליכם להשתמש בכללי אבטחה מגבילים יותר.
- ב-Xcode, מוסיפים את הקובץ
GoogleService-Info.plist
לאפליקציה, לצדInfo.plist
.
הגדרת ה-ARCore API
כדי להשתמש ב-Cloud anchors, צריך קודם להגדיר את ARCore API לאפליקציה.
הפעלת עדכון של pod
האפליקציה CloudAnchorExample נשלחת עם Podfile
שהוגדר מראש עם ה-SDK של ARCore וגרסאות iOS הנדרשות. כדי להתקין את יחסי התלות האלה:
- פותחים חלון Terminal ומריצים את
pod update
מהתיקייה שבה קיים פרויקט Xcode.
המערכת יוצרת קובץ.xcworkspace
שישמש אתכם בהמשך ליצירה ולהרצה של האפליקציה.
למידע נוסף על הגדרת ה-Podfile
באפליקציות שלכם, עיינו במאמר על הוספת ה-SDK של ARCore לאפליקציה.
פותחים את קובץ
.xcworkspace
של הפרויקט ב-Xcode.כדי להימנע משגיאות build, צריך לוודא שהיצירה מתבצעת מקובץ
.xcworkspace
ולא מקובץ.xcodeproj
.
שינוי מזהה ה-App Bundle
ב-Xcode, צריך לשנות את מזהה החבילה של האפליקציה כדי שאפשר יהיה לחתום על האפליקציה עם הצוות.
פיתוח והפעלה של האפליקציה
מחברים את המכשיר ומפעילים את האפליקציה ב-Xcode.
(אופציונלי) אם אתם יוצרים ומפעילים את האפליקציה לדוגמה, עיינו בקטע הבא כדי לקבל פרטים על השימוש באפליקציה לאירוח ולטיפול ב-Cloud anchors.
רוצה לנסות את האפליקציה לדוגמה?
כדי להפעיל את האפליקציה לדוגמה במכשיר שלכם, אתם יכולים ליצור ולהריץ את האפליקציה לדוגמה מהקובץ
.xcworkspace
.אם מתבקשים, מעניקים לאפליקציה הרשאות גישה למצלמה. לאחר מכן, ARKit מתחיל לזהות מטוסים שמול המצלמה.
יש להקיש על HOST כדי להיכנס למצב אירוח. המערכת יוצרת קוד חדר לשיתוף עוגנים מתארחים ומופיע על המסך שלכם.
מקישים על מטוס כדי להתחיל לארח שם עוגן בענן.
- האפליקציה מציבה אובייקט Android של Andy במטוס ומחברת אליו עוגן.
- בקשה למארח נשלחת לנקודת הקצה בענן של ARCore API. בקשת המארח כוללת נתונים שמייצגים את מיקום העוגן ביחס למאפיינים החזותיים בסביבתו.
- ברגע שמודעת העוגן מתארחת, היא מקבלת מזהה שמשמש לפתרון עוגנים בענן במרחב המשותף הזה.
מקישים על RESOLVE ומזינים קוד חדר כדי לגשת למודעות עוגן בענן שמתארחות בעבר בחדר הזה, באמצעות אותו מכשיר או מכשיר אחר.
- בקשת פענוח נשלחת לנקודת הקצה בענן של ARCore API.
- בקשת הפתרון כוללת מזהה עוגן בענן. אם המזהה תואם לעוגן מתארח וההתאמה לשוק המקומי הצליחה, השרת מחזיר את הטרנספורמציה של העוגן בקואורדינטות המקומיות שלכם.
- באפליקציה לדוגמה נעשה שימוש בטרנספורמציה כדי להוסיף את העוגן לסצנה ולעבד אובייקטים וירטואליים שמצורפים אליה.
הוספת ARCore SDK לאפליקציות שלך
צריך לעדכן את Podfile
באפליקציות שלכם כך שיכללו את
ה-SDK של ARCore ואת הגרסאות הנתמכות של iOS. לשם כך:
מוסיפים את הערכים
platform
ו-pod
הבאים ל-Podfile
של הפרויקט:platform :ios, '11.0' pod 'ARCore/CloudAnchors', '~> 1.44.0'
- פותחים חלון Terminal ומריצים את
pod update
מהתיקייה שבה קיים פרויקט ה-Xcode.
הפעולה הזו יוצרת קובץ.xcworkspace
שמשמש ליצירה ולהרצה של האפליקציה.
עוגנים מתמשכים בענן
כפי שמתואר במאמר אירוח עוגן בענן עם עקביות, אפשר להגדיר לעוגן בענן משך חיים של עד 365 ימים. הקוד לדוגמה לשימוש בעוגנים קבועים בענן זמין בספרייה /arcore-ios-sdk-master/Examples/PersistentCloudAnchorExample
ב-ARCore SDK ל-iOS מ-GitHub.
השלבים הבאים
תוכלו להיעזר במדריך למפתחים של Cloud anchors ל-iOS כדי לבדוק את הקוד לדוגמה של האפליקציה ולקבל מידע נוסף על עבודה עם Cloud anchors באפליקציות שלכם.
אפשר לעיין בפרטים בחומר העזר בנושא API של ARCore ל-iOS.