این راهنما نسخه‌های توصیه‌شده موتور، کیت‌های توسعه نرم‌افزار موردنیاز، و تنظیمات پروژه Android را هنگام توسعه دادن برنامه Unreal Engine برای Android XR شرح می‌دهد.
پیش‌نیازها
قبل‌از اینکه بتوانید Unreal Engine را برای توسعه Android XR راه‌اندازی کنید، باید برنامه‌ها و ابزارهای زیر را نصب کنید:
راه‌انداز Epic Games را بارگیری و نصب کنید.
- از Epic Games Launcher، نسخه 5.6.x یا 5.8.x از Unreal Engine را نصب کنید.
سیستم خود را برای ساخت کد C++ راه‌اندازی کنید (برای مثال، بااستفاده از Visual Studio 2022 برای Windows، یا Xcode برای macOS). برای اطلاعات بیشتر، راه‌اندازی محیط توسعه C++ در Epic را ببینید.
کیت توسعه نرم‌افزار NET 8.0 را نصب کنید.
استودیو Android (Rabbit 2 | 2026.2.2 وصله ۱ یا بالاتر) را نصب کنید.
نصب پشتیبانی ساخت Android
ازآنجایی‌که Android XR به نسخه‌های خاصی از کیت توسعه نرم‌افزار متکی است، باید ابزارهای ساخت Android صحیح را در کنار Unreal Engine نصب کنید.
- راه‌انداز Epic Games را باز کنید.
روی کلید کرکره‌ای کنار نسخه Engine نصب‌شده (دکمه راه‌اندازی) کلیک کنید و روی گزینه‌ها کلیک کنید.
- به گزینه‌های نصب پیمایش کنید، Android را انتخاب کنید، و روی اعمال کلیک کنید.
- درصورت درخواست، به موتور اجازه دهید هر پسوند فایلی را که نیاز دارد ثبت کند.
Java JDK 17 را نصب کنید.
در Android Studio، از «مدیر SDK» برای نصب نسخه‌های خاص زیر که برای نمونه‌های Android XR لازم است استفاده کنید:
- پلاتفرم‌های کیت توسعه نرم‌افزار: ۳۴، ۳۵، و ۳۶
- NDK: 29.0.x
- ابزارهای خط فرمان (همه موارد)
راهنمای عیب‌یابی و راه‌اندازی پیشرفته Epic را دنبال کنید تا متغیرهای محیط سیستم زیر را پیکربندی کنید:
ANDROID_HOMEJAVA_HOMENDK_ROOT
ایجاد پروژه Unreal XR
سپس، پروژه جدیدی ایجاد کنید و آن را با افزایه‌های XR و ورودی‌های لازم پیکربندی کنید:
- Unreal Engine (نسخه 5.6.x یا 5.8.x) را راه‌اندازی کنید.
- در بخش New Project Categories (دسته‌های پروژه جدید)، الگوی Virtual Reality (واقعیت مجازی) را انتخاب کنید.
- در منو پیش‌فرض‌های پروژه، پلاتفرم هدف را روی تلفن همراه تنظیم کنید.
- پیش‌تنظیم کیفیت را روی مقیاس‌پذیر تنظیم کنید تا عملکرد بهینه در سخت‌افزار واقعیت گسترده تلفن همراه ارتقا یابد.
- نامی برای پروژه انتخاب کنید، سپس روی ایجاد کلیک کنید.
پیکربندی تنظیمات Android
پس‌از باز شدن پروژه، این مراحل را برای تنظیم سطوح لازم API Android و تنظیمات گرافیکی برای Android XR تکمیل کنید:
- به ویرایش > تنظیمات پروژه بروید.
- به پلاتفرم‌ها > Android بروید.
- اگر دکمه پذیرفتن پروانه کیت توسعه نرم‌افزار با رنگ قرمز برجسته شده است، روی آن کلیک کنید.
- در بخش APKPackaging:
- حداقل نسخه کیت توسعه نرم‌افزار را روی
34تنظیم کنید. - نسخه کیت توسعه نرم‌افزار هدف را روی
34(یا بالاتر) تنظیم کنید.
- حداقل نسخه کیت توسعه نرم‌افزار را روی
به پایین‌تر به بخش ساخت پیمایش کنید و پشتیبانی از Vulkan را انتخاب کنید.
Vulkan میانای برنامه‌سازی کاربردی گرافیکی توصیه‌شده و با عملکرد بالا برای Android XR است.
پیکربندی تنظیمات پرداز زدن
برای دستیابی به نرخ فریم بالا و وضوح دیداری موردنیاز برای Android XR، باید Unreal Engine را نیز پیکربندی کنید تا از مسیر بهینه‌سازی‌شده ارائه تلفن همراه استفاده کند:
- به Edit (ویرایش) > Project Settings (تنظیمات پروژه) بروید و به Engine (موتور) > Rendering (پرداز) پیمایش کنید.
در بخش Forward Renderer، گزینه Forward Shading را انتخاب کنید.
پردازش‌کننده پیش‌رو برای واقعیت مجازی تلفن همراه به‌طور قابل‌توجهی سریع‌تر از پردازش‌کننده معوق پیش‌فرض است. توجه داشته باشید که فعال کردن این ویژگی نیاز به بازراه‌اندازی ویرایشگر و کامپایل سایه‌زن دارد.
در بخش تنظیمات پیش‌فرض، روش ضدپلگی را روی MSAA تنظیم کنید.
در بخش تلفن همراه، MSAA تلفن همراه را روی 4x تنظیم کنید.
MSAA واضح‌ترین نتایج را برای واقعیت مجازی بدون جلوه‌های محو کردن ناشی‌از Temporal AA (TAA) ارائه می‌دهد.
در بخش واقعیت مجازی:
HDR تلفن همراه را پاک کنید.
غیرفعال کردن «دامنه پویای بالا» در تلفن همراه، سربار پس‌پردازش را به‌شدت کاهش می‌دهد.
چندنمایی تلفن همراه را انتخاب کنید.
این کار به موتور اجازه می‌دهد هر دو چشم را در یک گذر رندر کند، که عملکرد CPU را به‌طور قابل‌توجهی بهبود می‌بخشد.
همچنین مراجعه کنید به
برای دستورالعمل‌های دقیق درباره استقرار پروژه الگو در دستگاه مجهز به Android، به راه‌اندازی پروژه‌های Unreal Engine برای توسعه Android مراجعه کنید.