Differences
This shows you the differences between two versions of the page.
|
irva:laboratoarevr:01 [2024/10/15 14:32] andrei.lapusteanu Fixed wrong asset names |
irva:laboratoarevr:01 [2025/09/27 01:32] (current) andrei.lapusteanu Revamped lab (text, images) |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| - | ===== Laborator VR 01. Google Cardboard ===== | + | ===== Laborator VR 01. Google Cardboard XR ===== |
| ==== Înainte de a începe laboratorul... ==== | ==== Înainte de a începe laboratorul... ==== | ||
| Line 19: | Line 19: | ||
| {{ :irva:laboratoare:l6_cardboardgif.gif?400 |}} | {{ :irva:laboratoare:l6_cardboardgif.gif?400 |}} | ||
| - | Aceste dispozitive de tip holder se pot achiziționa de la diverse brand-uri – se pot achiziționa, de asemenea, controller-e de tip joystick ce comunică pe Bluetooth cu telefonul, pentru a avea un control sporit în scenele virtuale (de exemplu, se poate implementa movement-ul sau diferite interacțiuni folosind aceste controller-e). | + | Aceste dispozitive de tip holder se pot achiziționa de la diverse brand-uri – se pot achiziționa, de asemenea, controllere de tip joystick ce comunică pe Bluetooth cu telefonul, pentru a avea un control sporit în scenele virtuale (de exemplu, se poate implementa movement-ul sau diferite interacțiuni folosind aceste controllere). |
| {{ :irva:laboratoare:l6_bt_controller.jpg?200 |}} | {{ :irva:laboratoare:l6_bt_controller.jpg?200 |}} | ||
| Line 27: | Line 27: | ||
| * **Compatibilitate**: Există suport atât pentru Android cât și pentru iOS | * **Compatibilitate**: Există suport atât pentru Android cât și pentru iOS | ||
| * **Integrare seamless**: Se folosește de framework-ul de XR din Unity, facilitând astfel dezvoltarea rapidă a aplicațiilor de tip VR | * **Integrare seamless**: Se folosește de framework-ul de XR din Unity, facilitând astfel dezvoltarea rapidă a aplicațiilor de tip VR | ||
| - | * **Feature-uri**: Suport pentru head tracking (folosind senzorii giroscopici și accelerometrele găsite în telefoane), randare stereoscopică (un render pentru fiecare ochi – se desenează fiecare render pe jumătate din ecranul dispozitivului), precum și diverse metode implementate în software, precum gaze interaction, ce permite interacțiunea cu diverse obicte prin simpla privire a acestora | + | * **Feature-uri**: Suport pentru head tracking (folosind senzorii giroscopici și accelerometrele găsite în telefoane), randare stereoscopică (un render pentru fiecare ochi – se desenează pe jumătate din ecranul dispozitivului), precum și diverse metode implementate în software, precum gaze interaction, ce permite interacțiunea cu diverse obicte prin simpla privire a acestora |
| <note tip>În mod evident, soluțiile dedicate pentru VR (HTC Vive, Meta Quest 2/3, Meta Pro, etc.) oferă o experiență virtuală mult superioară procesării posibile pe un smartphone, dar acest plugin ne permite să avem un prim sneak peek al tehnologiei VR într-un mod accesibil.</note> | <note tip>În mod evident, soluțiile dedicate pentru VR (HTC Vive, Meta Quest 2/3, Meta Pro, etc.) oferă o experiență virtuală mult superioară procesării posibile pe un smartphone, dar acest plugin ne permite să avem un prim sneak peek al tehnologiei VR într-un mod accesibil.</note> | ||
| Line 36: | Line 36: | ||
| * Prezentăm pe scurt modalitatea de **integrare a plugin-ului** într-un proiect de Unity | * Prezentăm pe scurt modalitatea de **integrare a plugin-ului** într-un proiect de Unity | ||
| * **Testăm** demo sample-ul pentru a valida funcționarea corectă a plugin-ului | * **Testăm** demo sample-ul pentru a valida funcționarea corectă a plugin-ului | ||
| - | * Implementăm cateva feature-uri pentru un joc simplu (balloon popper), ce funcționează pe conceptul de **gaze interaction** | + | * Implementăm câteva feature-uri pentru un joc simplu (balloon popper), ce funcționează pe conceptul de **gaze interaction** |
| <note tip>În mod ideal, testarea funcționalităților din laborator se face folosind un dispozitiv de tip holder VR pentru smartphone, dar se poate testa și în absența acestuia. De asemenea, nu este necesară folosirea unui joystick pentru mobile.</note> | <note tip>În mod ideal, testarea funcționalităților din laborator se face folosind un dispozitiv de tip holder VR pentru smartphone, dar se poate testa și în absența acestuia. De asemenea, nu este necesară folosirea unui joystick pentru mobile.</note> | ||
| + | |||
| + | ==== Unity build profiles ==== | ||
| + | |||
| + | Începând cu Unity 6, modalitatea de lucru cu build-urile si scenele de inclus în build a suferit mici modificări. Noile funcționalități se regăsesc în **File -> Build Profiles**. | ||
| + | |||
| + | {{ :irva:laboratoarevr:irva_2025_vr_l1_build_profiles_1.png?500 |}} | ||
| + | |||
| + | <note tip>Spre deosebire de vesiunile anterioare de Unity, aici avem conceptul de **profile de build**, care ne ajută sa diferențiem setările în funcție de platforma target (de ex., Android), precum și setările pentru device-uri diferite (de ex., puteți crea un build profile pentru Android specific pentru Google Cardboard XR și alt profil tot de Android pentru dispozitivele Quest de la Meta).</note> | ||
| + | |||
| + | * Creați-vă un nou **profil de build** pentru **Android**, selectați-l și apăsați pe **Switch Platform** | ||
| + | * Pe profilul nou creat, puteți crea un **override** la setările tip **Player** din Unity (setări aferente build-ului). Având profilul creat selectat, apăsați pe **Customize Player Settings** | ||
| + | * Interfața ar trebui să arate similar imaginii de mai jos | ||
| + | |||
| + | {{ :irva:laboratoarevr:irva_2025_vr_l1_build_profiles_3.png?500 |}} | ||
| ==== Integrare Google Cardboard XR Plugin în proiect ==== | ==== Integrare Google Cardboard XR Plugin în proiect ==== | ||
| + | |||
| + | <note warning> | ||
| + | Asigurați-vă că aveți [[https://git-scm.com|Git]] instalat pe sistemul vostru! Altfel nu veți putea adăuga pachete via managerul de pachete din Unity folosit URL-uri git. | ||
| + | </note> | ||
| + | |||
| + | <note important>**⚠️ Înainte să implementați ghidul din link-ul de mai jos ⚠️** | ||
| + | * Tutorialul vă va indica să setați **Target API Level 33**. Folosiți în schimb nivelul **34** pentru a nu avea erori la build-uri | ||
| + | </note> | ||
| Întrucât pașii pentru integrarea acestui pachet sunt bine descriși în [[https://developers.google.com/cardboard/develop/unity/quickstart|acest]] acest ghid, vă recomandăm să-l urmați și voi - cel mai probabil veți face acești pași împreună cu asistentul de laborator. | Întrucât pașii pentru integrarea acestui pachet sunt bine descriși în [[https://developers.google.com/cardboard/develop/unity/quickstart|acest]] acest ghid, vă recomandăm să-l urmați și voi - cel mai probabil veți face acești pași împreună cu asistentul de laborator. | ||
| Line 48: | Line 70: | ||
| {{ :irva:laboratoarevr:irva_2024_vr_l1_cardboardsamples.png?500 |}} | {{ :irva:laboratoarevr:irva_2024_vr_l1_cardboardsamples.png?500 |}} | ||
| - | **⚠️ Atenție ⚠️** la build-urile pe Android! S-ar putea ca API-ul grafic Vulkan să nu ruleze deloc pe smartphone-ul vostru. Așadar, când ajungeți la pasul de setup al API-ului grafic: | + | **⚠️ Atenție ⚠️** la build-urile pe Android! S-ar putea ca API-ul grafic Vulkan să nu ruleze deloc (sau cu artefacte) pe smartphone-ul vostru. Așadar, când ajungeți la pasul de setup al API-ului grafic: |
| - | * Asigurați-vă ca din **File -> Build Settings** este selectată platofrma Android | + | * Asigurați-vă că aveți selectat **build profile-ul** corect |
| - | * Navigați la **Player Settings -> Other Settings -> Graphics APIs** și setați ''OpenGLES3'' ca primul din listă | + | * Din setările **Player** (sau **Player Settings Override** dacă ați făcut override pe profilul de build creat), din secțiunea **Other Settings** debifați opțiunea **Auto Graphics API** |
| + | * Setați ''OpenGLES3'' ca primul (sau singurul) din listă | ||
| - | {{ :irva:laboratoarevr:irva_2024_vr_l1_graphicsapis.png?500 |}} | + | {{ :irva:laboratoarevr:irva_2025_vr_l1_graphicsapis.jpg?500 |}} |
| ==== Pre-build setup ==== | ==== Pre-build setup ==== | ||
| - | Îndată ce se încheie instalarea pachetului Google Cardboard XR Plugin, ar trebui să vă apară în toolbar-ul (de sus) din Unity un nou menu item, pe care va trebui să-l folosiți pentru a seta o serie de dependințe ce țin de bibliotecile XR. | + | Îndată ce se încheie instalarea pachetului Google Cardboard XR Plugin, ar trebui să vă apară în toolbar-ul din Unity un nou menu item, pe care va trebui să-l folosiți pentru a seta o serie de dependințe ce țin de bibliotecile XR. |
| - | În proiectul Unity de VR veți include, pe parcursul laboratoarelor, diverse SDK-uri necesare pentru rezolvarea acestora. Întrucât integrarea tuturor acestora într-un singur proiect poate crea unele probleme, a fost implementat un editor script custom (accesat din acest meniu) care se ocupă de configurarea soluției dependent de laboratorul pentru care doriți să faceți build. | + | În proiectul Unity de VR veți include, pe parcursul laboratoarelor, diverse SDK-uri necesare pentru rezolvarea acestora. Întrucât integrarea tuturor acestora într-un singur proiect poate crea unele probleme, a fost implementat un script custom în proiect (accesat din acest meniu) care se ocupă de configurarea soluției dependent de laboratorul pentru care doriți să faceți build. |
| - | {{ :irva:laboratoarevr:irva_2024_vr_l1_xrloader.png?300 |}} | + | {{ :irva:laboratoarevr:irva_2025_vr_l1_xrloader.png?300 |}} |
| <note warning> | <note warning> | ||
| Line 71: | Line 94: | ||
| </note> | </note> | ||
| - | Pentru acest laborator va trebui să setați activă opțiunea **Set Cardboard XR Loader**. Funcționarea este marcată în felul următor: | + | <note>Pentru acest laborator va trebui să setați activă opțiunea **Set Cardboard XR loader**.</note> |
| - | * Mesajele de tip info denotă o configurație aplicată cu succes | + | |
| - | * Mesajele de tip warning denotă faptul că probabil nu aveți un anume SDK instalat - este normal pentru acest prim laborator de VR! | + | |
| - | * Mesajele de tip eroare indică o posibilă problemă | + | |
| - | {{ :irva:laboratoarevr:irva_2024_vr_l1_xrpluginmessages.png?600 |}} | + | În cazul în care în consolă vă apar următoarele mesaje, operațiunea a avut loc cu succes. |
| - | ==== Testarea scenei sample ==== | + | {{ :irva:laboratoarevr:irva_2025_vr_l1_xrpluginmessages_1.png?600 |}} |
| + | |||
| + | Mesajele marcate cu roșu indică incompatibilități între loader-ul XR și platforma target (nu sunt erori: se specifică doar faptul ca de exemplu SteamVR nu este suportat ca un XR loader valid în cazul în care build target-ul este Android). | ||
| + | |||
| + | Mesajele cu galben sugerează compatibilitate între XR loader și platforma target, dar loader-ul nu a fost setat cu succes întrucat pachet-ul / SDK-ul nu a fost (încă) instalat. | ||
| + | |||
| + | {{ :irva:laboratoarevr:irva_2025_vr_l1_xrpluginmessages_2.png?600 |}} | ||
| + | |||
| + | ==== Adăugarea scenelor virtuale în build ==== | ||
| + | |||
| + | Totodată cu Unity 6, modalitatea de lucru cu scenele a suferit câteva modificări. În **File -> Build Profiles** găsiți **Scene List**, ce reprezintă modalitatea centralizată prin care se pot include scene în build-urile voastre. | ||
| - | * Mergeți în **File > Build Settings** și asigurați-vă că platforma pentru care doriți să faceți build este corectă. În caz contrar, faceți switch pe platforma dorită (Android sau iOS) | ||
| * Vom testa scena **Assets -> Samples -> Google Cardboard XR Plugin for Unity -> <versiune> -> Hello Cardboard -> Scenes -> HelloCardboard**. | * Vom testa scena **Assets -> Samples -> Google Cardboard XR Plugin for Unity -> <versiune> -> Hello Cardboard -> Scenes -> HelloCardboard**. | ||
| - | * Mergeți în **File -> Build Settings** și setați această scenă ca fiind singura activă (folosind checkbox-ul) în panoul de **Scenes In Build** | ||
| - | {{ :irva:laboratoarevr:irva_2024_vr_l1_buildscenes.png?600 |}} | + | * Adăugați scena **HelloCardboard** în această lista, precum în imaginea de mai jos |
| + | |||
| + | {{ :irva:laboratoarevr:irva_2025_vr_l1_scene_list.png?500 |}} | ||
| * Vom realiza un build acum pe smartphone! Pașii următori sunt specifici unui telefon Android: | * Vom realiza un build acum pe smartphone! Pașii următori sunt specifici unui telefon Android: | ||
| * **Conectați-vă telefonul** prin cablu la laptop / PC | * **Conectați-vă telefonul** prin cablu la laptop / PC | ||
| * Puneți telefonul în modul de **transfer de fișiere** | * Puneți telefonul în modul de **transfer de fișiere** | ||
| + | * Dacă doriți să faceți **deploy direct pe telefon** la finalizarea build-ului (modul **Build And Run**), va trebui întâi să aveți **USB Debugging** activat pe telefon (opțiunea se poate activa din setările de dezvoltator ale telefonului vostru) | ||
| * În continuare, puteți crea un **Build** pe care să-l testați pe telefon. Pentru a realiza acest build, din acesași panoul (Build Settings), selectați **Build** sau **Build And Run**: | * În continuare, puteți crea un **Build** pe care să-l testați pe telefon. Pentru a realiza acest build, din acesași panoul (Build Settings), selectați **Build** sau **Build And Run**: | ||
| Line 107: | Line 138: | ||
| * **CubeRoom** reprezinta modelul environment-ului scenei | * **CubeRoom** reprezinta modelul environment-ului scenei | ||
| - | * **Treasure** reprezinta un obiect interactibil – daca îl studiați în inspector, veți observa că are atașat un script de tip **ObjectController** | + | * **Treasure** reprezinta un obiect interactibil – daca îl studiați în inspector, veți observa că are atașat un script de tip ''ObjectController'' |
| - | * Camera are un obiect copil numit **CardboardReticlePointer** ce reprezintă reticle-ul / crosshair-ul direcției de vizualizare. Script-ul atașat pe acesta interacționează cu script-urile de tip **ObjectController**, căruia îi transmite mesaje de tip **OnPoinerEnter** și **OnPointerExit**, ceea ce denotă acțiunea de gaze (privire) asupra obiectelor | + | * Camera are un obiect copil numit **CardboardReticlePointer** ce reprezintă reticle-ul / crosshair-ul direcției de vizualizare. Script-ul atașat pe acesta interacționează cu script-urile de tip ''ObjectController'', căruia îi transmite mesaje de tip ''OnPoinerEnter'' și ''OnPointerExit'', ceea ce denotă acțiunea de gaze (privire) asupra obiectelor |
| ==== Implementarea jocului ==== | ==== Implementarea jocului ==== | ||
| Line 122: | Line 153: | ||
| {{ :irva:laboratoarevr:irva_2024_vr_l1_skeletonscene.png?200 |}} | {{ :irva:laboratoarevr:irva_2024_vr_l1_skeletonscene.png?200 |}} | ||
| - | * **BaloonSpawner** este obiectul care va instanția baloanele în scenă. Acesta se află în zona podelei scenei. Are o componentă de tip BoxCollider, în volumul căreia trebuie instanțiate baloanele la locații random | + | * **BaloonSpawner** este obiectul care va instanția baloanele în scenă. Acesta se află în zona podelei scenei. Are o componentă de tip ''BoxCollider'', în volumul căreia trebuie instanțiate baloanele la locații random |
| - | * **BaloonController** (nu se regăsește în ierarhie, este un script atașat prefab-ului ‘Baloon’) reprezintă obiectul de tip balon – acesta trebuie să fie translatat pe Y și va conține logica de interacțiune cu reticle-ul player-ului | + | * **BaloonController** (nu se regăsește în ierarhie, este un script atașat prefab-ului 'Baloon') reprezintă obiectul de tip balon – acesta trebuie să fie translatat pe Y și va conține logica de interacțiune cu reticle-ul player-ului |
| * **BalloonPopper** are atașat un script ce distruge baloanele dacă există overlap cu collider-ul obiectelor de tip balon. Acesta este definit în zona de tavan a scenei | * **BalloonPopper** are atașat un script ce distruge baloanele dacă există overlap cu collider-ul obiectelor de tip balon. Acesta este definit în zona de tavan a scenei | ||
| * **ScoreCanvas** conține logică pentru scor și poate seta textul unui element de UI definit în world space | * **ScoreCanvas** conține logică pentru scor și poate seta textul unui element de UI definit în world space | ||
