نشكرك على متابعة مؤتمر Google I/O. اطّلِع على الجلسات.

بدء استخدام مؤسسة الواقع المعزّز

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

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

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

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

المتطلبات

وفقًا للنظام الأساسي المُستهدَف، تتطلب حزمة AR Foundation ما يلي:

Android

الأجهزة

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

البرامج

iOS

الأجهزة

البرامج

تثبيت مؤسسة الواقع المعزّز

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

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

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

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

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

  5. انقر على Install

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

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

Android

تسمح لك حزمة ARCore XR Plugin بتصميم تطبيقات الواقع المعزّز لأجهزة 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 Plugin تصميم تطبيقات الواقع المعزّز لأجهزة 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 Session: تتحكّم هذه السياسة في دورة حياة تجربة الواقع المعزّز.

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

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

إضافة كائنات لعبة الواقع المعزّز الجديدة إلى المشهد: انقر بزر الماوس الأيمن على الجزء Hierarchy واختَر XR. أضف AR Session وكائن لعبة AR Session 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 أنشئ رقم تعريف تطبيق فريدًا باستخدام تنسيق اسم حزمة جافا.
    على سبيل المثال، استخدم com.example.helloAR.
    Other Settings > Minimum API Level في حال إنشاء تطبيق AR مطلوب، يُرجى تحديد 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)
    • تثبيت حزمة APK FAT (32 بت + 64 بت) ARCore

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

    • استخدام IL2CPP
    • تفعيل كل من الإصدار 32 بت (ARMv7) و64 بت (ARM64) لتلبية متطلبات "متجر Play" الإصدار 64 بت
    • اختياري (مدعوم بالإصدار 2018.3 والإصدارات الأحدث): في Build Settings، يجب تفعيل Android App Bundles
    Other Settings > Target Architectures لاستيفاء متطلبات نظام 64 بت على Google Play، فعِّل ARM64 (التفعيل ARM بنظام 64 بت). اترك 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

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