لبدء استخدام ARCore مع Android، يمكنك تشغيل نموذج التطبيق hello_ar_kotlin أو hello_ar_java المضمّن في حزمة SDK لـ ARCore. تستخدِم نماذج التطبيقات هذه OpenGL، وهي واجهة برمجة لعرض الرسومات المتجهّة ثنائية وثلاثية الأبعاد. تعرِض التطبيقات أيّ طائرات تم رصدها وتسمح للمستخدم بالنقر على طائرة لوضع نموذج ثلاثي الأبعاد.
إعداد بيئة التطوير
ثبِّت الإصدار 3.1 أو إصدار أحدث من Android Studio مع الإصدار 7.0 من نظام Android SDK Platform (المستوى 24 من واجهة برمجة التطبيقات) أو إصدار أحدث.
إذا كنت مبتدئًا في استخدام Android، اطّلِع على مقالة إنشاء تطبيق Android الأول.
فتح نموذج مشروع
في "استوديو Android"، استنسِخ مستودع ARCore SDK على GitHub.
هناك العديد من الطرق لإجراء ذلك:
في ما يتعلّق بإصدار "استوديو Android" المثبَّت:
- من قائمة Git، انقر على Clone.
- في القائمة المنسدلة Version control ، اختَر Git كنظام التحكّم في الإصدارات.
في الحقل URL، أدخِل عنوان URL التالي لمستودع GitHub الخاص بـ ARCore:
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 على سطح مستوٍ للواقع المعزّز تم رصده. ويتم تنفيذه باستخدام Android GL SurfaceView،
الذي يُستخدَم لعرض معاينة الكاميرا وعناصر الواقع المعزّز الأساسية، مثل المستويات
والعناصر الثابتة. يمكن العثور على نموذج إطار عمل العرض في hello_ar_java في
com/google/ar/core/examples/java/common/samplerender.
استخدام "موضع الإعلان الفوري"
تسمح واجهة برمجة التطبيقات Instant Placement API للمستخدم بوضع عنصر واقع معزّز على الشاشة بدون الحاجة إلى انتظار ARCore لرصد شكل السطح. يتم تحسين موضع العناصر في الوقت الفعلي عندما يتحرك المستخدم في جميع أنحاء البيئة.
انقر على الشاشة لوضع كائن. احرص على مواصلة تحريك الجهاز حولك بعد ظهور الجسم الثلاثي الأبعاد على الشاشة، حتى تتمكّن منصة ARCore من الحصول على بيانات كافية عن محيطك لتثبيت الجسم الافتراضلبدقة.
بعد أن يرصد ARCore هندسة السطح وينشئ كائنًا قابلاً للتتبُّع في المنطقة التي تم وضع الجسم فيها، يتم تعديل وضع الجسم تلقائيًا لتحقيق الدقة.
في الشكل 1، يكون موضع الإعلان الفوري غير مفعّل وشكل السطح غير محدّد. تبدو الأجسام الموضوعة على الأرض على يسار طاولة البلياردو (أربع نقاط زرقاء صغيرة) مُسقطة، ووضعها غير محدّد.
في الشكل 2، تم تفعيل "الموضع الفوري" من القائمة ضمن رمز الترس.
في الشكل 3، تم وضع عنصر جديد في المشهد مع تفعيل ميزة "الموضع الفوري". يظهر هذا الرمز باللون الرمادي بدلاً من اللون للإشارة إلى أنّه لم يتم تعديله بعد لعرض وضعية دقيقة.
في الشكل 4، يصبح الجسم الجديد ملونًا، وتكون وضعيته دقيقة، عند رصد هندسة السطح (الموصوفة بخطوط الشبكة القابلة للتتبُّع).
استخدام "العمق"
عند تفعيل العمق، تأخذ ARCore شكل الأجسام في المشهد وموقعها الجغرافي في الاعتبار، وتحسب موقع الأجسام التي تم وضعها في المشهد بالنسبة إلى الأجسام الأخرى في المشهد. ويسمح هذا التأثير بتمويه العناصر المُدرَجة بواسطة عناصر في المشهد، ما يضفي واقعية على تطبيقك.
في الشكل 1، تكون ميزة "العمق" غير مفعّلة. تم وضع جسم تحت طاولة البلياردو.
في الشكل 2، أثناء تحرك الجهاز حول طاولة البلياردو، يبدو أنّ الجسم يتّبع الجهاز بغض النظر عن الأجسام في المشهد.
في الشكل 3، تكون ميزة "العمق" مفعّلة.
في الشكل 4، يبدو أنّ الجسم مُحجب الآن بواسطة طاولة البلياردو أثناء تحرك الجهاز حول المشهد.
الخطوات التالية
- جرِّب إنشاء مشاريع نموذجية أخرى وتشغيلها في حزمة تطوير البرامج (SDK) لـ ARCore.
- اطّلِع على معامل رموز الواقع المعزَّز للاطّلاع على المزيد من نماذج التطبيقات التي يمكنك إنشاؤها وتشغيلها.
- تعرَّف على كيفية تفعيل ARCore في تطبيقك.
- راجِع الاعتبارات المتعلقة بوقت التشغيل.
- راجِع إرشادات التصميم.