بدء استخدام AR Foundation

‫AR Foundation من Unity هو إطار عمل لعدة منصات يتيح لك كتابة تجارب الواقع المعزّز مرة واحدة، ثم إنشاء تجارب لأجهزة Android أو iOS بدون إجراء أي تغييرات إضافية. يتوفّر إطار العمل من خلال حزمة AR Foundation في Unity.

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

نقل بيانات المشاريع الحالية أو ترقيتها

  • لنقل مشروع حالي من حزمة تطوير البرامج (SDK) لـ ARCore (التي سيتم إيقافها نهائيًا) من أجل Unity إلى AR Foundation من Unity وARCore Extensions اختياريًا، يُرجى الاطّلاع على دليل نقل البيانات.
  • لترقية مشروع حالي من إصدار سابق من AR Foundation، اطّلِع على أدلة الترقية ونقل البيانات في Unity.

المتطلبات

استنادًا إلى المنصة المستهدَفة، تتطلّب حزمة AR Foundation ما يلي:

Android

الأجهزة

  • جهاز Android أو مُحاكي متوافق مع ARCore
  • كابل USB لتوصيل جهازك بجهاز التطوير

البرامج

iOS

الأجهزة

البرامج

تثبيت AR Foundation

اتّبِع الخطوات التالية لتثبيت حزمة AR Foundation Unity.

  1. افتح مشروع Unity حاليًا أو أنشئ مشروعًا ثلاثي الأبعاد جديدًا.

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

  3. بجانب Packages، انقر على Unity Registry.

  4. في شريط البحث، اكتب "AR Foundation".

  5. انقر على Install.

تثبيت حِزم المكوّنات الإضافية الخاصة بالنظام الأساسي وتفعيلها

تقدّم حزمة AR Foundation واجهة يمكن لمطوّري Unity استخدامها، ولكنها لا تنفّذ أي ميزات للواقع المعزّز بنفسها. لاستخدام AR Foundation على جهاز مستهدَف، عليك أيضًا تثبيت حِزم منفصلة وتفعيل المكوّن الإضافي المناظرِن لكل منصة.

Android

تسمح لك حزمة ARCore XR Plugin بإنشاء تطبيقات الواقع المعزّز لأجهزة Android. اتّبِع هذه الخطوات لتثبيته في مشروع Unity إذا كان تطبيقك يستهدِف أجهزة Android. استخدِم الإصدار نفسه المُستخدَم في حزمة AR Foundation لتجنُّب أي مشاكل في التوافق.

  1. في مشروعك، انتقِل إلى Window > Package Manager.

  2. بجانب Packages، اختَر Unity Registry.

  3. في شريط البحث، اكتب "ARCore XR Plugin".

  4. انقر على Install.

  5. الانتقال إلى Edit > Project Settings في XR Plug-in Management، افتح علامة التبويب Android وفعِّل ARCore.

iOS

يتيح لك مكوّن ARKit XR الإضافي إنشاء تطبيقات واقع معزّز لأجهزة iOS. اتّبِع الخطوات التالية لتثبيته في مشروع Unity إذا كان تطبيقك موجهًا لأجهزة iOS. استخدِم الإصدار نفسه لحزمة AR Foundation لتجنُّب أي مشاكل في التوافق.

  1. في مشروعك، انتقِل إلى Window > Package Manager.

  2. بجانب Packages، انقر على Unity Registry.

  3. كتابة "ARKit XR Plugin" في شريط البحث

  4. انقر على Install.

  5. الانتقال إلى Edit > Project Settings في XR Plug-in Management، افتح علامة التبويب iOS وفعِّل ARKit.

يمكنك إعداد جلسة الواقع المعزّز وإضافة مكوّنات AR Foundation إلى المشهد

يحتاج المشهد إلى جلسة الواقع المعزّز لتفعيل عمليات الواقع المعزّز، مثل تتبُّع الحركة وفهم البيئة وتقدير الإضاءة. ستحتاج إلى عناصر اللعبة التالية لتفعيل جلسة الواقع المعزّز:

AR Foundation 4.x

  • AR Session: تتحكّم هذه السياسة في مراحل نشاط تجربة الواقع المعزّز.

  • AR Session Origin: تحوّل إحداثيات الواقع المعزّز إلى إحداثيات العالم في Unity.

