تنظیمات پروژه موتور Unreal

دستگاه‌های XR قابل اجرا

این راهنما به شما کمک می‌کند تا برای این نوع دستگاه‌های XR تجربه ایجاد کنید.

درباره انواع دستگاه‌های XR اطلاعات کسب کنید →

هدست‌های XR

عینک‌های XR سیمی

درباره انواع دستگاه‌های XR اطلاعات کسب کنید →

این راهنما جزئیات نسخه‌های موتور پیشنهادی، SDK های مورد نیاز و تنظیمات پروژه اندروید را هنگام توسعه یک برنامه Unreal Engine برای اندروید XR شرح می‌دهد.

پیش‌نیازها

قبل از اینکه بتوانید موتور Unreal را برای توسعه اندروید XR تنظیم کنید، باید برنامه‌ها و ابزارهای زیر را نصب کنید:

1. لانچر اپیک گیمز را دانلود و نصب کنید.

   1. از طریق لانچر اپیک گیمز، نسخه ۵.۶.۱ (یا بالاتر) از موتور بازی‌سازی آنریل را نصب کنید.

2. سیستم خود را برای ساخت کد ++C تنظیم کنید (برای مثال، با استفاده از Visual Studio 2022 برای ویندوز یا Xcode برای macOS). برای اطلاعات بیشتر، به بخش تنظیمات محیط توسعه ++C شرکت Epic مراجعه کنید.

3. .NET 8.0 SDK را نصب کنید.

4. اندروید استودیو (Panda 4 | 2025.3.4 Patch 1 یا بالاتر) را نصب کنید.

نصب پشتیبانی ساخت اندروید

از آنجا که اندروید XR به نسخه‌های خاصی از SDK متکی است، شما باید ابزارهای ساخت اندروید صحیح را در کنار Unreal Engine نصب کنید.

1. لانچر اپیک گیمز را باز کنید.

2. روی فلش کشویی کنار نسخه موتور نصب شده خود (دکمه راه‌اندازی) کلیک کنید و روی گزینه‌ها کلیک کنید.

   1. به گزینه‌های نصب بروید، اندروید را انتخاب کنید و روی اعمال کلیک کنید.
   2. در صورت درخواست، به موتور اجازه دهید هر پسوند فایلی را که نیاز دارد ثبت کند.

3. جاوا JDK 17 را نصب کنید.

4. در اندروید استودیو، از SDK Manager برای نصب نسخه‌های خاص زیر که مورد نیاز نمونه‌های اندروید XR هستند، استفاده کنید:

   • پلتفرم‌های SDK : ۳۴، ۳۵ و ۳۶
   • ان‌دی‌کی : ۲۹.۰.x
   • ابزارهای خط فرمان (همه موارد)

5. برای پیکربندی متغیرهای محیطی سیستم زیر ، راهنمای پیشرفته‌ی راه‌اندازی و عیب‌یابی Epic را دنبال کنید:

   • ANDROID_HOME
   • JAVA_HOME
   • NDK_ROOT

ایجاد یک پروژه Unreal XR

در مرحله بعد، یک پروژه جدید ایجاد کنید و آن را با افزونه‌ها و ورودی‌های لازم XR پیکربندی کنید:

1. موتور Unreal 5.6.1 را اجرا کنید.
2. در بخش دسته‌بندی‌های پروژه جدید ، الگوی واقعیت مجازی را انتخاب کنید.
3. در منوی پیش‌فرض‌های پروژه ، گزینه‌ی «پلتفرم هدف» (Target Platform) را روی «موبایل» (Mobile) تنظیم کنید.
4. برای ارتقای عملکرد بهینه در سخت‌افزار XR موبایل، تنظیمات کیفیت ( Quality Preset) را روی مقیاس‌پذیر (Scalable) تنظیم کنید.
5. یک نام برای پروژه انتخاب کنید و سپس روی ایجاد کلیک کنید.

تنظیمات اندروید را پیکربندی کنید

پس از باز شدن پروژه، این مراحل را برای تنظیم سطوح API اندروید و تنظیمات گرافیکی مورد نیاز برای اندروید XR انجام دهید:

1. به ویرایش > تنظیمات پروژه بروید.
2. به پلتفرم‌ها > اندروید بروید.
3. اگر دکمه‌ی «پذیرش مجوز SDK» با رنگ قرمز مشخص شده است، روی آن کلیک کنید.
4. در بخش APKPackaging :
   • حداقل نسخه SDK را روی 34 تنظیم کنید.
   • نسخه Target SDK را روی 34 (یا بالاتر) تنظیم کنید.

5. به بخش ساخت (Build) بروید و پشتیبانی از ولکان (Support Vulkan) را انتخاب کنید.

   ولکان (Vulkan) رابط برنامه‌نویسی گرافیکی (API) پیشنهادی و بسیار کارآمد برای اندروید XR است.

پیکربندی تنظیمات رندر

برای دستیابی به نرخ فریم بالا و وضوح بصری مورد نیاز برای اندروید XR، باید Unreal Engine را نیز طوری پیکربندی کنید که از مسیر رندر بهینه شده موبایل استفاده کند:

1. به مسیر Edit > Project Settings بروید و سپس به Engine > Rendering بروید.

2. در بخش Forward Renderer ، گزینه Forward Shading را انتخاب کنید.

   رندرکننده‌ی رو به جلو برای واقعیت مجازی موبایل به طور قابل توجهی سریع‌تر از رندرکننده‌ی پیش‌فرضِ به تعویق افتاده است. توجه داشته باشید که فعال کردن این گزینه نیاز به راه‌اندازی مجدد ویرایشگر و کامپایل سایه‌زن دارد.

3. در بخش تنظیمات پیش‌فرض ، روش Anti-Aliasing را روی MSAA تنظیم کنید.

4. در بخش موبایل ، گزینه Mobile MSAA را روی ۴x تنظیم کنید.

   MSAA واضح ترین نتایج را برای VR بدون اثرات تاری ناشی از Temporal AA (TAA) ارائه می دهد.

5. در بخش واقعیت مجازی (VR ):

   1. HDR شفاف موبایل .

      غیرفعال کردن محدوده دینامیکی بالا (High Dynamic Range) در موبایل، سربار پس از پردازش را به طرز چشمگیری کاهش می‌دهد.

   2. نمای چندگانه موبایل را انتخاب کنید.

      این به موتور اجازه می‌دهد تا هر دو چشم را در یک مرحله رندر کند و عملکرد CPU را به طور قابل توجهی بهبود بخشد.

همچنین ببینید

برای دستورالعمل‌های دقیق در مورد استقرار یک پروژه قالب در یک دستگاه مبتنی بر اندروید، به «راه‌اندازی پروژه‌های Unreal Engine برای توسعه اندروید» مراجعه کنید.