لبدء استخدام ARCore مع Android، يمكنك تشغيل نموذج التطبيق hello_ar_kotlin أو hello_ar_java المضمن في ARCore. تستخدم نماذج التطبيقات هذه OpenGL، وهو واجهة برمجة لعرض الرسومات المتجهة ثنائية وثلاثية الأبعاد. تعرض التطبيقات أي طائرات تم اكتشافها وتسمح للمستخدم بالنقر على طائرة لوضع نموذج ثلاثي الأبعاد.
إعداد بيئة التطوير
ثبِّت استوديو Android الإصدار 3.1 أو إصدار أحدث مع Android SDK Platform الإصدار 7.0 (مستوى واجهة برمجة التطبيقات 24) أو أعلى.
إذا كنت مستخدمًا جديدًا لنظام التشغيل Android، راجِع إنشاء أول تطبيق Android.
فتح نموذج مشروع
في 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
افتح أحد المشروعات النموذجية على النحو التالي (يجب عليك فتح أحد المشروعات بوضوح لإنشائه وتشغيله).
- من القائمة File، اختر Open.
- في المجلد arcore-android-sdk/samples، اختَر إما المجلد hello_ar_kotlin أو hello_ar_java وانقر على Open.
إعداد الجهاز أو المحاكي
يمكنك تشغيل تطبيقات الواقع المعزّز على جهاز متوافق أو في محاكي Android. يجب تحديث "خدمات Google Play للواقع المعزّز" على المحاكي قبل تشغيل التطبيق. للحصول على مزيد من المعلومات، يمكنك الاطّلاع على تشغيل تطبيقات الواقع المعزّز في "محاكي Android" .
تشغيل النموذج
تأكّد من اتصال جهاز Android بجهاز التطوير وانقر على
Run في Android Studio.
يُنشئ Android Studio مشروعك في حزمة APK يمكن تصحيح أخطائها، ويثبِّت APK، ثم يشغِّل التطبيق على جهازك. لمزيد من المعلومات، يمكنك الاطّلاع على إنشاء تطبيقك وتشغيله.
قد يُطلب منك تثبيت خدمات Google Play للواقع المعزّز أو تحديثها في حال كانت مفقودة أو قديمة. حدد CONTINUE لتثبيته من متجر Google Play، أو تحديثه يدويًا كما هو موضح في تحديث خدمات Google Play للواقع المعزّز.
يتيح لك تطبيق hello_ar_java وضع رهن ARCore ثلاثي الأبعاد على أسطح طائرات AR المكتشفة. ويتم تنفيذه مع Android GL SurfaceView الذي يُستخدَم لعرض معاينة الكاميرا وكائنات الواقع المعزّز الأساسية، مثل "الطائرات" و"الارتساء". يمكن الاطّلاع على إطار عمل عرض نموذج hello_ar_java في
com/google/ar/core/examples/java/common/samplerender
.
استخدام الموضع الفوري
تسمح واجهة برمجة تطبيقات الموضع الفوري للمستخدم بوضع كائن الواقع المعزّز على الشاشة بدون الحاجة إلى انتظار ARCore لاكتشاف هندسة السطح. يتم تحسين موضع العنصر في الوقت الفعلي بينما يتحرك المستخدم أكثر في محيطه.
انقر على الشاشة لوضع كائن. تأكد من الاستمرار في تحريك الجهاز بعد مشاهدة الكائن المجسم على الشاشة، حتى يتمكن ARCore من الحصول على بيانات كافية عن الأشياء المحيطة بك لتثبيت الكائن الافتراضي بدقة.
بعد أن يكتشف ARCore هندسة السطح وينشئ مسارًا قابلاً للتتبُّع في المنطقة التي يُوضع فيها الكائن، يتم تعديل وضع الكائن تلقائيًا من أجل الدقة.
في الشكل 1، تم تعطيل الموضع الفوري بينما لم يتم تحديد هندسة السطح. وتبدو الكائنات الموضوعة على الأرض إلى يمين طاولة البلياردو (أربع نقاط زرقاء صغيرة) غير مدرَجة، مع عدم تحديد أوضاعها.
في الشكل 2، يتم تمكين الموضع الفوري من القائمة أسفل رمز الترس.
في الشكل 3، مع تمكين الموضع الفوري، يتم وضع كائن جديد في المشهد. ويظهر باللون الرمادي بدلاً من اللون، للإشارة إلى أنه لم يتم تصحيحه للحصول على وضع دقيق حتى الآن.
في الشكل 4، يصبح الكائن الجديد ملونًا، ويكون وضعيته دقيقًا، عندما يتم اكتشاف الشكل الهندسي السطحي (الموضح بخطوط الشبكة القابلة للتتبع).
استخدام مستوى العمق
عند تمكين العمق، يأخذ ARCore في الاعتبار الهندسة ومكان الكائنات في المشهد ويحسب موقع الكائنات الموضوعة في المشهد بالنسبة إلى الكائنات الأخرى في المشهد. ويسمح ذلك بإخفاء العناصر الموضوعة بواسطة كائنات في المشهد، كما يضفي الواقعية على تطبيقك.
في الشكل 1، تم تعطيل العمق. يتم وضع كائن أسفل جدول البلياردو.
في الشكل 2، بينما يتحرك الجهاز حول جدول حمام السباحة، يظهر الكائن لاتباع الجهاز بغض النظر عن الكائنات الموجودة في المشهد.
في الشكل 3، تم تمكين العمق.
في الشكل 4، يظهر الكائن الآن مسدودًا بواسطة جدول المسبح أثناء تحرك الجهاز حول المشهد.
الخطوات التالية
- حاول إنشاء وتشغيل نماذج مشاريع أخرى في ARCore SDK.
- اطّلِع على مختبَرات ترميز الواقع المعزّز للحصول على مزيد من نماذج التطبيقات التي يمكنك إنشاؤها وتشغيلها.
- تعرّف على كيفية تمكين ARCore في تطبيقك.
- راجِع اعتبارات وقت التشغيل.
- راجع إرشادات التصميم.