قبل إضافة عناصر اللعبة الجديدة، احذف العنصر التلقائي Main Camera. وسيتم استبداله برمز AR Camera جديد في AR Session Origin.

أضِف عناصر ألعاب الواقع المعزّز الجديدة إلى المشهد: انقر بزر الماوس الأيمن على pane (لوحة) Hierarchy واختَر XR. أضِف AR Session جديدًا وAR Session Origin جديدًا.

AR Foundation 5.x

  • AR Session: للتحكّم في دورة حياة تجربة الواقع المعزّز

  • XR Origin: لتحويل إحداثيات الواقع المعزّز إلى إحداثيات عالم الانسجام.

قبل إضافة عناصر اللعبة الجديدة، احذف العنصر التلقائي Main Camera. وسيتم استبداله برمز AR Camera جديد في XR Origin.

أضِف عناصر ألعاب الواقع المعزّز الجديدة إلى المشهد: انقر بزر الماوس الأيمن على pane (لوحة) Hierarchy واختَر XR. أضِف AR Session جديدًا وXR Origin جديدًا.

ضبط إعدادات المشغّل

Android

  1. انتقِل إلى File > Build Settings لفتح Build Settings النافذة.
  2. ضمن Platform، اختَر Android وانقر على Switch Platform.
  3. انقر على Player Settings.

  4. طبِّق التغييرات التالية:

    Player Settings > … القيمة
    Other Settings > Rendering أزِل العلامة من المربّع Auto Graphics API.
    إذا كان Vulkan مُدرَجًا ضمن Graphics APIs، أزِله لأنّ واجهة برمجة التطبيقات Vulkan غير متوافقة مع ARCore بعد.
    Other Settings > Package Name أنشئ معرّف تطبيق فريدًا باستخدام تنسيق اسم حزمة Java.
    على سبيل المثال، استخدِم com.example.helloAR.
    Other Settings > Minimum API Level إذا كنت بصدد إنشاء تطبيق يتطلب استخدام الواقع المعزّز، حدِّد Android 7.0 'Nougat' (API Level 24) or higher.
    إذا كنت بصدد إنشاء تطبيق AR اختياري، حدِّد Android API Level 19 or higher.
    Other Settings > Scripting Backend اختَر IL2CPP بدلاً من Mono للسماح بتفعيل التوافق مع ARM64 في الخطوة التالية.

    أثناء التطوير:

    • استخدام الإصدار Mono والإصدار 32 بت (ARMv7)
    • تثبيت حزمة APK لتطبيق ARCore بتنسيق FAT (32 بت و64 بت)

    عند الشحن إلى "متجر Play":

    • استخدام IL2CPP
    • تفعيل إصدارَي 32 بت (ARMv7) و64 بت (ARM64) لاستيفاء متطلبات إصدار 64 بت من "متجر Play"
    • اختياري (متاح في الإصدار 2018.3 والإصدارات الأحدث): في Build Settings، فعِّل Android App Bundles
    Other Settings > Target Architectures لاستيفاء متطلّبات نظام التشغيل 64 بت في Google Play، فعِّل ARM64 (ARM‏ 64 بت). يجب إبقاء ميزة "ARMv7" (ARM 32 بت) مفعّلة للتوافق مع الأجهزة التي تعمل بالإصدار 32 بت.

iOS

  1. انتقِل إلى File > Build Settings لفتح Build Settings النافذة.
  2. ضمن Platform، اختَر iOS وانقر على Switch Platform.
  3. انقر على Player Settings.

  4. اضبط الإعدادات التالية:

    Player Settings > … القيمة
    Other Settings > Bundle Identifier أضِف اسم تطبيقك بتنسيق نظام أسماء النطاقات العكسي.
    على سبيل المثال، استخدِم com.mycompany.myapp.
    Other Settings > Camera usage description يُرجى إدخال وصف لشرح استخدامك للواقع المعزّز (على سبيل المثال، ARKit).
    Other Settings > Target minimum iOS version 11.0 أو أعلى
    Other Settings > Architecture ARM64

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