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

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

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

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

  • لنقل مشروع حالي من حزمة ARCore SDK for Unity (المتوقّفة نهائيًا) إلى AR Foundation في Unity، بالإضافة إلى ARCoreextensions اختياريًا، يُرجى الاطّلاع على دليل نقل البيانات.
  • لترقية مشروع حالي من إصدار سابق من 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 إنشاء تطبيقات الواقع المعزّز لأجهزة Android. اتّبِع هذه الخطوات لتثبيته في مشروع Unity إذا كان تطبيقك يستهدف أجهزة Android. استخدِم الإصدار نفسه المُستخدَم في حزمة AR Foundation لتجنّب حدوث أي مشاكل في التوافق.

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

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

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

  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".

  4. انقر على Install

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

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

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

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

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

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

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

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

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

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

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

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

أضِف عناصر لعبة الواقع المعزّز الجديدة إلى المشهد: انقر بزر الماوس الأيمن على لوحة 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 Optional، حدِّد Android API Level 19 or higher.
    Other Settings > Scripting Backend اختَر IL2CPP بدلاً من Mono للسماح بتفعيل دعم ARM64 في الخطوة التالية.

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

    • استخدِم Mono + 32 بت (ARMv7)
    • تثبيت حِزمة ARCore APK متوافقة مع 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 (أي 64 بت ARM). اترك ARMv7 (32 بت ARM) مفعَّلاً للتوافق مع الأجهزة التي تعمل بنظام 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

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