התחלה מהירה עבור Cloud עוגן

שימוש ב-Cloud עוגן כדי לבנות חוויות AR שמשתמשים ב-Android וב-iOS יכולים לשתף. המדריך הזה מסביר איך:

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

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

  • המדריך הזה יוצא מנקודת הנחה שכבר התקנת והגדרת
    מנוע אמיתי מנוע 4.19 עם הפלאגין של GoogleARCore מגרסה 1.3 ואילך.

    אם לא, יש לעיין במדריך למתחילים של Unreal לקבלת הוראות להתקנה.

  • אם זו הפעם הראשונה שאתם עובדים עם מודעות עוגן, עיינו בעבודה עם מודעות עוגן למבוא.

דרישות

כדי להשתמש ב-Cloud anchors, צריך:

חומרה

טירגוט מה תצטרך להכין
Android
iOS
  • אחד ממכשירי ה-iPhone הבאים התואמים ל-ARKit שפועלת בו מערכת iOS בגרסה 11 ואילך:
    • iPhone X
    • iPhone 8 ו-8 Plus
    • iPhone 7 ו-7
    • iPhone 6S ו-6S Plus
    • iPhone SE

  • כבל USB לחיבור הטלפון למכונת הפיתוח

תוכנה

טירגוט מה תצטרך להכין
Android
iOS

שימוש ב-Cloud עוגנים

יכולות עוגן של הענן כלולות בפלאגין GoogleARCoreServices עבור Unreal.

הקטעים הבאים מסבירים איך:

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

הערה לגבי מתן שמות לעוגן בענן

Unreal מטמיע את Cloud עוגן כ-CloudARPin, בדומה ל-ARPin. הפלאגין של GoogleARCoreServices עבור Unreal והאפליקציה לדוגמה פועלים בהתאם למוסכמה הזו של מתן שמות. המדריך הזה ישתמש גם במונח CloudARPin כשהוא מתייחס לעוגנים בענן ב-Unreal.

הגדרת סביבת הפיתוח

טירגוט מה לעשות?
Android מבצעים את ההתחלה המהירה של מערכת Android
iOS פועלים לפי ההתחלה המהירה של iOS לא אמיתית

בניית מנוע מציאותי באמצעות הפלאגין של GoogleARCore

כדי להשתמש ב-CloudARPinSample, חשוב לבנות תחילה את Unreal Engine 4.19 עם הפלאגין של GoogleARCore 1.3 ומעלה מקוד המקור.

לקבלת הוראות, עיינו בקטע הגדרת סביבת הפיתוח ב-ARCore Quickstart for Unreal.

השגת הדגימה

משיגים את CloudARPinSample:

  • מורידים את arcore-unreal-sdk-1.7.0.zip מה-Repo SDK של ARCore for Unreal SDK ומחלצים אותו.

    - או

  • לסגור את המאגר באמצעות הפקודה הבאה:

    git clone https://github.com/google-ar/arcore-unreal-sdk.git

פתיחת האפליקציה לדוגמה

ב-Unreal Editor, פותחים את הפרויקט CloudARPinSample.

הקטעים הבאים מסבירים איך להגדיר את הדגימה לשימוש ב-Cloud עוגן.

מידע על שיתוף של Cloud anchor ID

האפליקציה לדוגמה של CloudARPin משתמשת בתכונה 'Networking' של Unreal לשיתוף מזהי Cloud עוגן בין הרשתות המקומיות.

לקבלת פרטים על הטמעה, אפשר לבדוק את CloudARPinReplicator ואת ARPlayerController בדגימה ב-CloudARPin.

אפשר להשתמש בפתרון רשת אחר באפליקציות שלכם.

הוספת מפתח API

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

  1. קבלת מפתח API. למידע נוסף על עבודה עם מפתחות API, מומלץ לעיין בהגדרת מפתחות API במרכז העזרה של Google Cloud Platform Console.

  2. מפעילים את ה-ARCore Cloud עוגן API בפרויקט ב-Google Cloud Platform.

  3. ב-Unreal, מוסיפים את מפתח ה-API לפרויקט:

    • עוברים אל GoogleARCore Project Settings > GoogleARCoreServices.
    • מוסיפים את המפתח לשדה APIKey.

דגימה בחבילה

טירגוט מה לעשות?
Android בצעו את ההוראות ל"פריסה" בהתחלה מהירה במיוחד של Android
iOS בצעו את ההוראות ל"פריסה" בהתחלה מהירה במיוחד של iOS

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

לבנות ולהפעיל את האפליקציה לדוגמה CloudARPin כדי לנסות לארח ולפתור בעיות ב-Cloud עוגן. אפשר לנסות את האפליקציה בטלפון אחד או יותר.

  1. לאחר השלמת ההתקנה, מחפשים אפליקציה שנקראת CloudARPin בטלפון ומפעילים אותה.

  2. התחלת סשן בטלפון אחד או יותר:

    סוג הסשן מה לעשות?
    טלפון יחיד
    • מקישים על התחלת סשן. הסשן מתחיל וכתובת ה-IP של הטלפון מוצגת במסך.
    מספר טלפונים
    • חשוב לחבר את כל הטלפונים לרשת Wi-Fi שיש להם גישה לאינטרנט ולאפשר חיבור P2P.
    • שימוש בטלפון כמארח. מפעילים את האפליקציה בטלפון ומקישים על התחלת סשן. הסשן מתחיל, וכתובת ה-IP של הטלפון מוצגת במסך.
    • בטלפונים האחרים:
      • מפעילים את האפליקציה ומזינים את כתובת ה-IP של הטלפון המארח.
      • מקישים על הצטרפות לאחר התחלת הסשן.

    האפליקציה לדוגמה תושק בטלפונים ומתחיל לזהות מטוסים מול המצלמה.

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

  4. יש להקיש על מטוס כדי להתחיל לארח CloudARPin.

    • האפליקציה ממקמת את אובייקט Android במכשיר המטוס ומצרפים אותו ל-ARPin.
    • בקשת מארח נשלחת אל שירות Google Cloud עוגן כדי ליצור ולהתחיל לארח CloudARPin. בקשת המארח כוללת נתונים שמייצגים את המיקום של ARPin ביחס לתכונות החזותיות שבקרבת מקום.
    • בקשת אירוח מוצלחת מגדירה CloudARPin מתארח/ת.
    • האפליקציה מציגה מזהה CloudARPin בן ארבע ספרות, שמופה אל CloudID של CloudARPin, לאחר שבקשת האירוח מצליחה.
  5. אפשר גם לחזור על השלב הקודם כדי לארח CloudARPin נוספים.

  6. מקישים על ביטול כדי לצאת ממצב אירוח.

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

    • CloudARPin חדש נוצר כאשר מצב המעקב מוגדר ל-Paused.
    • בקשה לפתרון נשלחת אל שירות Google Cloud עוגן.
    • הבקשה לפתרון כוללת מזהה CloudARPin מתארח. אם המזהה תואם ל-CloudARPin מתארח, השרת מחזיר את הטרנספורמציה של CloudARPin בקואורדינטות המקומיות שלך.
    • האפליקציה לדוגמה משתמשת בטרנספורמציה לעיבוד של אובייקטים של Android (אנדי) שמצורפים ל-CloudARPin שנפתר.
  8. (אופציונלי) מקישים על ביטול וחוזרים על השלב הקודם כדי לפתור בעיות נוספות CloudARPin.

השלבים הבאים