המדריך למתחילים של Cloud anchors ל-Android

אפשר לנסות אירוח ופתרון בעיות של Cloud עוגנים באפליקציות לדוגמה cloud_anchor_java ו-persistent_cloud_anchor_java.

באיזו אפליקציה לדוגמה כדאי להשתמש?

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

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

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

דרישות

חומרה

תוכנה

  • Android Studio בגרסה 3.0 ואילך עם Android SDK Platform בגרסה 7.0 (רמת API 24) ואילך
  • את ARCore SDK ל-Android, אפשר לקבל באחת משתי דרכים:
    • מורידים את הקוד מ-GitHub ומחלצים אותו מהמחשב
    • משכפלים את המאגר באמצעות הפקודה הבאה: 
      git clone https://github.com/google-ar/arcore-android-sdk.git

פתיחת האפליקציה לדוגמה ב-Android Studio

ARCore SDK מספק את האפליקציות לדוגמה cloud_anchor_java ו-persistent_cloud_anchor_java כדי להדגים את הפונקציונליות של Cloud עוגנים. מבצעים את השלבים הבאים כדי לפתוח את האפליקציות ב-Android Studio.

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

  1. ב-Android Studio, לוחצים על פתיחה.

  2. מנווטים למקום שבו מאוחסנת הספרייה arcore-android-sdk במחשב. אין לפתוח את כל תיקיית ה-SDK. במקום זאת, עברו אל דוגמאות > persistent_cloud_anchor_java ולוחצים על persistent_cloud_anchor_java.

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

  1. ב-Android Studio, לוחצים על פתיחה.

  2. מנווטים למקום שבו מאוחסנת הספרייה arcore-android-sdk במחשב. אין לפתוח את כל תיקיית ה-SDK. במקום זאת, עברו אל דוגמאות > cloud_anchor_java ולוחצים על cloud_anchor_java.

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

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

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

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

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

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

  1. מוסיפים את Firebase לאפליקציה באופן ידני. שם החבילה של cloud_anchor_java הוא com.google.ar.core.examples.java.cloudanchor. אפשר למצוא אותו בmain/AndroidManifest.xml.
  2. מורידים את הקובץ google-services.json שיצרתם כשהוספתם את Firebase לאפליקציה.
  3. יצירת מסד נתונים בזמן אמת באמצעות Firebase.
  4. ב-Android Studio, מוסיפים את הקובץ google-services.json לספריית app של הפרויקט.

אישור קריאות ARCore API

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

יצירה והפעלה של אפליקציה לדוגמה

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

הפעלת האפליקציה

  1. מוודאים שהאפשרות אפשרויות למפתחים וניפוי באגים ב-USB הופעלו במכשיר.
  2. מחברים את המכשיר באמצעות USB למכונת הפיתוח.
  3. ב-Android Studio, בוחרים את המכשיר כיעד הפריסה ולוחצים על הפעלה.

האפליקציה persistent_cloud_anchor_java אמורה להתחיל במכשיר שלך ולגרום ל-ARCore לזהות את המטוסים מול המצלמה של המכשיר.

אם מתן ההרשאה ל-Google Cloud נכשל, קראו את השלבים לפתרון בעיות.

מיקום עוגן

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

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

סימון סימון כעוגן

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

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

הפעלת האפליקציה

  1. מוודאים שאפשרויות למפתחים וניפוי באגים ב-USB הופעלו במכשיר.
  2. מחברים את המכשיר באמצעות USB למכונת הפיתוח.
  3. ב-Android Studio, בוחרים את המכשיר כיעד הפריסה ולוחצים על הפעלה.

האפליקציה cloud_anchor_java אמורה להתחיל במכשיר שלך ולגרום ל-ARCore לזהות את המטוסים מול המצלמה של המכשיר.

שגיאה: com.google.firebase.database.DatabaseException: Failed to get FirebaseDatabase instance: Specify DatabaseURL within FirebaseApp or from your getInstance

אם תיתקלו בשגיאה הזו, ודאו שהמאפיין firebase_url נמצא ב-google-services.json. כדי לקבל את הערך הנכון לנכס הזה, צריך לוודא שנוצר מסד נתונים בזמן אמת ולהוריד את google-services.json.

מיקום עוגן

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

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

סימון סימון כעוגן

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

מה השלב הבא?