איך מתחילים לעבוד עם Geospatial Creator for Unity

1. לפני שמתחילים

Geospatial Creator, שמבוסס על ARCore ועל פלטפורמת מפות Google, מאפשר לכם ליצור חוויות מציאות רבודה (AR) בכלי העריכה של Unity. הוא משתמש ב-Photorealistic 3D Tiles API של Google כדי להציג תצוגה מקדימה של חוויית השימוש בעולם האמיתי, בלי שצריך לבקר פיזית במיקום הזה.

ב-codelab הזה תלמדו איך להתחיל להשתמש ב-Geospatial Creator. תלמדו איך להגדיר את פרויקט Unity למתחילים ואיך להשתמש בכלי העריכה. לאחר מכן, מייבאים נכס לסצנה וממקמים אותו בתאום הדיגיטלי של העולם. אתם מוסיפים אנימציה לנכס כדי להפיח בו חיים. לבסוף, צופים בתוכן במכשיר במציאות רבודה.

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

• ידע בסיסי ב-AR

מה תלמדו

• איך מגדירים את פרויקט ARCore Geospatial Creator ב-Unity.
• איך מנווטים בתצוגה Scene.
• איך ממקמים נכס תלת-ממדי בתצוגה Scene.
• איך מוסיפים התנהגות פשוטה לנכס.
• איך מפעילים את חוויית ה-AR במכשיר.

מה נדרש

• התקנה של Unity Hub.
• מכשיר Android או iOS נתמך שמוגדר לפיתוח אפליקציות.
• במכשירי היעד של Android, צריך להתקין את Android Studio ולהגדיר אותו כדי ליצור אפליקציות ל-Android, וגם להתקין את Google Play Services למציאות רבודה במכשיר הפיתוח של Android.
• במכשירי iOS מטורגטים, Xcode.

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

כדי לאחזר נתונים של משבצות תלת-ממד פוטוריאליסטיות מ-Google Cloud, צריך להגדיר הרשאה.

הגדרת פרויקט ב-Google Cloud

1. יוצרים פרויקט במסוף Google Cloud.
2. בתיבת הטקסט Project name, מזינים שם מתאים, כמו ARCore Geospatial API project, ואז בוחרים מיקום כלשהו.
3. לוחצים על יצירה.
4. במסוף Google Cloud, בדף לבחירת הפרויקט, לוחצים על Create Project.

הפעלת 3D Tiles API

כדי להפעיל את 3D Tiles API, לוחצים על הלחצן הבא ואז על הפעלה:

הפעלת 3D Tiles API

הפעלת ARCore API

כדי להפעיל את ARCore API, לוחצים על הלחצן הבא ואז על הפעלה:

הפעלת ARCore API

יצירת מפתח API לפרויקט

1. במסוף Google Cloud, בקטע APIs & services, בוחרים באפשרות Credentials.
2. בחלק העליון של הדף, לוחצים על Create Credentials ואז על API Key.
3. חשוב לשים לב למפתח כי תצטרכו אותו בשלבים הבאים.

הגדרת התוכנה

כדי להתחיל להשתמש בכלי לעריכת נתונים גיאו-מרחביים, פועלים לפי השלבים הבאים:

1. ב-Unity Hub, יוצרים פרויקט 3D עם Unity בגרסה 2021.3.17f1 ומעלה.
2. לוחצים על Window > Package Manager (חלון > מנהל חבילות), ואז פועלים לפי השלבים הבאים כדי להוסיף את החבילות הנדרשות:
   1. לוחצים על + > הוספת חבילה מכתובת URL של git > https://github.com/google-ar/arcore-unity-extensions.git.
   2. לוחצים על דוגמאות ומייבאים את הדוגמה הגיאוספציאלית.
   3. מורידים את הגרסה העדכנית של Cesium for Unity, ואז לוחצים על + > Add package from tarball > com.cesium.unity-1.0.0.tgz.
3. אם הוא עדיין לא מותקן, פועלים לפי השלבים הבאים כדי להתקין את Shader Graph:
   1. לוחצים על In Project > Unity Registry (בפרויקט > מאגר Unity).
   2. מתקינים את Shader Graph.

הגדרת סצנת הדוגמה עם אובייקטים של ARCore

1. בחלונית Project (פרויקט), לוחצים על Assets > Samples > ARCore Extensions > 1.37.0 > Geospatial Sample > Scenes > Geospatial (נכסים > דוגמאות > תוספים של ARCore > 1.37.0 > דוגמה של מיקום גיאוגרפי > סצנות > מיקום גיאוגרפי).
2. לוחצים על Layers (שכבות) ומשביתים את שכבת ממשק המשתמש.
3. לוחצים על Edit > Project Settings > XR Plug-in Management > ARCore Extensions (עריכה > הגדרות הפרויקט > ניהול תוספים של XR > תוספים של ARCore).
4. מגדירים אסטרטגיית הרשאה של מפתח API לפלטפורמת היעד.
5. מפעילים את התכונות האופציונליות Geospatial ו-Geospatial Creator.
6. בחלונית Hierarchy, לוחצים על + > XR > Geospatial Creator Origin.
7. בחלונית Hierarchy, בוחרים באפשרות AR Geospatial Creator Origin.
8. בחלונית Inspector (כלי הבדיקה) בקטע Geospatial Creator Origin (מקור של Geospatial Creator), לוחצים על Add Cesium Georeference Component (הוספת רכיב של הפניה גיאוגרפית של Cesium).
9. בתיבת הטקסט Google Maps Tile API Key (מפתח Google Maps Tile API), מזינים את מפתח ה-API ואז מקישים על Enter (או על return ב-macOS).

