البدء السريع لواجهة برمجة التطبيقات Depth API لـ Android NDK

  • إعداد بيئة التطوير لواجهة برمجة التطبيقات Depth API
  • جرِّب التظليل واعرض خريطة العمق في نموذج تطبيق

المتطلبات الأساسية

  • استوديو Android الإصدار 3.1 أو إصدار أحدث مع الإصدار 7.0 (مستوى واجهة برمجة التطبيقات 24) أو الإصدارات الأحدث من Android SDK Platform
  • جهاز Android يتوافق مع Depth API راجع قائمة الأجهزة المتوافقة مع ARCore للحصول على التفاصيل.
  • فهم أساسي لتطوير Android إذا كنت مستخدمًا جديدًا لنظام التشغيل Android، يمكنك الاطّلاع على مقالة إنشاء أول تطبيق Android للمبتدئين.
  • فهم أساسي لواجهة برمجة التطبيقات Depth API. إذا كنت جديدًا في استخدام Depth، فراجع Depth API.

فتح نموذج المشروع

يستخدم البدء السريع هذا OpenGL، وهي واجهة برمجة لعرض الرسومات المتجهة ثنائية الأبعاد وثلاثية الأبعاد. راجع تفعيل ARCore قبل البدء بالخطوات التالية.

احصل على نموذج المشروع عن طريق استنساخ المستودع باستخدام الأمر التالي:

git clone https://github.com/google-ar/arcore-android-sdk.git

في "استوديو Android"، افتح نموذج المشروع hello_ar_c.

تشغيل العيّنة

يتيح لك نموذج تطبيق Depth API إمكانية وضع أشكال Android افتراضية في محيطك، وتبديل التظليل بحيث ترى الفرق. كما يتيح لك تبديل تصور الخريطة العمق في مساحة معينة.

تأكَّد من اتصال جهاز Android بجهاز التطوير وانقر على Run في "استوديو Android".

قد يطلب منك جهازك تثبيت أو تحديث خدمات Google Play للواقع المعزّز إذا كانت غير متوفّرة أو قديمة. انقر على CONTINUE لتثبيته من متجر Google Play.

تفعيل العمق

في المرة الأولى التي يتم فيها تشغيل التطبيق ووضع أحد أشكال Android، سيطلب منك مربع الحوار تمكين العمق. يظهر فقط في المرة الأولى التي يتم فيها تشغيل التطبيق، لأول مرة في نظام Android. انقر على Enable لإضافة تظليل.

التبديل بين التظليل والتمثيل المرئي لخريطة العمق

انقر على رمز الترس لتبديل التظليل وعرض خريطة العمق. اختَر Enable depth لتفعيل ميزة التظليل. اختَر "Show depth map" لعرض خريطة العمق على شاشة الجهاز.

على سبيل المثال، تُظهر الصور التالية شكل Android افتراضيًا في مساحة حقيقية تحتوي على صندوق بجانب باب. في الصورة الأولى، يتداخل نظام Android الافتراضي بشكل غير واقعي مع حافة صندوق السيارة. في الصورة الثانية، يظهر هاتف Android مُغطى بشكل صحيح، حيث يبدو أكثر واقعية من حيث محيطه.

تعرض الصور التالية صورة كاميرا لمدخل مع دراجة على الحائط، بالإضافة إلى عرض لخريطة العمق التي تم إنشاؤها لهذه الصورة.

الخطوات التالية

يمكنك بدء استخدام Depth API في تطبيقاتك الخاصة. لمزيد من المعلومات، يُرجى الاطّلاع على: