Repo-ul a fost updatat pentru a rezolva probleme ce țineau de testarea Quest Link-ului în editor și (unele) erori de Gradle.

S-ar putea ca setarea Project Settings → Player → Other Settings → Target API Level, care în mod implicit este pe Automatic (highest installed), să nu fie suficientă, așadar recomandăm să testați API Level-uri 31+.

Până în prezent, în proiectul suport au fost integrate diverse SDK-uri, precum Cardboard XR, SteamVR și Meta XR. Fiecare dintre acestea rulează pe un anumit target (Windows, Android, etc.), și necesită configurarea corectă a unui XR Plug-in provider.

Un XR plug-in provider este o componentă software ce permite interfațarea dintre Unity și hardware-ul VR – așadar, fiecare headset comunică printr-un provider diferit. Acest provider se poate configura în Project Settings → XR Plug-in Management → Plug-in Providers.

Așadar, în funcție de headset-ul target, trebuie să setați provider-ul corect – acest proces a fost automatizat în proiect prin implementarea script-ului XRPluginProviderController, care setează provider-ul corect în funcție de un VR target atât în testarea în editor cât și la realizarea unui build.

În fiecare scenă VR pe care doriți s-o testați:

• Includeți oriunde în ierarhia scenei la care lucrați prefab-ul Assets → Project Setup → CustomXRPluginProvider → Prefabs → [XRPluginProviderController]
• Setați din inspector de pe script-ul atașat target-ul VR corespunzător

Dispozitivele dezvoltate de către Meta (în trecut, cunoscute ca și Oculus) sunt soluții `all-in-one` ce permit dezvoltarea aplicațiilor de realitate virtuală și oferă suport pentru cele mai recente funcționalități din acest domeniu, precum hand tracking, realitate mixtă (MR), audio spațializat, eye și body tracking.

În mod curent, în seria Quest, regăsim 3 astfel de dispozitive ce oferă suport activ pentru dezvoltarea aplicațiilor VR, anume:

• Meta Quest 2 (pe care le veți folosi și voi) reprezintă încă o alegere bună pentru dezvoltarea (și consumul de content) VR
• Meta Quest 3 vine cu o serie de îmbunătățiri față de Meta Quest 2 precum o rezoluție mai bună, o nouă generație de chipset (SD XR2 Gen1 vs Gen2) și suport sporit pentru realitate mixtă
• Meta Quest Pro are un display panel mai bun, un upgrade de memorie RAM, dar avantajele principale sunt reprezentate de suport pentru face și eye tracking, precum și un design mai ergonomic. În plus, Meta Quest 3 și Meta Quest Pro vin cu controller-e ce au suport pentru feedback haptic mai avansat

Pentru dezvoltarea aplicațiilor de VR, există suport pentru OpenXR (aplicații native), sau SDK-uri ce oferă integrare cu game engine-urile standard, precum Unity și Unreal Engine.

Integrarea SDK-ului vine cu suport pentru diverse feature-uri pe care le putem utiliza, în funcție de necesitățile aplicației pe care dorim s-o dezvoltăm:

• Meta XR Code SDK: Funcționalități esențiale precum headset tracking, hand tracking, passthrough, ancore spațiale, etc.
• Interaction SDK: Funcționalități de interacțiune cu controller-ele sau mâinile, precum ray, poke, grab, etc.
• Meta XR Audio SDK: Suport pentru sunet spațializat
• Voice SDK
• Platform SDK: Aspecte `sociale` / networking: Matchmaking, In-App Purchasing (IAP), Cloud Storage, etc.
• Meta XR Simulator

În imaginea de mai jos puteți studia un flow generalizat al dezvoltării aplicațiilor de VR folosind dispozitivele celor de la Meta.

• Minim Unity 2021.3.26f1 cu modulul pentru Android instalat
• Dispozitiv Meta Quest 2 (se poate folosi și Meta Quest 3 sau Meta Quest Pro)
• Proiect Unity, link repo
  • Acesta are deja SDK-urile necesare integrate și configurate pentru voi 😁
• Oculus desktop app (download)
• Meta Quest Developer Hub (opțional, download)
• SideQuest (opțional, download page)

Aplicația vă oferă setări adiționale pentru un dispozitiv Quest conectat la calculator. Folosind MQDH puteți să:

• Vizualizați log-uri ale dispozitivului pentru a face debugging
• Screen cast, screen recording
• Instalare/deploy aplicații pe cască

Această secțiune este dedicată învățării workflow-ului de testare al unei aplicații direct în Unity Editor, fără a fi necesară realizarea unui build

• SDK-urile de interes pentru dezvoltare au fost deja integrate în proiectul suport, vă vom prezenta foarte pe scurt modalitatea de setup + câteva detalii
• Veți învăța să folosiți Oculus Link pentru testare în editor

Începând cu versiunea 59, pachetul de integrare se folosește de UPM (Unity Package Manager), oferind astfel o modalitate mai ușoară de integrare, realizarea rapidă a upgrade-urilor, iar probabil cel mai important, un management ușor în alegerea pachetelor esențiale de folosit (Core, Integration, Audio, etc.).

• Link către Meta docs pentru download SDK, iar pentru cei curioși, link către announcement-ul oficial UPM precum și detalii legate de import-ul pachetelor și modalități de update a acestora
• Pentru setup SDK într-un proiect Unity, accesați link-ul de download de mai sus, iar de pe Asset Store puteți alege să importați pachetul. Pachetul instalat îl veți găsi apoi în Package Manger în Unity (Window → Package Manager, iar din noua fereastră, din stânga sus, nu uitați să setați filtrul necesar)
• Pentru a realiza un build pe dispozitiv va trebui să schimbați target platform-ul pe Android
• Un tool util în puteți găsi în editor (Oculus → Tools → Project Setup Tool), care vă oferă indicații legate de setările optime pentru build

• Pentru a accelera testarea în acest setup inițial, în proiect a fost integrat pachet-ul de samples (download). Într-un proiect nou, după instalarea pachetului, din Package Manager puteți importa câteva scene demo.
• Aceste scene demo prezintă în mod detaliat diverse feature-uri posibile cu aceste headset-uri. Sunt un punct bun de plecare dacă doriți să integrați aceste funcționalități în alte proiecte ale voastre.

Quest Link (înainte cunoscut ca Oculus Link) este un feature disponibil pe device-uri ce permite folosirea acestora ca dispozitive de tip PC-VR – mai exact, vă puteți bucura de content VR care rulează pe PC și este streamed pe headset.

Puteți realiza conexiunea de tip Link între cască și PC prin două moduri: Prin cablu sau wireless (Air Link). Pentru Air Link trebuie să aveți headset-ul conectat la aceeași rețea locală ca și PC-ul la care vreți să conectați casca.

Setup-ul aferent Air Link-ului este prezentat în GIF-urile următoare. Întâi, asigurați-vă că toggle-ul de Quest Link este activ în setările headset-ului.

În continuare, puteți accesa Quest Link din meniul principal al căștii – de aici puteți să activați și funcția de Air Link.

Pe Quest (desktop app) confirmați codul de conectare.

Dacă totul s-a realizat cu succes ar trebui să fie interactibil butonul de Pair din meniul de Quest Link de pe headset.

1. În proiectul suport, deschideți scena de la următoarea cale: Assets → Samples → Meta XR Interaction SDK OVR Samples → 59.0.0 → Example Scenes → HandGrabExamples
2. Porniți Oculus Link pe headset
3. Rulați proiectul (Play din editor)

Sistemul de operare al acestor device-uri se bazează pe Android, așadar, procesul de build al unei aplicații este similar cu cel prezentat în laboratoarele precedente.

Puteți realiza build-uri în cel mai simplu mod prin opțiunea de Build And Run din meniul de Build Settings din Unity Editor. La finalul build-ului, aplicația este instalată pe headset și pornită în mod automat. Aplicația se poate apoi regăsi în următorul submeniu (vezi GIF).

Pentru alte variante de build, în urma construirii APK-ului din Unity (așadar Build simplu, nu Build And Run), se pot folosi Meta Quest Developer Hub sau SideQuest pentru instalarea acestor aplicații pe headset (proces cunsocut ca și sideloading).

1. Realizați pașii necesari setup-ului: Download repo (sau configurare proiect propriu cu SDK-ul necesar + samples), instalare software adițional, pairing prin Quest Link, testare scenă demo
2. În urma testării cu succes a scenei demo folosind Quest Link, realizați un build pe headset cu aceasta. În mod ideal, testați multiple variante de deployment (Build And Run, sideloading folosind MQDH sau SideQuest)
3. Creați-vă o scenă nouă (organizați-vă fișierele cum doriți în proiect, vă recomandăm să aveți un folder separat pentru ce lucrați custom) și urmăriți pașii din acest tutorial de tip Hello World – săriți peste pașii care sunt deja configurați, extrageți informația din etapele relavante din tutorial. În final, testați aplicația atât pe Quest Link cât și într-un build

• Studiați documentația relevantă a celor de la Meta (porniți de la link-ul de la pasul 3) și integrați în scena de la pasul 3 suport pentru controller-e; este sufficient dacă acestea apar în mediul virtual și sunt tracked în mod corect – setări avansate / hand tracking / gathering de input facem în următorul laborator