הפעלת אפליקציות AR באמולטור של Android

מומלץ להשתמש באמולטור Android כדי לבדוק תרחישים ב-AR ללא מכשיר פיזי. אמולטור Android מאפשר לך להפעיל אפליקציות ARCore בסביבה וירטואלית עם מכשיר המדמה.

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

דרישות תוכנה:

קבלת כלים ל-Android Studio ול-SDK ל-ARCore

  1. מתקינים את Android Studio מגרסה 3.1 ואילך.

  2. ב-Android Studio, עוברים אל Preferences > Appearance and Behavior > System Settings > Android SDK.

  3. בוחרים בכרטיסייה SDK Platforms ובודקים את התווית Show Package Details.

    בגרסה המתאימה של Android, בוחרים:
    Google APIs Intel x86 Atom System Image API ברמה 27 ואילך.

  4. יש לבחור בכרטיסייה SDK Tools ולהוסיף את גרסה Android Emulator מגרסה 27.2.9 ואילך.

  5. לוחצים על OK כדי להתקין את החבילות והכלים שנבחרו.

  6. כדי לאשר את השינויים, צריך ללחוץ שוב על OK.

  7. Accept הסכם הרישיון של מתקין הרכיבים.

  8. לוחצים על Finish.

יצירת מכשיר וירטואלי עם תמיכה ב-AR

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

יצירת מכשיר וירטואלי חדש (AndroidD)

  1. ב-Android Studio, פותחים את AVD Manager על ידי לחיצה על Tools > AVD Manager.

  2. לוחצים על Create Virtual Device בחלק התחתון של תיבת הדו-שיח ניהול AVD.

  3. בוחרים או יוצרים את פרופיל החומרה טלפון הרצוי ובוחרים Next.

  4. צריך לבחור תמונה של מערכת x86 או x86_64 שפועלת בה רמת API של גרסה 27 ואילך ולבחור באפשרות Next.

    • בעוד שמכשירי ARCore פיזיים נתמכים ב-API ברמה 24 ואילך, לתמיכה ב-Android אמולטור נדרשת גרסה 27 ואילך של API.

    • יש תמיכה רק בארכיטקטורה של Android עם אמולטור מסוג x86. בשלב זה, אין תמיכה בארכיטקטורה אחרת כמו arm64-v8a, armeabi-v7.

  5. מוודאים שהמכשיר הווירטואלי מוגדר כראוי:

    • לוחצים על Show Advanced Settings.

    • יש לוודא שהערך Camera Back מוגדר ל-VirtualScene.

  6. לוחצים על Finish כדי ליצור את קובץ ה-AVD.

הפעלת האפליקציה

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

עדכון שירותי Google Play ל-AR

סביר להניח שהגרסה של שירותי Google Play ל-AR באמולטור לא עדכנית. יש לפעול לפי ההוראות הבאות כדי לעדכן אותה:

  1. אפשר להוריד את הגרסה העדכנית ביותר של Google_Play_Services_for_AR_1.32.0_x86_for_emulator.APK מדף GitHub שחרורים.

  2. מתקינים את ה-APK שהורדתם לכל AVD שבו רוצים להשתמש:

    מפעילים את קובץ ה-AVD הרצוי, ולאחר מכן גוררים את ה-APK שהורדתם מתיקיית המערכת (כלומר, Downloads) לאמולטור הפעיל, או להתקין אותו באמצעות adb בזמן שהמכשיר הווירטואלי פועל:

    adb install -r Google_Play_Services_for_AR_1.32.0_x86_for_emulator.apk

חוזרים על השלבים האלה לכל AVD נוסף שבו רוצים להשתמש.

שליטה בסצנה הווירטואלית

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

הזזת המצלמה הווירטואלית

יש ללחוץ לחיצה ארוכה על Option (macOS) או על Alt (ב-Linux או ב-Windows) כדי לגשת לפקדי התנועה של המצלמה. משתמשים בפקדים הבאים כדי להזיז את המצלמה:

פלטפורמה פעולה פעולות מומלצות
macOS העברה שמאלה או ימינה החזקת המקשים Option + הקשה על A או על D
העברה למטה או למעלה החזקת המקשים Option + הקשה על Q או על E
העברה קדימה או אחורה החזקת המקשים Option + הקשה על W או S
שינוי כיוון המכשיר מחזיקים את האפשרות Option + העברה של העכבר
Linux או Windows העברה שמאלה או ימינה מחזיקים את המקשים Alt + A או D
העברה למטה או למעלה החזקת המקשים Alt + הקשה על Q או E
העברה קדימה או אחורה החזקת המקשים Alt + הקשה על W או S
שינוי כיוון המכשיר מחזיקים את המקש Alt + העברת העכבר

יש לשחרר את Option או את Alt כדי לחזור למצב אינטראקטיבי באמולטור.

יש להשתמש בכרטיסייה Virtual Sensors בפקדים מורחבים למיקום מדויק יותר של המכשיר.

הוספה של תמונות משופרות לסצנה

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

יש להשתמש בכרטיסייה Camera ב-Extended controls כדי להוסיף או לשנות את Scene images. יש שני מיקומים של תמונות: אחד על הקיר ואחד על השולחן.

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

טיפים לפתרון בעיות

  • אם אפליקציית ARCore מופעלת ואתם רואים הודעה &מירכאות; המכשיר הזה לא תומך ב-AR" יש לבדוק את הגרסה הקודמת בתמונת המערכת שלכם. צריך לוודא שאתם משתמשים ב-API ברמה 27 גרסה 4 ואילך.

  • אם אפליקציית ARCore לא נפתחת באמצעות המצלמה, חשוב לוודא שהערך של Camera Back מוגדר ל-VirtualScene, כפי שמתואר בשלבי ההגדרה שלמעלה.

  • אם האפליקציה ARCore לא נפתחת עם הודעת השגיאה "היצירה של AR נכשלה&quot, יש לבדוק את יומן האפליקציה. אם מופיעה java.lang.UnsatisfiedLinkError עם הודעה שמכילה את /lib/arm/libarcore_c.so" is for EM_ARM (40) instead of EM_386 (3), יכול להיות שהתקנת את הגרסה הלא נכונה של שירותי Google Play ל-AR. יוצרים מכשיר וירטואלי חדש ומתקינים את גרסה ה-x86.