شروع به کار با ARCore Extensions for AR Foundation

بسته اختیاری ARCore Extensions for AR Foundation عملکردی را به بسته AR Foundation Unity اضافه می کند و به شما امکان می دهد از ویژگی هایی مانند Cloud Anchors ، فیلترهای پیکربندی دوربین و ضبط و پخش در برنامه خود استفاده کنید.

الزامات

برای توسعه با ARCore Extensions for AR Foundation، به موارد زیر نیاز دارید:

اندروید

سخت افزار

• یک دستگاه اندرویدی با پشتیبانی از ARCore
• یک کابل USB برای اتصال دستگاه شما به دستگاه توسعه شما

نرم افزار

• Unity 2019.4.3f1 یا جدیدتر با پشتیبانی از ساخت اندروید
• AR Foundation 4.1.5 یا جدیدتر (به طور خودکار با ARCore Extensions for AR Foundation SDK نصب می‌شود)
• پلاگین ARCore XR نسخه 4.1.5 یا جدیدتر (به طور خودکار با ARCore Extensions for AR Foundation SDK نصب می شود)

iOS

سخت افزار

• یک دستگاه سازگار با ARKit و پشتیبانی از ARCore
• یک کابل USB برای اتصال دستگاه شما به دستگاه توسعه شما

نرم افزار

• Unity 2019.4.3f1 یا جدیدتر با پشتیبانی از ساخت iOS
• AR Foundation 4.1.5 یا جدیدتر (به طور خودکار با ARCore Extensions for AR Foundation SDK نصب می‌شود)
• پلاگین ARKit XR نسخه 4.1.5 یا جدیدتر (به طور خودکار با افزونه های ARCore برای AR Foundation SDK نصب می شود)
• Xcode 11.0 یا بالاتر

بسته ARCore Extensions را نصب کنید

برای نصب ARCore Extensions for AR Foundation این مراحل را دنبال کنید.

وابستگی های همراه

1. مطمئن شوید که AR Foundation را در محیط توسعه خود نصب و پیکربندی کرده اید.
2. یک پروژه یونیتی جدید باز یا ایجاد کنید.
3. پلت فرم ساخت هدف مورد نظر را انتخاب کنید:
   1. از منوی File ، Build Settings انتخاب کنید.
   2. بسته به پلتفرم مورد نظر Android یا iOS را انتخاب کنید.
   3. Switch Platform کلیک کنید.

4. وارد کردن آخرین بسته ARCore Extensions:

   1. به Window > Package Manager بروید.

   2. کلیک کنید بر روی را فشار دهید و گزینه Add package from git URL... را از منوی کشویی انتخاب کنید.
      

   3. آدرس زیر را در قسمت متن قرار دهید:

      https://github.com/google-ar/arcore-unity-extensions.git
      

   4. Add کلیک کنید.

بدون EDM4U

به طور پیش‌فرض، برنامه‌های افزودنی ARCore با وابستگی‌های اضافی همراه است. هنگام استفاده از کتابخانه های دیگر (به عنوان مثال Firebase Analytics ) که به نسخه دیگری از External Dependency Manager برای Unity وابسته هستند، ممکن است رفتار نامشخصی رخ دهد که باعث شود وابستگان به درستی کار نکنند.

برای جلوگیری از تداخل نسخه‌سازی کتابخانه، برنامه‌های افزودنی ARCore را بدون وابستگی‌های همراه نصب کنید:

1. برنامه های افزودنی ARCore را بدون نسخه EDM4U دانلود کنید و com.google.external-dependency-manager دانلود کنید،
2. دستورالعمل‌های وارد کردن بسته‌های UPM با فایل‌های .tgz را دنبال کنید و بسته‌ها را به ترتیب زیر نصب کنید:
   1. com.google.external-dependency-manager ,
   2. برنامه های افزودنی ARCore (بدون EDM4U).

هنگام نصب ARCore Extensions ، یونیتی همچنین به طور خودکار نسخه مناسبی از وابستگی های مورد نیاز را نصب می کند:

• AR Foundation
• ARCore XR Plugin (برای هدف قرار دادن اندروید استفاده می شود)
• ARKit XR Plugin (برای هدف قرار دادن iOS استفاده می شود)

این وابستگی‌ها ممکن است در Package Manager > Package: In project قابل مشاهده نباشند. با این حال، بسته ها را می توان در پنجره Project در زیر Packages مشاهده کرد

برنامه های افزودنی ARCore را تنظیم کنید

بنیاد AR 4.x

1. در قسمت Hierarchy ، کلیک راست کرده و اشیاء بازی زیر را اضافه کنید (اگر قبلا اضافه نشده اند):

   • XR > AR Session
   • XR > AR Session Origin
   • XR > ARCore Extensions

2. در قسمت Hierarchy بسته ARCore Extensions را انتخاب کنید.

3. در قسمت Inspector ، برای هر یک از فیلدهای زیر، روی هدف کلیک کنید را فشار دهید و هر فیلد را به صورت زیر با شی بازی مربوطه خود وصل کنید:

   • Session : AR Session صحنه خود استفاده کنید.
   • AR Session Origin : AR Session Origin صحنه خود استفاده کنید.
   • Camera Manager : AR Camera صحنه خود استفاده کنید.

