ARCore را برای اندروید فعال کنید

این صفحه نحوه فعال کردن عملکرد ARCore را در پروژه‌های Unity خود که دستگاه‌های Android را هدف قرار می‌دهند، توضیح می‌دهد. برای انجام این کار، باید:

1. ARCore SDK را برای Unity وارد کنید
2. برنامه خود را طوری پیکربندی کنید که AR مورد نیاز یا AR اختیاری باشد
3. مطمئن شوید که برنامه شما با الزامات حریم خصوصی کاربر ARCore مطابقت دارد

خدمات Google Play برای AR

ARCore SDK ویژگی‌های AR را در دستگاه‌های پشتیبانی‌شده ARCore که سرویس‌های Google Play برای AR (ARCore) نصب کرده‌اند، در دسترس قرار می‌دهند.

Google Play Services for AR به‌طور خودکار در اکثر دستگاه‌های پشتیبانی‌شده نصب و به‌روز می‌شود.

قبل از شروع جلسه AR، برنامه ها باید:

1. با تماس با CheckApkAvailability ، بررسی کنید که ARCore پشتیبانی می‌شود.
2. با تماس با Session.RequestApkInstallation(bool userRequested) بررسی کنید که سرویس‌های Google Play برای AR نصب شده و به‌روز باشد و اطلاعات نمایه دستگاه ARCore مورد نیاز دانلود شده باشد.

ARCore SDK را برای Unity وارد کنید

1. Unity را باز کنید و یک پروژه سه بعدی جدید ایجاد کنید.

   احتیاط: خط لوله رندر جهانی (که قبلاً به عنوان خط لوله رندر سبک یا LWRP شناخته می شد) توسط ARCore SDK برای Unity پشتیبانی نمی شود.

2. بسته های خاص نسخه را نصب کنید.

   یونیتی 2020

   Window > Package Manager را انتخاب کرده و بسته های زیر را نصب کنید:

   • HLAPI چند نفره (مورد نیاز نمونه Cloud Anchors)
   • مدیریت پلاگین XR (مورد نیاز Instant Preview که از TrackedPoseDriver استفاده می کند)

   یونیتی 2019

   Window > Package Manager را انتخاب کرده و بسته های زیر را نصب کنید:

   • HLAPI چند نفره (مورد نیاز نمونه Cloud Anchors)
   • کمک‌کننده‌های ورودی قدیمی XR (مورد نیاز پیش‌نمایش فوری، که از TrackedPoseDriver استفاده می‌کند)

   یونیتی 2018

   هیچ بسته اضافی مورد نیاز نیست. پیش رفتن به مرحله بعدی.

   یونیتی 2017

   هیچ بسته اضافی مورد نیاز نیست. پیش رفتن به مرحله بعدی.

3. وارد کردن ARCore SDK برای Unity:

   1. Assets > Import Package > Custom Package را انتخاب کنید.

   2. arcore-unity-sdk-1.25.0.unitypackage را که دانلود کردید انتخاب کنید.

   3. در گفتگوی Importing Package ، مطمئن شوید که همه گزینه‌های بسته انتخاب شده‌اند و روی Import کلیک کنید.

در پنجره پروژه Unity، باید فایل‌های SDK و برنامه نمونه HelloAR را در Assets/GoogleARCore/Examples/HelloAR/ ببینید.

برنامه خود را طوری پیکربندی کنید که AR مورد نیاز یا AR اختیاری باشد

برنامه‌ای که از ویژگی‌های AR پشتیبانی می‌کند می‌تواند به دو صورت پیکربندی شود: AR مورد نیاز و AR اختیاری . اگر برای تصمیم‌گیری برای انتخاب کدام یک به کمک نیاز دارید، به انتشار برنامه‌های AR در فروشگاه Google Play مراجعه کنید.

AR مورد نیاز است

