این صفحه نحوه فعال کردن عملکرد ARCore را در پروژه های Unreal Engine خود توضیح می دهد. برای این کار باید:
- برنامه خود را طوری پیکربندی کنید که AR مورد نیاز یا اختیاری AR باشد
- مطمئن شوید که برنامه شما با الزامات حریم خصوصی کاربر ARCore مطابقت دارد
خدمات Google Play برای AR
دو راه برای فعال کردن ARCore در برنامه شما وجود دارد: AR مورد نیاز و AR اختیاری . اگر برای تصمیم‌گیری در مورد انتخاب کردن به کمک نیاز دارید، به انتشار برنامه‌های AR در فروشگاه Google Play مراجعه کنید.
AR مورد نیاز است
AR Required به این معنی است که برنامه شما بدون AR قابل استفاده نیست و برنامه شما را فقط در دستگاه هایی که از ARCore پشتیبانی می کنند در دسترس قرار می دهد.
برای اینکه یک برنامه AR مورد نیاز باشد، کادر ARCore Required App را در تنظیمات افزونه GoogleARCore علامت بزنید. این تنظیم در منوی Edit > Project Settings > Plugins > GoogleARCore قرار دارد.
برنامه شما به‌طور خودکار بررسی‌های زمان اجرا را انجام می‌دهد تا مطمئن شود دستگاه از ARCore پشتیبانی می‌کند و سرویس‌های Google Play برای AR و داده‌های نمایه دستگاه ARCore نصب و به‌روز هستند. اگر Google Play Services for AR نصب نشده باشد (احتمالاً به این دلیل که کاربر آن را حذف کرده است) یا نسخه خیلی قدیمی باشد یا اطلاعات نمایه دستگاه ARCore به روز نباشد، برنامه شما از کاربر می خواهد آنها را نصب یا به روز کند. اگر نصب یا به‌روزرسانی ناموفق باشد (احتمالاً به دلیل خرابی شبکه)، گره Get ARCore Session Status Blueprint Error را برمی‌گرداند و برنامه شما باید خطا را کنترل کرده و خارج شود.
AR اختیاری
AR اختیاری به این معنی است که برنامه شما می‌تواند روی دستگاه‌هایی نصب و اجرا شود که از ARCore پشتیبانی نمی‌کنند، اما شامل ویژگی‌های AR است که هنگام اجرا در دستگاه‌های پشتیبانی‌شده فعال می‌شوند. وقتی کاربران یک برنامه اختیاری AR را نصب می‌کنند، فروشگاه Google Play به‌طور خودکار خدمات Google Play را برای AR نصب نمی‌کند.
برای اختیاری کردن یک برنامه AR، علامت کادر ARCore Required App در تنظیمات افزونه GoogleARCore را بردارید.
در برنامه خود، از گره Check ARCore Availability Blueprint استفاده کنید تا بررسی کنید که آیا دستگاه از ARCore پشتیبانی می کند یا خیر، و اگر چنین است، آیا Google Play Services for AR نصب شده است یا خیر.
برنامه شما باید این شرایط را کنترل کند:
| وضعیت | عمل |
|---|---|
| دستگاه از ARCore پشتیبانی نمی کند. | عملکرد مربوط به AR را پنهان می کند. |
| دستگاه از ARCore پشتیبانی می کند، اما خدمات Google Play یا نصب نشده یا قدیمی است. | از کاربر می خواهد با استفاده از Install ARCore Service Blueprint نصب یا به روز رسانی کند. |
| دستگاه از ARCore پشتیبانی می کند و خدمات Google Play برای AR نصب شده و به روز است. | سرویس را شروع می کند. |
الزامات حریم خصوصی کاربر
مطمئن شوید که برنامه شما با الزامات حریم خصوصی کاربر ARCore مطابقت دارد.
مراحل بعدی
کد را در برنامه نمونه و مرجع ARCore برای Unreal API بخوانید .