מדריך למתחילים ל-Android NDK

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

  • התקנת Android Studio גרסה 3.1 ואילך עם Android SDK Platform בגרסה 7.0 (רמת API 24) ומעלה.

  • כדי להכין את Android Studio לפיתוח מקורי, צריך להתקין את Android Native ערכת פיתוח (NDK) ו-CMake באמצעות מנהל ה-SDK. מידע נוסף זמין במאמר הבא: תחילת העבודה עם NDK.

  • יהיה עליך לקבל את ARCore SDK ל-Android. אתם יכולים:

    • מורידים את ARCore SDK ל-Android ו לחלץ אותו.

      -או-

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

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

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

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

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

ב-Android Studio, פותחים את הפרויקט hello_ar_c לדוגמה ב-<ARCore SDK Folder>/samples/hello_ar_c.

לפרויקט לדוגמה יש יחסי תלות בגרסאות תוכנה מסוימות, כמו Gradle ו-Android SDK. אם יחסי התלות הנדרשים לא מותקנים, תוצג לך בקשה ב-Android Studio להורדה ולהתקנה של האפליקציות במחשב.

הרצת הדוגמה

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

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

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

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

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

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

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

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

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

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

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

שימוש בעומק

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

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

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

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

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

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

השלבים הבאים