«پیش‌نمایش مستقیم» به شما امکان می‌دهد تعاملات پیچیده را مستقیماً در Unreal Editor بااستفاده از داده‌های زنده از دستگاه Android XR آزمایش و تکرار کنید. با «پیش‌نمایش مستقیم»، دستگاه میزبان محتوا را رندر و اشکال‌زدایی می‌کند، نمای دیداری را مستقیماً به دستگاه Android XR فیزیکی شما جاری‌سازی می‌کند، و افزونه‌های OpenXR پشتیبانی‌شده را به‌طور هم‌زمان به میزبان برمی‌گرداند.
این راهنما را دنبال کنید تا «پیش‌نمایش مستقیم» را برای پروژه‌تان در Unreal Engine راه‌اندازی کنید.
پیش‌نیازها
قبل‌از شروع، مطمئن شوید محیط توسعه نرم‌افزار شما الزامات زیر را برآورده می‌کند:
- نسخه Unreal Engine: Unreal Engine 5.6.x یا 5.8.x.
- راه‌اندازی پروژه: همه مراحل راهنمای راه‌اندازی پروژه Unreal Engine را تکمیل کنید.
- Android XR Engine Hub: همه مراحل بخش شروع به کار در راهنمای Android XR Engine Hub را تکمیل کنید تا دستگاه میزبان را برای «پیش‌نمایش مستقیم» نصب و پیکربندی کنید.
سخت‌افزار:
- از دستگاه میزبانی استفاده کنید که Windows 11 را اجرا می‌کند.
- از کارت گرافیک مدرن با پشتیبانی از کدگذاری ویدیو Vulkan استفاده کنید.
راه‌اندازی کردن افزایه‌های Android XR
Unreal Engine را با افزایه‌های Android XR موردنیاز راه‌اندازی کنید:
مراحل ذکرشده در راهنمای شروع سریع افزونه‌های Android XR برای Unreal Engine را دنبال کنید.
بعداً، اگر پروژه جدیدی ایجاد کنید یا پروژه‌ای را باز کنید که با «پیش‌دید مستقیم» از آن استفاده نکرده‌اید، همان مراحل را دوباره دنبال کنید.
برای هر پروژه، مطمئن شوید که پروژه پیوند نمادین به پوشه افزایه‌های فروشنده داشته باشد.
پیکربندی تنظیمات پروژه
تنظیمات پروژه را برای جاری‌سازی «پیش‌نمایش مستقیم» پیکربندی کنید:
- به Project Settings (تنظیمات پروژه) > Platforms (پلاتفرم‌ها) > Windows بروید.
- برای RHI به Vulkan.
- به ویرایش > افزایه‌ها بروید.
- افزونه AndroidXRStreaming را فعال کنید.
- به ویرایش > تنظیمات پروژه > شرح بروید.
- شروع در واقعیت مجازی را فعال کنید.
فعال کردن زمان اجرای جاری‌سازی
اکنون که افزونه AndroidXRStreaming در پروژه فعال شده است، بررسی کنید که آیا زمان اجرای «جاری‌سازی Android XR» وجود دارد یا نه:
- به Project Settings (تنظیمات پروژه) > Plugins (افزایه‌ها) > AndroidXRStreaming بروید.
روی فعال کردن جاری‌سازی AndroidXR کلیک کنید.
برای اعمال این تغییرات، Unreal Engine را بازراه‌اندازی کنید.
پیکربندی کارخواه جاری‌سازی
کارخواه جاری‌سازی را با گزینه‌های مختلف برای پروژه‌تان پیکربندی کنید:
- به تنظیمات پروژه > افزایه‌ها بروید.
در بخش AndroidXRStreamingClient، هریک از گزینه‌های زیر را مرور کنید و آن‌ها را فعال یا غیرفعال کنید تا با آنچه برای پروژه‌تان نیاز دارید مطابقت داشته باشند:
- Auto Start Client On Preview: وقتی فعال باشد، با کلیک کردن روی Start VR Preview از ویرایشگر، برنامه کلاینت پیش‌نمایش را در هر دستگاه معتبر و انتخاب‌شده‌ای راه‌اندازی می‌کند.
- Auto Stop Client On Preview: وقتی فعال باشد، کلاینت پیش‌نمایش را هنگام توقف پیش‌نمایش واقعیت مجازی از ویرایشگر خاتمه می‌دهد.
- انتخاب خودکار دستگاه سازگار: وقتی فعال باشد، هنگام جستجوی دستگاه‌ها، اولین دستگاه سازگار متصل به ماشین را به‌طور خودکار انتخاب می‌کند.
- نمایش کادرهای گفتگوی خطا: وقتی فعال باشد، کادرهای گفتگوی خطای بیشتری نمایش داده می‌شود (برای مثال، اگر بخواهید پیش‌نمایش واقعیت مجازی را بدون انتخاب دستگاه کارخواه شروع کنید، کادر گفتگوی خطا نمایش داده می‌شود). برای پنهان کردن این کادرهای گفتگو، این گزینه را غیرفعال کنید.
- بازآوری: وقتی فعال باشد، دکمه بازآوری دستگاه‌های متصل را جستجو می‌کند و دستگاه‌های سازگار را فهرست می‌کند (که با حضور برنامه کارخواه «پیش‌نمایش مستقیم» در Android XR Engine Hub تعیین می‌شود).
شروع پیش‌نمایش مستقیم
برای جاری‌سازی مستقیم از Unreal Engine، «پیش‌نمایش مستقیم» را شروع کنید:
دستگاه Android XR را بااستفاده از کابل USB-C باکیفیت به دستگاه میزبان متصل کنید.
اگر قبلاً از این دستگاه با «پیش‌دید مستقیم» استفاده نکرده‌اید، قبل‌از شروع «پیش‌دید مستقیم» ازطریق موتور بازی، دستگاه را برای «پیش‌دید مستقیم» در Android XR Engine Hub متصل و پیکربندی کنید.
در Unreal Editor، روی Play level in VR (اجرای سطح در واقعیت مجازی) کلیک کنید. هنگام شروع «پیش‌نمایش مستقیم»، از گزینه معمول پخش در ویرایشگر استفاده نکنید.