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