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

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

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

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

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

المتطلبات

بناءً على النظام الأساسي المستهدَف، تتطلب حزمة "AR Foundation" التالي:

Android

الأجهزة

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

البرامج

iOS

الأجهزة

البرامج

تثبيت AR Foundation

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

  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 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: تحويل إحداثيات الواقع المعزَّز إلى الانسجام الإحداثيات العالمية.

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

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

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

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

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

قبل إضافة كائنات اللعبة الجديدة، احذف 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"، عليك إزالتها لأنّ ARCore لا يتيح استخدام Vulkan بعد.
    Other Settings > Package Name أنشِئ معرّف تطبيق فريدًا باستخدام تنسيق اسم حزمة Java.
    على سبيل المثال، يمكنك استخدام com.example.helloAR.
    Other Settings > Minimum API Level إذا كنت بصدد إنشاء تطبيق بحاجة إلى الواقع المعزّز، حدِّد Android 7.0 'Nougat' (API Level 24) or higher.
    إذا كنت تنشئ تطبيقًا اختياريًا للواقع المعزّز، حدِّد Android API Level 19 or higher.
    Other Settings > Scripting Backend اختر IL2CPP بدلاً من Mono للسماح بتفعيل دعم ARM64 في الخطوة التالية.

    خلال مرحلة التطوير:

    • استخدِم Mono + 32 بت (ARMv7)
    • تثبيت FAT (32 بت + 64 بت) ARCore APK

    عند الشحن إلى "متجر 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" (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

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