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

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

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

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

  1. ב-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
  2. פותחים אחד מהפרויקטים לדוגמה באופן הבא (כדי ליצור ולהפעיל אותו, צריך לפתוח אותו באופן מפורש).

    • מהתפריט File, יש לבחור Open.
    • בתיקייה arcore-android-sdk/samples, בוחרים את התיקייה hello_ar_kotlin או את התיקייה hello_ar_java ולוחצים על Open.

הכנת המכשיר או האמולטור

אתם יכולים להריץ אפליקציות AR במכשיר נתמך או באמולטור Android. צריך לעדכן את Google Play Services למציאות רבודה באמולטור לפני שמפעילים את האפליקציה. מידע נוסף זמין במאמר הפעלת אפליקציות AR ב-Android Emulator .

הפעלת הדוגמה

צריך לוודא שמכשיר ה-Android מחובר למחשב הפיתוח וללחוץ על Run ב-Android Studio.

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

יכול להיות שתתבקשו להתקין או לעדכן את Google Play Services ל-AR אם הם חסרים או לא מעודכנים. בוחרים את CONTINUE כדי להתקין אותו מחנות Google Play, או מעדכנים אותו ידנית כמו שמתואר במאמר עדכון Google Play Services ל-AR.

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

שימוש במיקום מיידי

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

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

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

מיקום מיידי

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

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

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

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

שימוש בנתוני עומק

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

מיקום מיידי

באיור 1, נתוני העומק מושבתים. אובייקט ממוקם מתחת לטבלת הביליארד.

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

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

באיור 4, נראה שעכשיו האובייקט נחסם על ידי טבלת הביליארד בזמן שהמכשיר נע ממקום למקום.

השלבים הבאים