بدء استخدام إضافات ARCore لـ AR Foundation

تضيف حزمة ARCore الإضافات الاختيارية لـ AR Foundation وظائف إلى حزمة AR Foundation في Unity، ما يتيح لك استخدام ميزات مثل Cloud Anchors وفلاتر إعداد الكاميرا والتسجيل والتشغيل في تطبيقك.

المتطلّبات

للتطوير باستخدام إضافات ARCore for AR Foundation، ستحتاج إلى ما يلي:

Android

الأجهزة

البرامج

iOS

الأجهزة

البرامج

تثبيت حزمة إضافات ARCore

يُرجى اتّباع الخطوات التالية لتثبيت ARCoreextensions for AR Foundation.

التبعيات المجمَّعة

  1. يجب تثبيت وإعداد AR Foundation في بيئة التطوير.
  2. افتح أو أنشئ مشروع Unity جديدًا.
  3. اختَر النظام الأساسي المستهدَف للإصدار المطلوب:
    1. من قائمة "File"، اختَر Build Settings.
    2. اختَر Android أو iOS وفقًا للنظام الأساسي المستهدَف المطلوب.
    3. انقر على Switch Platform

  4. استيراد أحدث حزمة من إضافات ARCore:

    1. الانتقال إلى Window > Package Manager

    2. انقر على الزر واختَر Add package from git URL... من القائمة المنسدلة.

    3. الصق عنوان URL التالي في حقل النص:

      https://github.com/google-ar/arcore-unity-extensions.git

    4. انقر على Add

بدون EDM4U

يتم تضمين إضافات ARCore في حزمة مع تبعيات إضافية بشكل تلقائي. عند استخدام مكتبات أخرى (مثل إحصاءات Firebase) تعتمد على إصدار مختلف من أداة إدارة التبعيات الخارجية لـ Unity، قد يحدث سلوك غير محدّد، ما يؤدي إلى توقّف عمل العناصر التابعة بشكل صحيح.

يمكنك تثبيت إضافات ARCore بدون تبعيات مُجمَّعة لمنع التعارضات بشأن إصدارات المكتبة:

  1. يمكنك تنزيل إضافات ARCore بدون إصدار EDM4U وcom.google.external-dependency-manager،
  2. اتبع التعليمات المتعلقة باستيراد حزم UPM مع ملفات .tgz، وتثبيت الحزم بالترتيب التالي:
    1. com.google.external-dependency-manager,
    2. إضافات ARCore (بدون EDM4U)

عند تثبيت ARCore Extensions، سيقوم Unity أيضًا بتثبيت إصدار مناسب من التبعيات المطلوبة:

  • AR Foundation
  • ARCore XR Plugin (يتم استخدامه عند استهداف Android)
  • ARKit XR Plugin (يُستخدم عند استهداف iOS)

قد لا تكون هذه التبعيات مرئية في طريقة عرض Package Manager > Package: In project. ومع ذلك، يمكن رؤية الحزم في نافذة Project ضمن القسم Packages.

إعداد إضافات ARCore

الإصدار 4.x من AR Foundation

  1. في لوحة Hierarchy، انقر بزر الماوس الأيمن وأضِف كائنات اللعبة التالية (إذا لم تكن قد أضفتها):

    • XR > AR Session
    • XR > AR Session Origin
    • XR > ARCore Extensions

  2. في لوحة Hierarchy، اختَر حزمة ARCore Extensions.

  3. في لوحة Inspector، في كل من الحقول التالية، انقر على زر الاستهداف واربط كل حقل بكائن اللعبة المقابل له، على النحو التالي:

    • Session: استخدِم AR Session للمشهد.
    • AR Session Origin: استخدِم AR Session Origin الخاصة بالمشهد.
    • Camera Manager: استخدِم AR Camera للمشهد.

  4. يمكنك اختياريًا إنشاء وربط مواد العرض التالية لميزة "ثبات Cloud" وفلاتر ضبط الكاميرا.

    1. في لوحة Project > Assets، انقر بزر الماوس الأيمن، ثم اختَر Create > XR > ARCore Extensions Config.

    2. في لوحة Project > Assets، انقر بزر الماوس الأيمن، ثم اختَر Create > XR > Camera Config Filter.

    3. في لوحة Hierarchy، اختَر حزمة ARCore Extensions.

    4. في الحقل ARCore Extensions Config في جزء Inspector، انقر على الزر المستهدف وأنشئ الربط بمادة العرض ARCoreExtensionsConfig.

    5. في الحقل Camera Config Filter في جزء Inspector، انقر على الزر المستهدف وأنشئ الربط بمادة العرض ARCoreExtensionsCameraConfigFilter.

      لمعرفة المزيد من المعلومات، يُرجى الاطّلاع على دليل مطوّر البرامج الثابتة في السحابة الإلكترونية ودليل ضبط الكاميرا.

    6. إذا كنت تستخدم إصدار Unity أقدم من 2020.3:

      • اختَر نموذج خصائص Gradle المخصصة في إعدادات المشروع > المشغّل > Android > إعدادات النشر > إصدار.