برای قابل استفاده بودن، یک برنامه AR مورد نیاز به یک دستگاه پشتیبانی شده ARCore نیاز دارد که خدمات Google Play برای AR را روی آن نصب کرده باشد.

• فروشگاه Google Play برنامه‌های AR مورد نیاز را فقط در دستگاه‌هایی که از ARCore پشتیبانی می‌کنند در دسترس قرار می‌دهد.

• هنگامی که کاربران یک برنامه AR مورد نیاز را نصب می کنند، فروشگاه Google Play به طور خودکار خدمات Google Play را برای AR نصب می کند. با این حال، در صورتی که سرویس‌های Google Play برای واقعیت افزوده باید به‌روزرسانی شود یا به‌صورت دستی حذف شده باشد یا داده‌های نمایه دستگاه ARCore به‌روز نباشد، همچنان باید برنامه‌تان را بررسی‌های بیشتری در زمان اجرا انجام دهد.

برای اطلاعات بیشتر، به انتشار برنامه‌های AR در فروشگاه Google Play مراجعه کنید.

برای ایجاد یک برنامه AR مورد نیاز، این مراحل را دنبال کنید.

یونیتی 2020

1. ویرایش > تنظیمات پروژه را باز کنید. Google ARCore را انتخاب کنید و بررسی کنید که ARCore Required علامت زده شده باشد.

2. حداقل سطح API مناسب را با کلیک روی Edit > Project Settings > Player و انتخاب برگه با نماد Android تنظیم کنید. در قسمت تنظیمات دیگر > شناسایی، حداقل سطح API 24 یا بالاتر را انتخاب کنید.

یونیتی 2019

1. ویرایش > تنظیمات پروژه را باز کنید. Google ARCore را انتخاب کنید و بررسی کنید که ARCore Required علامت زده شده باشد.

2. حداقل سطح API مناسب را با کلیک روی Edit > Project Settings > Player و انتخاب برگه با نماد Android تنظیم کنید. در قسمت تنظیمات دیگر > شناسایی، حداقل سطح API 24 یا بالاتر را انتخاب کنید.

یونیتی 2018

1. ویرایش > تنظیمات پروژه را باز کنید. Google ARCore را انتخاب کنید و بررسی کنید که ARCore Required علامت زده شده باشد.

2. حداقل سطح API مناسب را با کلیک روی Edit > Project Settings > Player و انتخاب برگه با نماد Android تنظیم کنید. در قسمت تنظیمات دیگر > شناسایی، حداقل سطح API 24 یا بالاتر را انتخاب کنید.

یونیتی 2017

1. Edit > Project Settings > Google ARCore را باز کنید، سپس بررسی کنید که ARCore Required علامت زده شده باشد.

2. حداقل سطح API مناسب را با کلیک روی Edit > Project Settings > Player و انتخاب برگه با نماد Android تنظیم کنید. در قسمت تنظیمات دیگر > شناسایی، حداقل سطح API 24 یا بالاتر را انتخاب کنید.

برنامه شما به‌طور خودکار بررسی‌های زمان اجرا را انجام می‌دهد تا مطمئن شود دستگاه از ARCore پشتیبانی می‌کند و سرویس‌های Google Play برای AR را نصب کرده است و اطلاعات نمایه دستگاه ARCore به‌روز است. اگر Google Play Services for AR نصب نشده باشد (احتمالاً به این دلیل که کاربر آن را حذف کرده است) یا نسخه خیلی قدیمی باشد، برنامه شما از کاربر می خواهد آن را نصب یا به روز کند. اگر داده‌های نمایه دستگاه ARCore به‌روز نباشد، برنامه شما آن را دانلود و به‌روزرسانی می‌کند. اگر نصب یا به‌روزرسانی ناموفق باشد (احتمالاً به دلیل خرابی شبکه)، Session.Status خطایی را برمی‌گرداند و برنامه شما باید این خطا را کنترل کرده و خارج شود.

AR اختیاری

