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

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

تضيف حزمة إضافات ARCore لإطار عمل الواقع المعزّز الاختيارية في ARCore وظائف إضافية، ما يتيح لك استخدام ميزات مثل محطات الربط في السحابة الإلكترونية، فلاتر ضبط الكاميرا، وتسجيل المحتوى وتشغيله في تطبيقك.

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

المتطلبات

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

AndroidiOS

الأجهزة

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

البرامج

الأجهزة

البرامج

تثبيت AR Foundation

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

  1. افتح مشروع Unity حاليًا أو أنشئ مشروعًا ثلاثي الأبعاد جديدًا.
  2. انتقِل إلى Window > Package Manager.

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

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

  5. انقر على Install.

  6. ضبط مسار التقديم

    AR Foundation 4.xAR Foundation 5.xAR Foundation 6.x

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

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

AndroidiOS

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

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

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

  3. في شريط البحث، اكتب "مكوّن ARCore الإضافي لتجربة الواقع المعزّز".

  4. انقر على Install.

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

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

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

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

  3. في شريط البحث، اكتب "مكوّن ARKit XR الإضافي".

  4. انقر على Install.

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

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

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

AR Foundation 4.xAR Foundation 5.xAR Foundation 6.x

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

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

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

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

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

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

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

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

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

AndroidiOS
  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 بت.
  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

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