إعداد بيئة التطوير
ثبِّت الإصدار 3.1 أو إصدار أحدث من Android Studio مع الإصدار 7.0 من نظام Android SDK Platform (المستوى 24 من واجهة برمجة التطبيقات) أو إصدار أحدث.
حضِّر "استوديو Android" لتطوير التطبيقات الأصلية من خلال تثبيت "حزمة تطوير البرامج (SDK) لتطبيقات Android الأصلية" (NDK) وCMake باستخدام مدير حِزم SDK. لمزيد من المعلومات، يُرجى الاطّلاع على البدء في استخدام حِزم NDK.
ستحتاج إلى الحصول على حزمة تطوير البرامج (SDK) لتطبيق ARCore على نظام التشغيل Android. يمكنك تنفيذ إجراء مما يلي:
نزِّل حزمة تطوير البرامج (SDK) لـ ARCore لنظام التشغيل Android و استخرِجها.
-أو-
استنسِخ المستودع باستخدام الأمر التالي:
git clone https://github.com/google-ar/arcore-android-sdk.git
تحضير جهازك أو المحاكي
يمكنك تشغيل تطبيقات الواقع المعزّز على جهاز متوافق أو في "محاكي Android". يجب تحديث "خدمات Google Play للواقع المعزّز" على المحاكي قبل تشغيل التطبيق. اطّلِع على مقالة تشغيل تطبيقات الواقع المعزّز في محاكي Android لمزيد من المعلومات.
فتح نموذج المشروع
في "استوديو Android"، افتح نموذج المشروع hello_ar_c في <ARCore SDK Folder>/samples/hello_ar_c.
يحتوي نموذج المشروع على تبعيات إنشاء تعتمد على إصدارات معيّنة من البرامج، مثل Gradle وحزمة تطوير البرامج (SDK) لنظام التشغيل Android. إذا لم يتم تثبيت التبعيات المطلوبة، سيطلب منك IDE الحصول على إذن لتنزيلها وتثبيتها على جهازك.
تشغيل العيّنة
تأكَّد من أنّ جهاز Android متصل بجهاز الكمبيوتر المخصّص للتطوير وانقر على رمز
Run 
في "استوديو Android"
.
ينشئ Android Studio مشروعك كملف APK قابل لتصحيح الأخطاء، ثم يُثبِّت ملف APK، ثم يشغِّل التطبيق على جهازك. لمزيد من المعلومات، اطّلِع على مقالة إنشاء تطبيقك وتشغيله.
أثناء تحريك جهازك، يرصد التطبيق تلقائيًا الأسطح المستوية ويرسم شبكة تشكل خطوطها رمزًا مثلثًا. انقر على الشبكة لوضع قطعة شطرنج ثلاثية الأبعاد من ARCore على سطحه.
استخدام "موضع الإعلان الفوري"
تسمح واجهة برمجة التطبيقات Instant Placement API للمستخدم بوضع عنصر واقع معزّز على الشاشة بدون الحاجة إلى الانتظار إلى أن يرصد ARCore هندسة السطح. يتم تحسين موضع العناصر في الوقت الفعلي عندما يتحرك المستخدم في جميع أنحاء البيئة. بعد أن يرصد ARCore الوضع الصحيح في المنطقة التي تم وضع جسم الواقع المعزّز فيها، يتم تعديل الجسم تلقائيًا ليكون دقيقًا من حيث الوضع.
انقر على الشاشة لوضع كائن. احرص على مواصلة تحريك الجهاز حولك بعد ظهور الجسم الثلاثي الأبعاد على الشاشة، حتى تتمكّن منصة ARCore من الحصول على بيانات كافية عن محيطك لتثبيت الجسم الافتراضلبدقة.
في الشكل 1، يكون موضع الإعلان الفوري غير مفعّل وشكل السطح غير محدّد. تبدو الأجسام الموضوعة على الأرض على يسار طاولة البلياردو (أربع نقاط زرقاء صغيرة) مُسقطة، ووضعها غير محدّد.
في الشكل 2، تم تفعيل "الموضع الفوري" من القائمة ضمن رمز الترس.
في الشكل 3، تم وضع عنصر جديد في المشهد مع تفعيل ميزة "الموضع الفوري". يظهر هذا الرمز باللون الرمادي بدلاً من اللون للإشارة إلى أنّه لم يتم تعديله بعد لعرض وضعية دقيقة.
في الشكل 4، يصبح الجسم الجديد ملونًا، وتكون وضعيته دقيقة، عند رصد هندسة السطح (الموصوفة بخطوط الشبكة القابلة للتتبُّع).
استخدام "العمق"
عند تفعيل العمق، تأخذ ARCore شكل الأجسام في المشهد وموقعها الجغرافي في الاعتبار، وتحسب موقع الأجسام التي تم وضعها في المشهد بالنسبة إلى الأجسام الأخرى في المشهد. ويسمح هذا التأثير بتمويه العناصر المُدرَجة بواسطة عناصر في المشهد، ما يضفي واقعية على تطبيقك.
في الشكل 1، تكون ميزة "العمق" غير مفعّلة. تم وضع جسم تحت طاولة البلياردو.
في الشكل 2، أثناء تحرك الجهاز حول طاولة البلياردو، يبدو أنّ الجسم يتّبع الجهاز بغض النظر عن الأجسام في المشهد.
في الشكل 3، تكون ميزة "العمق" مفعّلة.
في الشكل 4، يبدو أنّ الجسم مُحجب الآن بواسطة طاولة البلياردو أثناء تحرك الجهاز حول المشهد.
الخطوات التالية
- تعرَّف على كيفية تفعيل ARCore في تطبيقك.
- استخدِم الصور المعزّزة لإنشاء تطبيقات يمكنها الاستجابة للصور ثنائية الأبعاد، مثل الملصقات أو الشعارات، في بيئة المستخدم.
- استخدام مراسي السحابة الإلكترونية
- استخدِم Depth API لضمان توفير عمق دقيق لتوفير تجارب واقعية وغامرة للمستخدمين.
- استخدِم ميزة الوضع الفوري لتحديد مكان عناصر الواقع المعزّز على الشاشة بسرعة.
- راجِع الاعتبارات المتعلّقة بوقت التشغيل.
- راجِع إرشادات التصميم.