Unreal Engine 4 - Samsung Gear VR

Jakub Pałka

12 marca 2017

Spis tresci

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

1 Pobranie instalatora pakietu NVPack

Instalacje oprogramowania do Samsung Gear VR dla Unreal Engine 4 zaczniemy od pobrania spe-cjalnej paczki zawierajacej wymagane składniki dla silnika. Zamiast wspomnianej paczki moznainstalowac wymagane pakiety recznie.

https://developer.nvidia.com/codeworks-android

Rysunek 1: CodeWorks page

Po wejsciu na strone klikamy w przycisk Download, który przeniesie nas na podstrone zmozliwoscia wyboru instalatora pakietu na odpowiedni system. Klikamy na link z wybranymprzez nas systemem.

2 Instalacja NVPack

Instalacja pakietu przebiega automatycznie, wystarczy klikac przycisk Dalej (Next). Ustawie-nia instalowanych komponentów zostawiamy domyslnie (chyba, ze zyczymy sobie instalowanienarzedzi pod rózne wersje anroida). Zapamietajmy jednak sciezke dostepu do instalowanych pa-kietów, poniewaz przyda nam sie w póniejszym czasie.

2

3 Podłaczenie telefonu i wygenerowanie pliku OSIG

Teraz zajmiemy sie wygenerowaniem pliku, który pozwoli nas na instalacje naszego projektu bez-posriednio na telefon przez plik .bat. Do tego kroku jest wymagany komponent ADB (instalowanyprzez NVPack).

1. Podłaczamy nasz telefon do komputera przez kabel USB.

2. Upewniamy sie, ze nasz telefon jest w trybie Debugging USB.

3. Otwieramy konsole CMD w systemie, wpisujemy „adb devices".

4. W konsoli powinna sie ukazac lista urzadzen podłaczonych do naszego komputera.

Rysunek 2: ADB Devices

5. Kopiujemy ID urzadzenia (w tym przypadku 214d442a).

6. Wchodzimy na strone: https://www.oculus.com/, zjezdzamy na sam dół i klikamyTools.

Rysunek 3: Oculus Tools

3

7. Wybieramy OSIG Generator, wpisujemy ID urzadzenia i klikamy Download File.

Rysunek 4: OSIG Generator

8. Juz prawie skonczylismy :) Teraz wystarczy nasz plik skopiowac do folderugdzie zainstalowany jest silnik (NIE PROJEKT). W moim przypadku jest toF:/ProgramFiles/EpicGames/UE4.15/Engine/Build/Android/Java.W folderze Java two-rzymy jesli nie istnieje folder assets i tam wklejamy nasz plik.

4

4 Tworzymy projekt pod Samsung Gear VR

Wreszcie jestesmy gotowi na stworzenie projektu na silniku, otwórzmy UnrealEngineLauncher i zzakładki Biblioteka wybierzmy nasza wersje silnika klikajac Uruchom. Naszym oczom powinnoukazac sie okienko z wyborem nowego projektu.

Rysunek 5: VR Project Setup

Wybieram jakis szablon, najwazniejsze dla nas beda ustawienia trzech okienek, odpowiednioMobile/Tablet, Scalable 3D or 2D oraz textbfNo starter Content dla jak najszybszego spakowaniaprojektu, z czym to ostatnie mozna dodac według uznania (jesli chce sie miec dostep do zawartosciudostepnianej przez twórców). Po otwarciu projektu klikamy w Edit->Plugins. Wybieramy zsekcji po lewej stronie Virtual Reality i odznaczamy Oculus Rift Plugin oraz upewniamy sie, zemamy zaznaczona opcje Gear VR. Klikamy Restart Now.

Nastepnie znów klikamy Edit->Project Settings. Odszukujemy sekcje Platforms->Andoid.Klikamy na przycisk znajdujacy sie na czerwonym polu Configure Now i ustawiamy opcje TargetSDK Version = 19 oraz zaznaczamy Configure the AndroidManifest for deployment GearVR. Przechodzimy jeszcze do sekcji Project->Supported Platforms i upewniamy sie, ze mamyzaznaczona opcje Android.

Teraz przechodzimy do sekcji Android SDK->SDK Config. Musimy ustawic cztery opcjeLocation wskazujac im odpowiedni adres do zainstalowanego komponentu z NVPack. Ja zainsta-lowałem NVPack na dysku D, wiec mój Config wyglada jak powyzej.

5

Rysunek 6: VR Plugins

5 Pakowanie projektu i instalacja na telefonie

Ostatnia rzecza, która dzis omówie bedzie pakowanie projektu do pliku .apk, który jak dobrzewiemy jest plikiem instalacyjnym na platformie Android. Postepujemy wiec według nastepu-jacego porzadku: Klikamy File->Package Project->Android->Android(ETC2). Wybieramymiejsce zapisu plików i czekamy na zakonczenie budowy projektu (za pierwszym razem mozetrwał bardzo długo, poniewaz silnik musi zbudowac od poczatku cały projekt). Po instalacjiwchodzimy do folderu z wygenerowanym plikiem apk, znajduje sie tam tez plik bat o nazwie In-stallProjectName.... Kliknijmy na niego dwukrotnie (pamietajmy, ze musimy miec podłaczonytelefon). Naszym oczom ukaze sie konsola i informacja o postepie instalacji projektu.

6

Rysunek 7: Android i AndroidSDK

Rysunek 8: Android Package

6 Problemy z ADB Devices

Czasami moga wystapic problemy zwiazane z wykryciem urzadzenia, wtedy najlepiej spróbowac:

7

• Zmienic kabel USB na inny lub sam port w komputerze.

• wspisac odpowiednio komendy adb kill-server oraz adb start-server.

• Upewnic sie, ze podłaczamy urzadzenie w trybie Debuging USB.

8