از شبیه‌ساز اندروید برای آزمایش سناریوهای واقعیت افزوده بدون دستگاه فیزیکی استفاده کنید. شبیه‌ساز اندروید به شما امکان می‌دهد برنامه‌های ARCore را در یک محیط مجازی با یک دستگاه شبیه‌سازی شده که کنترل می‌کنید، اجرا کنید.
محیط توسعه خود را تنظیم کنید
نیازمندی‌های نرم‌افزاری:
اندروید استودیو ۳.۱ یا بالاتر.
شبیه‌ساز اندروید نسخه ۲۷.۲.۹ یا بالاتر.
دریافت ابزارهای اندروید استودیو و SDK برای ARCore
اندروید استودیو ۳.۱ یا بالاتر را نصب کنید.
در اندروید استودیو، به مسیر Preferences > Appearance and Behavior > System Settings > Android SDK بروید.
برگه SDK Platforms را انتخاب کنید و Show Package Details تیک بزنید.
در قسمت نسخه اندروید مناسب، موارد زیر را انتخاب کنید:
رابط‌های برنامه‌نویسی کاربردی گوگل، رابط برنامه‌نویسی کاربردی تصویر سیستم اتم اینتل x86 سطح ۲۷ یا بالاتر.تب SDK Tools را انتخاب کنید و Android Emulator 27.2.9 یا بالاتر را اضافه کنید.
برای نصب بسته‌ها و ابزارهای انتخاب شده، روی OK کلیک کنید.
برای تأیید تغییرات، دوباره روی OK کلیک کنید.
توافقنامه مجوز نصب کامپوننت را Accept .
روی Finish کلیک کنید.
یک دستگاه مجازی با پشتیبانی AR ایجاد کنید
برای اطلاعات بیشتر، به دستورالعمل‌های اندروید استودیو برای ایجاد یک دستگاه مجازی مراجعه کنید.
ایجاد یک دستگاه مجازی اندروید (AVD) جدید
در اندروید استودیو، با کلیک روی Tools > Device Manager ، بخش Device Manager را باز کنید.
روی Create Device در بالای پنل مدیریت دستگاه کلیک کنید.
نمایه سخت‌افزار تلفن مورد نظر خود را انتخاب یا ایجاد کنید و روی Next کلیک کنید.
یک ایمیج سیستم
x86یاx86_64که API Level 27 یا بالاتر را اجرا می‌کند، انتخاب کنید و Next بزنید.در حالی که دستگاه‌های فیزیکی ARCore با API سطح ۲۴ یا بالاتر پشتیبانی می‌شوند، پشتیبانی از شبیه‌ساز اندروید نیاز به API سطح ۲۷ یا بالاتر دارد.
فقط معماری‌های شبیه‌ساز اندروید مبتنی بر x86 پشتیبانی می‌شوند. معماری‌های دیگر مانند
arm64-v8a،armeabi-v7در حال حاضر پشتیبانی نمی‌شوند.
تأیید کنید که دستگاه مجازی شما به درستی پیکربندی شده است:
روی Show Advanced Settings کلیک کنید.
مطمئن شوید که Camera Back روی VirtualScene تنظیم شده است.
برای ایجاد AVD خود، روی Finish کلیک کنید.
برنامه خود را اجرا کنید
یک برنامه ARCore را روی یک دستگاه مجازی پشتیبانی‌شده با AR در شبیه‌ساز آزمایش کنید. برای انجام این کار، می‌توانید دستورالعمل‌های اندروید استودیو را برای اجرای یک برنامه در شبیه‌ساز اندروید دنبال کنید.
به‌روزرسانی سرویس‌های گوگل پلی برای واقعیت افزوده
احتمالاً نسخه Google Play Services for AR روی شبیه‌ساز قدیمی است. برای به‌روزرسانی آن، این دستورالعمل‌ها را دنبال کنید:
آخرین نسخه Google_Play_Services_for_AR_1.51.0_x86_for_emulator.apk را از صفحه انتشار GitHub دانلود کنید.
فایل APK دانلود شده را در هر AVD که می‌خواهید استفاده کنید، نصب کنید:
AVD مورد نظر را اجرا کنید، سپس فایل APK دانلود شده را از پوشه سیستم خود (یعنی Downloads ) به شبیه‌ساز در حال اجرا بکشید (drag) یا در حالی که دستگاه مجازی در حال اجرا است، آن را با استفاده از
adbنصب کنید:adb install -r Google_Play_Services_for_AR_1.51.0_x86_for_emulator.apk
این مراحل را برای هر AVD دیگری که می‌خواهید استفاده کنید، تکرار کنید.
کنترل صحنه مجازی
وقتی برنامه شما به ARCore متصل می‌شود، یک لایه رویی مشاهده خواهید کرد که نحوه کنترل دوربین و یک نوار وضعیت را در زیر پنجره شبیه‌ساز شرح می‌دهد.
دوربین مجازی را جابجا کنید
برای دسترسی به کنترل‌های حرکت دوربین Shift فشار داده و نگه دارید. از کنترل‌های زیر برای حرکت دوربین استفاده کنید:
| اکشن | چه باید کرد؟ |
|---|---|
| حرکت به چپ یا راست | Shift را نگه دارید + A یا D را فشار دهید |
| حرکت به پایین یا بالا | Shift را نگه دارید + Q یا E را فشار دهید |
| حرکت به جلو یا عقب | Shift را نگه دارید + W یا S را فشار دهید |
| تغییر جهت دستگاه | نگه داشتن Shift + حرکت دادن ماوس |
برای بازگشت به حالت تعاملی در شبیه‌ساز، Shift رها کنید.
برای موقعیت‌یابی دقیق‌تر دستگاه، از تب Virtual Sensors در کنترل‌های توسعه‌یافته استفاده کنید.
تصاویر افزوده شده را به صحنه اضافه کنید
تصاویر را در محیط شبیه‌سازی‌شده‌ی شبیه‌ساز بارگذاری کنید تا تصاویر افزوده‌شده را آزمایش کنید.
برای افزودن یا تغییر Scene images از تب Camera در Extended controls استفاده کنید. دو مکان برای قرار دادن تصویر وجود دارد، یکی روی دیوار و دیگری روی میز.
برای مشاهده‌ی مکان‌های این تصاویر در صحنه، شبیه‌ساز خود را اجرا کنید، سپس دوربین را از طریق دری که پشت موقعیت اولیه‌ی دوربین قرار دارد، به قسمت اتاق غذاخوری منتقل کنید.
نکات عیب‌یابی
اگر برنامه ARCore شما اجرا شد و پیام «این دستگاه از AR پشتیبانی نمی‌کند» را مشاهده کردید، نسخه سیستم خود را بررسی کنید. مطمئن شوید که از API سطح ۲۷ نسخه ۴ یا بالاتر استفاده می‌کنید.
اگر برنامه ARCore شما هنگام اجرا نتوانست دوربین را باز کند، مطمئن شوید که Camera Back روی VirtualScene تنظیم شده است، همانطور که در مراحل پیکربندی بالا توضیح داده شده است.
اگر برنامه ARCore شما با پیام خطای "Failed to create AR session" باز نمی‌شود، گزارش برنامه را بررسی کنید. اگر با خطای
java.lang.UnsatisfiedLinkErrorبا پیامی حاوی/lib/arm/libarcore_c.so" is for EM_ARM (40) instead of EM_386 (3)، ممکن است نسخه اشتباهی از برنامه Google Play Services for AR apk را نصب کرده باشید. یک دستگاه مجازی جدید ایجاد کنید و نسخه x86 را نصب کنید.