شروع سریع برای Google Cardboard for Unity

این راهنما به شما نشان می دهد که چگونه از افزونه Google Cardboard XR برای Unity for Unity برای ایجاد تجربیات واقعیت مجازی (VR) خود استفاده کنید.

توجه: قبل از اینکه برنامه خود را بین مخاطبان بیشتری توزیع کنید، حتماً دستورالعمل‌های برند Cardboard را مرور کنید.

می توانید از Cardboard SDK برای تبدیل تلفن همراه به یک پلت فرم VR استفاده کنید. یک دستگاه تلفن همراه می‌تواند صحنه‌های سه‌بعدی را با رندر استریوسکوپی نمایش دهد، حرکات سر را ردیابی کند و به آن واکنش نشان دهد، و با تشخیص زمانی که کاربر دکمه بیننده را فشار می‌دهد، با برنامه‌ها تعامل داشته باشد.

برای شروع، از HelloCardboard ، یک بازی آزمایشی که ویژگی‌های اصلی Cardboard SDK را نشان می‌دهد، استفاده خواهید کرد. در این بازی، کاربران برای یافتن و جمع آوری اشیاء به دنیای مجازی نگاه می کنند. به شما نشان می دهد که چگونه:

• محیط توسعه خود را تنظیم کنید
• برنامه دمو را دانلود و بسازید
• کد QR یک نمایشگر Cardboard را اسکن کنید تا پارامترهای آن ذخیره شود
• ردیابی حرکات سر کاربر
• با تنظیم اعوجاج صحیح برای هر چشم، تصاویر استریوسکوپی را ارائه دهید
• حالت VR را روشن و خاموش کنید

محیط توسعه خود را تنظیم کنید

نرم افزار مورد نیاز:

• Unity 2021.3.44f1 یا جدیدتر
  • در حین نصب، حتماً پشتیبانی از ساخت اندروید و iOS را لحاظ کنید.
  • حتماً پچ نسخه 44f1 یا بالاتر را نصب کنید.
• Git باید نصب شده باشد و فایل اجرایی git باید روی متغیر محیطی PATH باشد. برای جزئیات بیشتر به اسناد پشتیبانی git مدیر بسته Unity مراجعه کنید.

SDK را وارد کنید و یک پروژه جدید ایجاد کنید

این مراحل را برای وارد کردن Unity SDK و ایجاد یک پروژه جدید دنبال کنید.

1. Unity را باز کنید و یک پروژه سه بعدی جدید ایجاد کنید.
2. در Unity، به Window > Package Manager بروید.
3. روی + کلیک کنید و Add package from git URL را انتخاب کنید.
4. https://github.com/googlevr/cardboard-xr-plugin.git در قسمت ورودی متن قرار دهید.
   بسته باید به بسته های نصب شده اضافه شود.
5. به بسته Google Cardboard XR Plugin for Unity بروید. در بخش Samples ، Import into Project را انتخاب کنید.
   دارایی‌های نمونه باید در Assets/Samples/Google Cardboard/<version>/Hello Cardboard بارگیری شوند.

توجه: <version> شماره نسخه معنایی XYZ بسته منتشر شده است (به عنوان مثال، 1.1.0 ).

صحنه HelloCardboard را پیکربندی کنید

1. به Assets/Samples/Google Cardboard/<version>/Hello Cardboard/Scenes بروید، Add Open Scenes را انتخاب کنید و HelloCardboard را برای باز کردن صحنه نمونه انتخاب کنید.
2. منوی لایه ها را باز کرده و Edit Layers... را انتخاب کنید.
3. یک لایه جدید به نام "Interactive" تعریف کنید.
4. روی Treasure GameObject کلیک کنید تا پنجره Inspector باز شود. لایه آن را روی "Interactive" تنظیم کنید. اگر یک پنجره پاپ آپ ظاهر می شود که از شما می پرسد آیا می خواهید لایه را برای همه اشیاء فرزند نیز روی Interactive تنظیم کنید، روی "Yes, change children" کلیک کنید.
5. روی Player > Camera > CardboardReticlePointer GameObject کلیک کنید تا پنجره Inspector باز شود. در اسکریپت "Cardboard reticle pointer"، "Interactive" را به عنوان ماسک لایه تعامل Reticle انتخاب کنید.

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