مع ربط جميع حقول إضافات ARCore أعلاه بشكل مناسب، تظهر لوحة Inspectorإضافات ARCore على النحو التالي:

الإصدار 5.x من تطبيق AR Foundation

  1. في لوحة Hierarchy، انقر بزر الماوس الأيمن وأضِف كائنات اللعبة التالية (إذا لم تكن قد أضفتها):

    • XR > AR Session
    • XR > XR Origin (Mobile AR)
    • XR > ARCore Extensions

  2. في لوحة Hierarchy، اختَر حزمة ARCore Extensions.

  3. في لوحة Inspector، في كل من الحقول التالية، انقر على زر الاستهداف واربط كل حقل بكائن اللعبة المقابل له، على النحو التالي:

    • Session: استخدِم AR Session للمشهد.
    • XR Origin: استخدِم XR Origin الخاصة بالمشهد.
    • Camera Manager: استخدِم AR Camera للمشهد.

  4. يمكنك اختياريًا إنشاء وربط مواد العرض التالية لميزة "ثبات Cloud" وفلاتر ضبط الكاميرا.

    1. في لوحة Project > Assets، انقر بزر الماوس الأيمن، ثم اختَر Create > XR > ARCore Extensions Config.

    2. في لوحة Project > Assets، انقر بزر الماوس الأيمن، ثم اختَر Create > XR > Camera Config Filter.

    3. في لوحة Hierarchy، اختَر حزمة ARCore Extensions.

    4. في الحقل ARCore Extensions Config في جزء Inspector، انقر على الزر المستهدف وأنشئ الربط بمادة العرض ARCoreExtensionsConfig.

    5. في الحقل Camera Config Filter في جزء Inspector، انقر على الزر المستهدف وأنشئ الربط بمادة العرض ARCoreExtensionsCameraConfigFilter.

      لمعرفة المزيد من المعلومات، يُرجى الاطّلاع على دليل مطوّر البرامج الثابتة في السحابة الإلكترونية ودليل ضبط الكاميرا.

    6. إذا كنت تستخدم إصدار Unity أقدم من 2020.3:

      • اختَر نموذج خصائص Gradle المخصصة في إعدادات المشروع > المشغّل > Android > إعدادات النشر > إصدار.

مع ربط جميع حقول إضافات ARCore أعلاه بشكل مناسب، تظهر لوحة Inspectorإضافات ARCore على النحو التالي:

راجِع دليل Unity حول تعديل الخصائص للحصول على مزيد من المعلومات حول إعداد الخصائص.

نماذج المشاريع

يتضمّن تنسيق ARCoreextensions for AR Foundation نماذج مشاريع يمكنك استخدامها للبدء في إنشاء مشاريعك الخاصة.

  1. من قائمة Window، افتح Package Manager واختَر حزمة ARCore Extensions.

  2. ضمن Samples، انقر على Import لنموذج المشروع الموضح أدناه.

يتم استيراد نماذج المشاريع التالية من مستودع جيت هب:

  • الموقع الجغرافي المكاني (نظام التشغيل Android فقط) - يمكنك إنشاء تجارب الواقع المعزّز على نطاق عالمي، وإرفاق المحتوى عن بُعد بأي منطقة تغطيها ميزة "التجوّل الافتراضي من Google". راجع مقدمة واجهة برمجة التطبيقات الجغرافية المكانية للحصول على مزيد من المعلومات.

  • PersistentCloudAnchors (لنظامي التشغيل Android وiOS) - يمكنك إنشاء تجارب واقع معزّز مستدامة على أرض الواقع باستخدام طبقات تفاعلية من المعلومات الرقمية الثابتة في مواقع جغرافية فعلية، وتجارب صمِّم يمكن مشاركتها مع مرور الوقت من قِبل عدة مستخدمين على العديد من الأجهزة المختلفة. يُرجى الاطّلاع على مقدمة حول Cloud Anchors لمزيد من المعلومات.

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

باستخدام إضافات ARCore for AR Foundation، يمكنك الآن استخدام Cloud Anchors وإعدادات الكاميرا في تطبيقاتك.