4. به صورت اختیاری، دارایی های زیر را برای Cloud Anchors و فیلترهای پیکربندی دوربین ایجاد و متصل کنید.

   1. در پنجره Project > Assets ، کلیک راست کرده، Create > XR > ARCore Extensions Config را انتخاب کنید.

   2. در قسمت Project > Assets ، کلیک راست کرده، Create > XR > Camera Config Filter انتخاب کنید.

   3. در قسمت Hierarchy بسته ARCore Extensions را انتخاب کنید.

   4. در قسمت ARCore Extensions Config در پنجره Inspector ، روی هدف کلیک کنید را فشار دهید و به دارایی ARCoreExtensionsConfig متصل شوید.

   5. در قسمت Camera Config Filter در قسمت Inspector ، روی هدف کلیک کنید را فشار دهید و به دارایی ARCoreExtensionsCameraConfigFilter متصل شوید.

      برای کسب اطلاعات بیشتر، به راهنمای توسعه دهنده Cloud Anchors و راهنمای پیکربندی دوربین مراجعه کنید.

   6. اگر از نسخه یونیتی زیر 2020.3 استفاده می کنید:

      • قالب Custom Gradle Properties را در تنظیمات پروژه > پخش کننده > اندروید > تنظیمات انتشار > ساخت انتخاب کنید.

با اتصال مناسب تمام فیلدهای ARCore Extensions، پنجره ARCore Extensions Inspector شما به شکل زیر است:

بنیاد AR 5.x

1. در قسمت Hierarchy ، کلیک راست کرده و اشیاء بازی زیر را اضافه کنید (اگر قبلا اضافه نشده اند):

   • XR > AR Session
   • XR > XR Origin (Mobile AR)
   • XR > ARCore Extensions

2. در قسمت Hierarchy بسته ARCore Extensions را انتخاب کنید.

3. در قسمت Inspector ، برای هر یک از فیلدهای زیر، روی هدف کلیک کنید را فشار دهید و هر فیلد را به صورت زیر با شی بازی مربوطه خود وصل کنید:

   • Session : AR Session صحنه خود استفاده کنید.
   • XR Origin : XR Origin صحنه خود استفاده کنید.
   • Camera Manager : AR Camera صحنه خود استفاده کنید.

4. به صورت اختیاری، دارایی های زیر را برای Cloud Anchors و فیلترهای پیکربندی دوربین ایجاد و متصل کنید.

   1. در پنجره Project > Assets ، کلیک راست کرده، Create > XR > ARCore Extensions Config را انتخاب کنید.

   2. در قسمت Project > Assets ، کلیک راست کرده، Create > XR > Camera Config Filter انتخاب کنید.

   3. در قسمت Hierarchy بسته ARCore Extensions را انتخاب کنید.

   4. در قسمت ARCore Extensions Config در پنجره Inspector ، روی هدف کلیک کنید را فشار دهید و به دارایی ARCoreExtensionsConfig متصل شوید.

   5. در قسمت Camera Config Filter در قسمت Inspector ، روی هدف کلیک کنید را فشار دهید و به دارایی ARCoreExtensionsCameraConfigFilter متصل شوید.

      برای کسب اطلاعات بیشتر، به راهنمای توسعه دهنده Cloud Anchors و راهنمای پیکربندی دوربین مراجعه کنید.

   6. اگر از نسخه یونیتی زیر 2020.3 استفاده می کنید:

      • قالب Custom Gradle Properties را در تنظیمات پروژه > پخش کننده > اندروید > تنظیمات انتشار > ساخت انتخاب کنید.

در حالی که تمام فیلدهای ARCore Extensions به درستی متصل شده اند، پنجره ARCore Extensions Inspector شما به شکل زیر است:

برای اطلاعات بیشتر در مورد راه اندازی ویژگی ها، راهنمای Unity برای ویرایش خواص را ببینید.

پروژه های نمونه

همراه با برنامه های افزودنی ARCore برای بنیاد AR پروژه های نمونه ای هستند که می توانید برای شروع ساخت پروژه های خود از آنها استفاده کنید.

1. از منوی Window ، Package Manager باز کرده و بسته ARCore Extensions را انتخاب کنید.

2. در بخش Samples ، برای پروژه نمونه که در زیر توضیح داده شده است، روی Import کلیک کنید.

پروژه های نمونه زیر از مخزن GitHub وارد شده اند:

• Geospatial (فقط Android) - تجربیات AR را در مقیاس جهانی ایجاد کنید و محتوا را از راه دور به هر منطقه تحت پوشش نمای خیابان Google متصل کنید. برای اطلاعات بیشتر به مقدمه Geospatial API مراجعه کنید.

• PersistentCloudAnchors (اندروید و iOS) - با لایه‌های تعاملی اطلاعات دیجیتالی که به مکان‌های واقعی متصل شده‌اند، تجربه‌های واقعیت افزوده دائمی را در دنیای واقعی ایجاد کنید، و تجربیاتی طراحی کنید که می‌تواند در طول زمان توسط افراد متعدد در دستگاه‌های مختلف به اشتراک گذاشته شود. برای اطلاعات بیشتر به معرفی Cloud Anchors مراجعه کنید.

بعدش چی

با ARCore Extensions for AR Foundation، اکنون می توانید از Cloud Anchors و تنظیمات دوربین در برنامه های خود استفاده کنید.

• راهنمای توسعه دهنده Cloud Anchors
• راهنمای تنظیمات دوربین