הפעלה מהירה ב-Android

כדי להתחיל להשתמש ב-ARCore ב-Android, אפשר להריץ אפליקציה לדוגמה hello_ar_kotlin או hello_ar_java שכלולה ב-ARCore SDK. האפליקציות לדוגמה הבאות משתמשות ב-OpenGL, ממשק תכנות לעיבוד גרפיקה וקטורית בדו-ממד ובתלת-ממד. האפליקציות מוצגות מטוסים שזוהו ומאפשרים למשתמש להקיש על מטוס כדי למקם מודל תלת-ממדי.

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

פתיחת פרויקט לדוגמה

  1. משכפלים ב-Android Studio את מאגר ה-GitHub של ARCore SDK.

    אפשר לעשות את זה בכמה דרכים:

    • להתקנה של 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

  2. פותחים אחד מהפרויקטים לדוגמה באופן הבא (צריך לפתוח באופן מפורש פרויקט כדי ליצור ולהפעיל אותו).

    • בתפריט 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 Services למציאות רבודה אם הוא חסר או לא מעודכן. בוחרים את CONTINUE שממנו רוצים להתקין חנות Google Play או לעדכן אותה ידנית כפי שמתואר מעדכנים את Google Play Services למציאות רבודה.

האפליקציה hello_ar_java מאפשרת להציב חייל תלת-ממדי של ARCore שזוהו בתוך מטוסים במציאות רבודה. הוא מוטמע באמצעות Android GL SurfaceView, שמשמש לעיבוד התצוגה המקדימה של המצלמה ואובייקטים בסיסיים ב-AR כמו מטוסים ועוגנים. אפשר למצוא את framework הרינדור לדוגמה של hello_ar_java ב- com/google/ar/core/examples/java/common/samplerender.

שימוש במיקום ללא התקנה

Instant Location API מאפשר למשתמשים להציב אובייקט AR על המסך בלי לחכות ש-ARCore יזהה את הגיאומטריה של המשטח. מיקום האובייקט משתפר בזמן אמת ככל שהמשתמש מתקדם ברחבי הסביבה.

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

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

מיקום מודעה מיידית

באיור 1, המיקום המיידי מושבת והגיאומטריה של פני השטח לא מוגדרת. אובייקטים שממוקמים על הרצפה מימין לשולחן הביליארד (ארבע נקודות כחולות קטנות) על המוח שלהן, התנוחה שלהן לא מוגדרת.

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

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

באיור 4, האובייקט החדש הופך לצבע והתנוחה שלו מדויקת, כאשר זוהתה גיאומטריה של פני השטח (המתוארת בקווי הרשת שניתן למעקב).

שימוש בעומק

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

מיקום מודעה מיידית

באיור 1, העומק מושבת. אובייקט מוצב מתחת לטבלת המאגר.

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

באיור 3, העומק מופעל.

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

השלבים הבאים