راه اندازی پروژه یونیتی

این راهنما به جزئیات نسخه های ویرایشگر توصیه شده، تنظیمات گرافیکی، تنظیمات URP و تنظیمات پروژه Android هنگام توسعه یک برنامه Unity برای Android XR می پردازد.

پیش نیازها

برای توسعه با یونیتی باید Unity Hub را دانلود و نصب کنید .

نسخه 6000.0.23f1 یا بالاتر از Unity Editor و Android Build را نصب کنید که شامل موارد زیر است:

• OpenJDK
• Android SDK
• ابزارهای Android NDK

یک موتور رندر انتخاب کنید

توصیه می کنیم از Vulkan Graphics API برای رندر کردن برنامه های Android XR استفاده کنید. برای انتخاب Vulkan به عنوان Graphics API، مراحل زیر را دنبال کنید:

1. در Unity، به Edit > Project Settings > Player بروید.
2. برگه Android را انتخاب کنید و به تنظیمات دیگر > رندر بروید.
3. اگر Auto Graphics API فعال است، این تنظیم را غیرفعال کنید تا بخش Graphics APIs نمایان شود.

4. در بخش Graphics APIs ، دکمه Add (+) را انتخاب کرده و Vulkan را از منوی بازشو انتخاب کنید.

   

5. APIهای گرافیکی را با استفاده از دسته (=) دوباره مرتب کنید تا Vulkan در ابتدا فهرست شود.

6. در صورت تمایل، هر یک از APIهای گرافیکی دیگر را انتخاب کنید و روی دکمه Remove (-) کلیک کنید تا آنها حذف شوند.

خط لوله رندر جهانی

Android XR با خط لوله رندر جهانی (URP) سازگار است. اگر قصد دارید از عبور استفاده کنید، باید تنظیمات پیش‌فرض URP را برای بهترین عملکرد عبور در Android XR به‌روزرسانی کنید.

توجه: برای پروژه های موجود با دارایی های ساخته شده برای خط لوله رندر داخلی، باید از تبدیل کننده خط لوله رندر برای تبدیل آن دارایی ها به سازگاری با URP استفاده کنید.

جدول زیر فهرستی از تنظیمات URP توصیه شده یونیتی را دارد که در قسمت های بعدی با جزئیات بیشتر توضیح داده شده است.

تنظیم	مکان	مقدار توصیه شده
HDR	دارایی خط لوله رندر جهانی	از کار افتاده است
پس پردازش	داده های رندر جهانی	از کار افتاده است

توجه: اگر از URP استفاده می کنید Vulkan لازم است. توصیه می‌کنیم از Vulkan به‌عنوان API گرافیکی خود برای Android XR استفاده کنید، زیرا ویژگی‌های گرافیکی جدیدتر فقط با آن API پشتیبانی می‌شوند.

تنظیمات دارایی خط لوله رندر جهانی

این مراحل را برای بهینه سازی دارایی خط لوله رندر جهانی برای Android XR دنبال کنید:

1. دارایی خط لوله رندر جهانی پروژه خود را پیدا کنید. یک راه برای انجام این کار این است که t:UniversalRenderPipelineAsset در نوار جستجوی پنجره Project تایپ کنید.

   توجه: اگر پروژه شما دارای دارایی خط لوله رندر جهانی نیست، به نصب خط لوله رندر جهانی در یک پروژه موجود از اسناد URP مراجعه کنید.

2. در زیر عنوان Quality ، HDR را غیرفعال کنید.

   

تنظیمات داده رندر جهانی

این مراحل را برای بهینه‌سازی داده‌های رندر جهانی برای Android XR دنبال کنید:

1. مکان دارایی داده رندر جهانی پروژه خود را پیدا کنید. یکی از راه‌های انجام این کار این است که t:UniversalRendererData در نوار جستجوی پنجره پروژه تایپ کنید.

2. در Inspector ، در زیر هدر Post-processing ، علامت Enabled را بردارید.

   

حداقل سطح API Android

پروژه خود را روی حداقل سطح API 24 تنظیم کنید که توسط OpenXR Loader مورد نیاز است. در غیر این صورت، ساخت های شما ممکن است شکست بخورند.

برای تنظیم حداقل سطح API Android، این مراحل را کامل کنید.

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

نقطه ورود برنامه

تنظیمات زیر را برای نقطه ورودی برنامه پیکربندی کنید:

1. به Edit > Project Settings > Player بروید.
2. تب Android را انتخاب کنید و تنظیمات دیگر را باز کنید.
3. در قسمت Application Entry Point مطمئن شوید که GameActivity تیک خورده باشد و تیک Activity بردارید.

پنجره های پاپ آپ

اکثر برنامه‌های Android XR به پنجره‌هایی با قابلیت تغییر اندازه نیاز دارند، زیرا برای ارائه پنجره‌های بازشو مانند درخواست‌های مجوز سیستم مورد نیاز هستند.

این مراحل را دنبال کنید تا مطمئن شوید که پنجره های بازشو به درستی رندر شده اند.

1. به Edit > Project Settings > Player بروید.
2. تب Android را انتخاب کرده و Resizeable Activity را فعال کنید.

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

• یونیتی اندروید XR: OpenXR
• برنامه های افزودنی Android XR را برای Unity وارد کنید