یک برنامه اختیاری AR دارای ویژگی‌های AR اختیاری است که فقط در دستگاه‌هایی فعال می‌شوند که سرویس‌های Google Play برای AR را نصب کرده‌اند.

• برنامه‌های اختیاری AR را می‌توان روی دستگاه‌هایی که از ARCore پشتیبانی نمی‌کنند نصب و اجرا کرد.

• وقتی کاربران یک برنامه اختیاری AR را نصب می‌کنند، فروشگاه Google Play به‌طور خودکار خدمات Google Play برای AR را با برنامه نصب نمی‌کند .

برای اختیاری کردن یک برنامه AR، این مراحل را دنبال کنید.

یونیتی 2020

1. ویرایش > تنظیمات پروژه را باز کنید. Google ARCore را انتخاب کنید و علامت ARCore Required را بردارید.

2. حداقل سطح API مناسب را با کلیک روی Edit > Project Settings > Player و انتخاب برگه با نماد Android تنظیم کنید. در قسمت تنظیمات دیگر > شناسایی، حداقل سطح API 18 یا بالاتر را انتخاب کنید.

یونیتی 2019

1. ویرایش > تنظیمات پروژه را باز کنید. Google ARCore را انتخاب کنید و علامت ARCore Required را بردارید.

2. حداقل سطح API مناسب را با کلیک روی Edit > Project Settings > Player و انتخاب برگه با نماد Android تنظیم کنید. در قسمت تنظیمات دیگر > شناسایی، حداقل سطح API 18 یا بالاتر را انتخاب کنید.

یونیتی 2018

1. ویرایش > تنظیمات پروژه را باز کنید. Google ARCore را انتخاب کنید و علامت ARCore Required را بردارید.

2. حداقل سطح API مناسب را با کلیک روی Edit > Project Settings > Player و انتخاب برگه با نماد Android تنظیم کنید. در قسمت تنظیمات دیگر > شناسایی، حداقل سطح API 18 یا بالاتر را انتخاب کنید.

یونیتی 2017

1. Edit > Project Settings > Google ARCore را باز کنید و علامت ARCore Required را بردارید.

2. حداقل سطح API مناسب را با کلیک روی Edit > Project Settings > Player و انتخاب برگه با نماد Android تنظیم کنید. در قسمت تنظیمات دیگر > شناسایی، حداقل سطح API 18 یا بالاتر را انتخاب کنید.

بررسی های زمان اجرا را انجام دهید

هنگام راه‌اندازی، برنامه شما باید Session.CheckApkAvailability() را فراخوانی کند تا بررسی کند که آیا دستگاه از ARCore پشتیبانی می‌کند و در این صورت، آیا سرویس‌های Google Play برای AR و داده‌های نمایه دستگاه ARCore نصب و به‌روز هستند یا خیر.

برنامه شما باید این شرایط را کنترل کند:

وضعیت	عمل
دستگاه از ARCore پشتیبانی نمی کند.	عملکرد مربوط به AR را پنهان می کند.
دستگاه از ARCore پشتیبانی می‌کند، اما خدمات Google Play برای AR و/یا داده‌های نمایه دستگاه ARCore نصب نشده یا قدیمی نیست.	از کاربر می‌خواهد با فراخوانی Session.RequestApkInstallation() سرویس‌های Google Play را برای داده‌های نمایه دستگاه AR و/یا ARCore نصب یا به‌روزرسانی کند.
دستگاه از ARCore پشتیبانی می کند و خدمات Google Play برای AR و داده های نمایه دستگاه ARCore نصب شده و به روز است.	یک Session ARCore ایجاد می کند و شروع به استفاده از ARCore می کند.

الزامات حریم خصوصی کاربر

مطمئن شوید که برنامه شما با الزامات حریم خصوصی کاربر ARCore مطابقت دارد.

مراحل بعدی

کد را در برنامه نمونه و مرجع ARCore for Unity API بخوانید.