تحديث إلى الإصدار 5.x من AR Foundation (إصدار تجريبي)

تنبيه: تتوافق إضافات ARCore الإضافات في Unity's AR Foundation مع الإصدار 5.x من حزمة AR Foundation، ولكن قد يتضمّن نقل بيانات مشروعك الحالي خطوات أكثر مما هو موضّح في هذا المستند. يمكنك استخدام هذا المستند كمرجع، ولكن نعمل حاليًا على إنشاء نسخة جديدة متوافقة مع الإصدارَين 5.x و 6.x.

تتوافق ARCore extensions for Unity's AR Foundation مع الإصدارين 4.x والإصدارين 5.x من AR Foundation. لترقية مشروع الواقع المعزّز الحالي إلى AR Foundation 5.x من AR Foundation 4.x، اتّبِع الخطوات التالية:

1. فقط في Unity 2021.x أو الإصدارات الأقدم:
   ترتبط بعض حِزم Unity بإصدارات معيّنة من Unity Editor. قد تحتاج إلى تعديل بيان الحزمة في مشروع Unity لتحديثه إلى AR Foundation 5.x في إصدارات معيّنة من Unity Editor. لمزيد من المعلومات، يُرجى الاطّلاع على Access AR Foundation 5.0 في Unity 2021.

   تأكَّد من أنّ Packages/manifest.json يحتوي على هذه الإصدارات للحِزم التالية:

   "dependencies": {
     -- other dependencies --
     "com.unity.xr.arcore": "5.0.5",
     "com.unity.xr.arfoundation": "5.0.5",
     "com.unity.xr.arkit": "5.0.5",
     -- other dependencies --
   }
   

2. تستخدم مؤسسة ARCore Networks for Unity's AR Foundation ARCORE_USE_ARF_5 رمز البرمجة النصية المخصصة لتحديد مدى توافق الإصدار. للتوافق مع AR Foundation 5.x، أضِف رمز البرمجة النصية المخصّص ARCORE_USE_ARF_5:

   1. في تعديل > إعدادات المشروع > المشغّل > إعدادات أخرى، انتقِل للأسفل إلى تجميع النصوص البرمجية.
   2. استخدِم الزرّ + لإضافة ARCORE_USE_ARF_5.
   3. حدّد تطبيق.

3. تتطلب AR Foundation الإصدار 5.x حزمة نظام الإدخال بسبب اعتمادها على TrackedPoseDriver. تتطلّب نماذج إضافات ARCore وحدة الإدخال القديمة.

   لدعم كل من حزمة نظام الإدخال ومدير الإدخال القديم، في إعدادات المشروع > المشغّل > إعدادات أخرى، عيِّن معالجة الإدخال النشط على كلاهما.

4. اتّبِع الخطوات الأخرى الواردة في أدلة الترقية ونقل البيانات من Unity's AR Foundation.