3. ניווט בתצוגת הסצנה של Unity

בשלב הזה, תוכלו לראות את הייצוג התלת-ממדי של האזור שסביבכם.

שינוי המיקום של תצוגת התלת-ממד

כדי לשנות את המיקום של התצוגה המקדימה של משבצות תלת-ממד פוטוריאליסטיות לאזור שקרוב אליכם, פועלים לפי השלבים הבאים:

1. בחלונית Hierarchy, בוחרים באובייקט המשחק AR Geospatial Creator Origin.
2. בחלונית Inspector (כלי הבדיקה), פועלים לפי השלבים הבאים כדי לשנות את הערכים של Latitude (קו רוחב) ו-Longitude (קו אורך) למיקום שקרוב אליכם:
   1. אפשר להשתמש במפות Google כדי למצוא מיקום בקרבת מקום.
   2. לוחצים לחיצה ימנית על המפה ובוחרים את הקואורדינטות שמופיעות כדי להעתיק אותן ללוח.
      אחרי שמשנים את הערכים, הייצוג התלת-ממדי של העולם בחלון Scene משתנה:
      

שליטה במצלמה של אזור התצוגה

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

1. כדי להזיז את המצלמה קדימה ואחורה, משתמשים במקשי החיצים למעלה ולמטה.
2. כדי להזיז את התצוגה, משתמשים במקשי החיצים ימינה ושמאלה.
3. במהלך ההזזה, לוחצים לחיצה ארוכה על Shift כדי להזיז מהר יותר.
4. אם אתם לא מוצאים את עצמכם, בחלונית Hierarchy בוחרים באובייקט AR Geospatial Creator Origin ואז לוחצים על F כדי למרכז את התצוגה עליו.

4. ייבוא והצבה של נכס בתלת-ממד

אחרי שתבחרו מיקום בקרבתכם, תצטרכו לייבא נכס שיופיע בחוויית ה-AR שלכם, ויעוגן בקרבת המיקום שבחרתם.

ייבוא נכס תלת-ממדי

כדי לעזור לכם בתרגיל הזה, הכנו נכס לדוגמה שתוכלו להשתמש בו בפרויקט.

כדי לייבא את נכס הדוגמה:

1. הורדת נכס הנמר.
2. מחלצים את ארכיון ה-ZIP.
3. לוחצים על נכסים > ייבוא נכס חדש. ארבעת הנכסים מיובאים לפרויקט.
4. בחלונית Project, גוררים את הנכס Tiger model לחלונית Scene.

שינוי הגודל והמיקום של הנכס

כדי למקם את הנכס במקום הנכון, פועלים לפי השלבים הבאים:

1. בחלונית Hierarchy (היררכיה), מוודאים שהנכס Tiger model (מודל נמר) נבחר.
2. בתצוגה Scene, מוודאים שכלי שינוי הגודל מופעל, ואז גוררים את הקובייה הלבנה כדי לשנות את גודל הנכס לפי ההעדפה.
   
3. בתצוגה Scene, מוודאים שכלי ההזזה מופעל, ואז בוחרים את אמצעי הבקרה האדומים, הכחולים או הירוקים וגוררים את העכבר כדי לשנות את מיקום הנכס. כל אמצעי בקרה צבעוני נועל מימד מסוים ומאפשר להזיז אובייקט לאורך הציר הזה.
   

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

כדי לעגן את התוכן לעולם האמיתי, פועלים לפי השלבים הבאים:

1. בחלונית Hierarchy (היררכיה), מוודאים שהנכס Tiger model (מודל נמר) נבחר.
2. בחלונית Inspector, לוחצים על Add Component (הוספת רכיב) כדי להוסיף AR Geospatial Creator Anchor (עוגן של AR Geospatial Creator).

5. הופכים את הנכס לחלק מהמציאות

בעזרת עורך Unity אפשר לתכנת חוויות AR מהנות באמצעות היכולות של מערכת Unity.

כדי להשתמש באחת מהאנימציות שמופיעות בפרויקט המתחיל כדי להנפיש את הנמר בלולאה, פועלים לפי השלבים הבאים:

1. בחלונית Hierarchy, בוחרים באפשרות Tiger model.
2. לוחצים על Add Component (הוספת רכיב) כדי להוסיף אנימטור.
3. בקטע Animator (אנימטור), בוחרים Controller (בקר) ואז משתמשים בנכס Tiger idle animation controller (בקר אנימציית נמר במצב המתנה) שמופיע.

6. צפייה בנכס ב-AR

לבסוף, צופים בנכס ב-AR במכשיר Android או iOS שנתמך על ידי ARCore.

הפעלת האפליקציה במכשיר

1. לוחצים על File (קובץ) > Build Settings (הגדרות בנייה), ואז בוחרים בפלטפורמות הבנייה Android או iOS.
2. לוחצים על החלפת פלטפורמה.
3. פועלים לפי השלבים הנוספים כדי להגדיר את ההגדרות של נגן.
4. מוודאים שמכשיר הפיתוח מחובר ומוגדר לפיתוח.
5. לוחצים על Build and run (בנייה והפעלה).

7. סיכום

מעולה! למדתם איך להשתמש ב-Geospatial Creator ב-Unity כדי ליצור חוויית מציאות רבודה (AR) גיאוגרפית.

מידע נוסף

• Geospatial Creator for Unity ב-Google Developers