به File > Build Settings بروید.

1. Android را انتخاب کنید و Switch Platform را انتخاب کنید.
2. Add Open Scenes را انتخاب کنید و HelloCardboard را انتخاب کنید.

تنظیمات پخش کننده

به ویرایش > تنظیمات پروژه... بروید.

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

Player > Resolution and Presentation را پیمایش کنید.

1. جهت پیش فرض را روی Landscape Left یا Landscape Right قرار دهید.
2. گام بهینه فریم را غیرفعال کنید.

توجه: در حالی که توسط افزونه Cardboard XR پشتیبانی می شود، جهت گیری های پرتره و عمودی وارونه ممکن است فضای کافی برای رندر چشمی در دستگاه ها فراهم نکنند.

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

به Player > Other Settings بروید.

1. OpenGLES2 ، OpenGLES3 ، یا Vulkan یا هر ترکیبی از آنها را در Graphics API انتخاب کنید.
2. Android 8.0 'Oreo' (API level 26) یا بالاتر را در Minimum API Level انتخاب کنید.
3. API level 33 یا بالاتر را در Target API Level انتخاب کنید.
4. IL2CPP در Scripting Backend انتخاب کنید.
5. معماری های مورد نظر را با انتخاب ARMv7 ، ARM64 یا هر دو در Target Architectures انتخاب کنید.
6. Require در دسترسی به اینترنت انتخاب کنید.
7. Input System Package (New) در Active Input Handling انتخاب کنید.
8. دامنه شرکت خود را در زیر نام بسته مشخص کنید.
9. اگر Vulkan به عنوان Graphics API انتخاب شد:
   • کادر بررسی اعمال چرخش نمایشگر در هنگام رندر را در تنظیمات Vulkan پاک کنید.
   • اگر نسخه Unity 2021.2 یا بالاتر است، ETC2 در قالب فشرده سازی بافت انتخاب کنید.
10. اگر نسخه Unity 2023.1 یا بالاتر است، Activity را انتخاب کنید و GameActivity در Application Entry Point پاک کنید.

توجه: با تغییر سازگاری API رندر، می توان از حداقل سطح API کمتر استفاده کرد. برای اطلاعات بیشتر، به build.gradle SDK مراجعه کنید.

توجه: اگر هنگام انتخاب Vulkan به‌عنوان API گرافیکی با مشکل مواجه شدید، کادر Development Build در Build Settings علامت بزنید و گزارش‌های زمان اجرا را به دنبال خطاهای سازگاری درایور تجزیه و تحلیل کنید.

توجه: OpenGL ES 2.0 دیگر در Unity 2023.1+ پشتیبانی نمی‌شود. برای نسخه های جدیدتر از OpenGL ES 3.0 یا Vulkan استفاده کنید. برای اطلاعات بیشتر، به صفحه الزامات و سازگاری اندروید در کتابچه راهنمای Unity مراجعه کنید.

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

به Player > Publishing Settings بروید.

1. در بخش ساخت ، Custom Main Gradle Template و Custom Gradle Properties Template انتخاب کنید.

2. خطوط زیر را به بخش وابستگی‌های Assets/Plugins/Android/mainTemplate.gradle اضافه کنید:

     implementation 'androidx.appcompat:appcompat:1.6.1'
     implementation 'com.google.android.gms:play-services-vision:20.1.3'
     implementation 'com.google.android.material:material:1.12.0'
     implementation 'com.google.protobuf:protobuf-javalite:3.19.4'
   

