Unreal Engine 4 - Samsung Gear VR
Jakub Pałka 12 marca 2017
Spis tre´sci
1 Pobranie instalatora pakietu NVPack 2
2 Instalacja NVPack 2
3 Podł ˛aczenie telefonu i wygenerowanie pliku OSIG 3
4 Tworzymy projekt pod Samsung Gear VR 5
5 Pakowanie projektu i instalacja na telefonie 6
6 Problemy z ADB Devices 7
1 Pobranie instalatora pakietu NVPack
Instalacj˛e oprogramowania do Samsung Gear VR dla Unreal Engine 4 zaczniemy od pobrania spe- cjalnej paczki zawieraj ˛acej wymagane składniki dla silnika. Zamiast wspomnianej paczki mo˙zna instalowa´c wymagane pakiety r˛ecznie.
https://developer.nvidia.com/codeworks-android
Rysunek 1: CodeWorks page
Po wej´sciu na stron˛e klikamy w przycisk Download, który przeniesie nas na podstron˛e z mo˙zliwo´sci ˛a wyboru instalatora pakietu na odpowiedni system. Klikamy na link z wybranym przez nas systemem.
2 Instalacja NVPack
Instalacja pakietu przebiega automatycznie, wystarczy klika´c przycisk Dalej (Next). Ustawie- nia instalowanych komponentów zostawiamy domy´slnie (chyba, ˙ze ˙zyczymy sobie instalowanie narz˛edzi pod ró˙zne wersje anroida). Zapami˛etajmy jednak ´sci˛e˙zk˛e dostepu do instalowanych pa- kietów, poniewa˙z przyda nam si˛e w póniejszym czasie.
3 Podł ˛ aczenie telefonu i wygenerowanie pliku OSIG
Teraz zajmiemy si˛e wygenerowaniem pliku, który pozwoli nas na instalacj˛e naszego projektu bez- po´sriednio na telefon przez plik .bat. Do tego kroku jest wymagany komponent ADB (instalowany przez NVPack).
1. Podł ˛aczamy nasz telefon do komputera przez kabel USB.
2. Upewniamy si˛e, ˙ze nasz telefon jest w trybie Debugging USB.
3. Otwieramy konsol˛e CMD w systemie, wpisujemy „adb devices".
4. W konsoli powinna si˛e ukaza´c lista urz ˛adze´n podł ˛aczonych do naszego komputera.
Rysunek 2: ADB Devices
5. Kopiujemy ID urz ˛adzenia (w tym przypadku 214d442a).
6. Wchodzimy na stron˛e: https://www.oculus.com/, zje˙zd˙zamy na sam dół i klikamy Tools.
7. Wybieramy OSIG Generator, wpisujemy ID urz ˛adzenia i klikamy Download File.
Rysunek 4: OSIG Generator
8. Ju˙z prawie sko´nczyli´smy :) Teraz wystarczy nasz plik skopiowa´c do folderu gdzie zainstalowany jest silnik (NIE PROJEKT). W moim przypadku jest to F:/ProgramFiles/EpicGames/UE4.15/Engine/Build/Android/Java.W folderze Java two- rzymy je´sli nie istnieje folder assets i tam wklejamy nasz plik.
4 Tworzymy projekt pod Samsung Gear VR
Wreszcie jeste´smy gotowi na stworzenie projektu na silniku, otwórzmy UnrealEngineLauncher i z zakładki Biblioteka wybierzmy nasz ˛a wersj˛e silnika klikaj ˛ac Uruchom. Naszym oczom powinno ukaza´c si˛e okienko z wyborem nowego projektu.
Rysunek 5: VR Project Setup
Wybieram jaki´s szablon, najwa˙zniejsze dla nas b˛ed ˛a ustawienia trzech okienek, odpowiednio Mobile/Tablet, Scalable 3D or 2D oraz textbfNo starter Content dla jak najszybszego spakowania projektu, z czym to ostatnie mo˙zna doda´c według uznania (je´sli chce si˛e mie´c dost˛ep do zawarto´sci udost˛epnianej przez twórców). Po otwarciu projektu klikamy w Edit->Plugins. Wybieramy z sekcji po lewej stronie Virtual Reality i odznaczamy Oculus Rift Plugin oraz upewniamy si˛e, ˙ze mamy zaznaczon ˛a opcj˛e Gear VR. Klikamy Restart Now.
Nast˛epnie znów klikamy Edit->Project Settings. Odszukujemy sekcj˛e Platforms->Andoid.
Klikamy na przycisk znajduj ˛acy si˛e na czerwonym polu Configure Now i ustawiamy opcje Target
Rysunek 6: VR Plugins
5 Pakowanie projektu i instalacja na telefonie
Ostatni ˛a rzecz ˛a, któr ˛a dzi´s omówi˛e b˛edzie pakowanie projektu do pliku .apk, który jak dobrze wiemy jest plikiem instalacyjnym na platformie Android. Post˛epujemy wi˛ec według nast˛epu- j ˛acego porz ˛adku: Klikamy File->Package Project->Android->Android(ETC2). Wybieramy miejsce zapisu plików i czekamy na zako´nczenie budowy projektu (za pierwszym razem mo˙ze trwał bardzo długo, poniewa˙z silnik musi zbudowa´c od pocz ˛atku cały projekt). Po instalacji wchodzimy do folderu z wygenerowanym plikiem apk, znajduje si˛e tam te˙z plik bat o nazwie In- stallProjectName.... Kliknijmy na niego dwukrotnie (pami˛etajmy, ˙ze musimy mie´c podł ˛aczony telefon). Naszym oczom uka˙ze si˛e konsola i informacja o post˛epie instalacji projektu.
Rysunek 7: Android i AndroidSDK
• Zmieni´c kabel USB na inny lub sam port w komputerze.
• wspisa´c odpowiednio komendy adb kill-server oraz adb start-server.
• Upewni´c si˛e, ˙ze podł ˛aczamy urzadzenie w trybie Debuging USB.