כדי להתחיל להשתמש ב-ARCore עם Android, אפשר להריץ את האפליקציה לדוגמה hello_ar_kotlin או hello_ar_JavaScript שכלולה ב-SDK של ARCore. האפליקציות האלה לדוגמה הן OpenGL, ממשק תכנות המיועד לעיבוד גרפיקה וקטורית ב-2D ובתלת-ממד. האפליקציות מציגות מטוסים שזוהו ומאפשרים למשתמש להקיש על מטוס כדי למקם מודל תלת-ממדי.
הגדרת סביבת הפיתוח
להתקין את Android Studio גרסה 3.1 ואילך עם Android SDK Platform מגרסה 7.0 (רמת API 24) ומעלה.
אם זו הפעם הראשונה שאתם משתמשים ב-Android, כדאי לעיין במאמר יצירה של אפליקציית Android הראשונה.
פתיחת פרויקט לדוגמה
ב-Android Studio, משכפלים את המאגר של ARCore SDK GitHub.
ניתן לעשות זאת בדרכים רבות:
להתקנה מבוססת של Android Studio:
- מהתפריט Git, בוחרים Clone.
- בתפריט הנפתח של Version control, בוחרים באפשרות Git כמערכת בקרה של גרסה.
בשדה URL, מזינים את כתובת ה-URL הבאה למאגר ARCore GitHub:
https://github.com/google-ar/arcore-android-sdk.git
יש לך גם אפשרות לפתוח את Terminal ולבצע את הפקודה
git clone
באופן הבא:git clone https://github.com/google-ar/arcore-android-sdk.git
פותחים אחד מהפרויקטים לדוגמה (צריך לפתוח במפורש פרויקט כדי לבנות ולהפעיל אותו).
- מהתפריט File, בוחרים Open.
- בתיקייה arcore-android-sdk/samples, בוחרים בתיקייה hello_ar_kotlin או hello_ar_java ולוחצים על Open.
הכנת המכשיר או האמולטור
אפשר להריץ אפליקציות AR במכשיר נתמך או באמולטור של Android. עליך לעדכן את Google Play Services למציאות רבודה באמולטור לפני הפעלת האפליקציה. למידע נוסף, יש להפעיל אפליקציות AR ב-Android אמולטור.
הרצת הדגימה
מוודאים שמכשיר ה-Android מחובר למכונת הפיתוח ולוחצים על
Run ב-Android Studio.
Android Studio יוצר את הפרויקט שלך ל-APK לניפוי באגים, מתקין את ה-APK ולאחר מכן מפעיל את האפליקציה במכשיר. למידע נוסף עיינו במאמר יצירה והפעלה של האפליקציה.
ייתכן שתתבקשו לעדכן או לעדכן את שירותי Google Play ל-AR אם הם חסרים או שאינם מעודכנים. יש לבחור את CONTINUE כדי להתקין אותו מחנות Google Play או לעדכן אותו באופן ידני כפי שמתואר בעדכון של Google Play Services ל-AR.
האפליקציה hello_ar_JavaScript מאפשרת להציב סמל ARCore תלת-ממדי
בפלטפורמות של מטוסים ב-AR שאותרו. היא מיושמת באמצעות Android GL SurfaceView, המשמש לעיבוד התצוגה המקדימה של המצלמה ואובייקטים בסיסיים של AR כמו מטוסים
ועוגנים. ניתן למצוא את מסגרת הרינדור hello_ar_JavaScript' במסגרת
com/google/ar/core/examples/java/common/samplerender
.
שימוש במיקום מיידי
ה-API של מיקומי מודעות מיידיים מאפשר למשתמש למקם אובייקט AR במסך מבלי לחכות ל-ARCore לזהות גיאומטריה של משטח. המיקום של האובייקטים מותאם בזמן אמת, כי המשתמשים נעים בסביבה. לאחר ש-ARCore מזהה את התנוחה הנכונה באזור שבו נמצא אובייקט ה-AR, האובייקט הלבן מתעדכן באופן אוטומטי כדי להיות מדויק, והופך לאטום.
הצבת אובייקט וירטואלי באמצעות מיקום מיידי
מיקום מיידי מופעל באופן אוטומטי ב-hello_ar_JavaScript. יש להקיש על סמל גלגל השיניים שבמסך ולבחור באפשרות Instant Placement בתפריט הנפתח. תיבת הסימון Enable Instant Placement כבר אמורה להיות מסומנת.
מקישים על המסך כדי למקם אובייקט. חשוב להמשיך להזיז את המכשיר לאחר שרואים את האובייקט הולוגרפי במסך, כדי ש-ARCore יוכל לקבל מספיק נתונים על הסביבה כדי לעגן אותו באופן וירטואלי.
השלבים הבאים
- נסו לבנות ולהפעיל פרויקטים לדוגמה אחרים ב-ARCore SDK.
- כדאי לעיין במעבדות הקוד של מציאות רבודה כדי לקבל עוד אפליקציות לדוגמה שאפשר לבנות ולהפעיל.
- בקישור הבא מוסבר איך להפעיל את ARCore באפליקציה.
- כדאי לעיין בשיקולים לגבי זמן ריצה.
- קוראים את ההנחיות לעיצוב.