3. خطوط زیر را به Assets/Plugins/Android/gradleTemplate.properties اضافه کنید:

     android.enableJetifier=true
     android.useAndroidX=true
   

توجه: وابستگی های مورد نیاز ممکن است بین نسخه ها تغییر کند. اگر می خواهید از نسخه ای متفاوت از نسخه اخیر استفاده کنید، به تاریخچه بخش وابستگی ها در sdk/build.gradle مخزن Cardboard SDK نگاهی بیندازید.

تنظیمات مدیریت پلاگین XR را پیکربندی کنید

به XR Plug-in Management بروید.

1. Cardboard XR Plugin در قسمت Plug-in Providers انتخاب کنید.

پروژه خود را بسازید

به File > Build Settings بروید.

1. Build را انتخاب کنید یا دستگاهی را انتخاب کنید و Build and Run را انتخاب کنید.

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

به File > Build Settings بروید.

1. iOS را انتخاب کنید و Switch Platform را انتخاب کنید.
2. Add Open Scenes را انتخاب کنید و HelloCardboard را انتخاب کنید.

تنظیمات پخش کننده

به ویرایش > تنظیمات پروژه... بروید.

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

به Player > Resolution and Presentation بروید.

1. جهت پیش فرض را روی Landscape Left یا Landscape Right قرار دهید.

توجه: در حالی که توسط افزونه Cardboard XR پشتیبانی می شود، جهت گیری های پرتره و عمودی وارونه ممکن است فضای کافی برای رندر چشمی در دستگاه ها فراهم نکنند.

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

به Player > Other Settings بروید.

1. در توضیحات استفاده از دوربین ، نوشتن Cardboard SDK requires camera permission to read the QR code (required to get the encoded device parameters). .
2. در نسخه هدف حداقل iOS ، 12.0 را بنویسید.
3. دامنه شرکت خود را در زیر نام بسته مشخص کنید.
4. Top Edge ، Left Edge و Right Edge در حرکات Defer سیستم روی لبه ها علامت بزنید .

توجه: اگر از iPhone X استفاده می کنید، گزینه Hide home on iPhone X را انتخاب کنید.

تنظیمات مدیریت پلاگین XR را پیکربندی کنید

به XR Plug-in Management بروید.

1. Cardboard XR Plugin در قسمت Plug-in Providers انتخاب کنید.

پروژه خود را بسازید

به File > Build Settings بروید.

1. Build یا Build and Run را انتخاب کنید.

مرکز جدید

Cardboard SDK به شما امکان می دهد ردیاب هد را با استفاده از Recenter() دوباره تغییر دهید.

این مراحل را دنبال کنید تا با استفاده از برنامه نمونه آن را امتحان کنید:

1. دستگاه را به موقعیتی که می‌خواهید مجدداً تغییر دهید حرکت دهید (از آن به عنوان حالت سر به جلو استفاده کنید).
2. ماشه دستگاه Cardboard خود را حداقل سه ثانیه فعال نگه دارید.
3. ماشه را رها کنید.
4. ژست اولیه اکنون در جهتی است که دوربین به آن اشاره می کند.

حالت VR را روشن و خاموش کنید

Unity XR Plugin Management API به شما امکان می دهد حالت VR را برای افزونه Google Cardboard XR for Unity روشن یا خاموش کنید. مستندات کاربر نهایی و مثال‌های استفاده در مستندات کاربر نهایی Unity موجود است.

صحنه VrMode در نمونه HelloCardboard یک استفاده اساسی از API فوق الذکر را نشان می دهد. در این صحنه می توان با زدن exit حالت VR را خاموش کرد ، و فقط با ضربه زدن روی هر نقطه از صفحه می توان دوباره آن را روشن کرد. VrModeController.cs را برای جزئیات در مورد نحوه انجام این کار بررسی کنید.

مراحل بعدی

• دستورالعمل های برندسازی Cardboard را مرور کنید.