Unreal Engine 4 - Samsung Gear VR Jakub Pałka 12 marca 2017 Spis treści 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 Instalację oprogramowania do Samsung Gear VR dla Unreal Engine 4 zaczniemy od pobrania specjalnej paczki zawierającej wymagane składniki dla silnika. Zamiast wspomnianej paczki można instalować wymagane pakiety ręcznie. https://developer.nvidia.com/codeworks-android Rysunek 1: CodeWorks page Po wejściu na stronę klikamy w przycisk Download, który przeniesie nas na podstronę z możliwością wyboru instalatora pakietu na odpowiedni system. Klikamy na link z wybranym przez nas systemem. 2 Instalacja NVPack Instalacja pakietu przebiega automatycznie, wystarczy klikać przycisk Dalej (Next). Ustawienia instalowanych komponentów zostawiamy domyślnie (chyba, że życzymy sobie instalowanie narzędzi pod różne wersje anroida). Zapamiętajmy jednak ściężkę dostepu do instalowanych pakietów, ponieważ przyda nam się w póniejszym czasie. 2
3 Podłaczenie telefonu i wygenerowanie pliku OSIG Teraz zajmiemy się wygenerowaniem pliku, który pozwoli nas na instalację naszego projektu bezpośriednio na telefon przez plik.bat. Do tego kroku jest wymagany komponent ADB (instalowany przez NVPack). 1. Podłączamy nasz telefon do komputera przez kabel USB. 2. Upewniamy się, że nasz telefon jest w trybie Debugging USB. 3. Otwieramy konsolę CMD w systemie, wpisujemy adb devices". 4. W konsoli powinna się ukazać lista urządzeń podłączonych do naszego komputera. Rysunek 2: ADB Devices 5. Kopiujemy ID urządzenia (w tym przypadku 214d442a). 6. Wchodzimy na stronę: https://www.oculus.com/, zjeżdżamy na sam dół i klikamy Tools. Rysunek 3: Oculus Tools 3
7. Wybieramy OSIG Generator, wpisujemy ID urządzenia i klikamy Download File. Rysunek 4: OSIG Generator 8. Już prawie skończyliśmy :) Teraz wystarczy nasz plik skopiować 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 tworzymy jeśli nie istnieje folder assets i tam wklejamy nasz plik. 4
4 Tworzymy projekt pod Samsung Gear VR Wreszcie jesteśmy gotowi na stworzenie projektu na silniku, otwórzmy UnrealEngineLauncher i z zakładki Biblioteka wybierzmy naszą wersję silnika klikając Uruchom. Naszym oczom powinno ukazać się okienko z wyborem nowego projektu. Rysunek 5: VR Project Setup Wybieram jakiś szablon, najważniejsze dla nas będą ustawienia trzech okienek, odpowiednio Mobile/Tablet, Scalable 3D or 2D oraz textbfno starter Content dla jak najszybszego spakowania projektu, z czym to ostatnie można dodać według uznania (jeśli chce się mieć dostęp do zawartości udostępnianej 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 mamy zaznaczoną opcję Gear VR. Klikamy Restart Now. Następnie znów klikamy Edit->Project Settings. Odszukujemy sekcję Platforms->Andoid. Klikamy na przycisk znajdujący się na czerwonym polu Configure Now i ustawiamy opcje Target SDK Version = 19 oraz zaznaczamy Configure the AndroidManifest for deployment Gear VR. Przechodzimy jeszcze do sekcji Project->Supported Platforms i upewniamy się, że mamy zaznaczoną opcję Android. Teraz przechodzimy do sekcji Android SDK->SDK Config. Musimy ustawić cztery opcje Location wskazując im odpowiedni adres do zainstalowanego komponentu z NVPack. Ja zainstalowałem NVPack na dysku D, więc mój Config wygląda jak powyżej. 5
Rysunek 6: VR Plugins 5 Pakowanie projektu i instalacja na telefonie Ostatnią rzeczą, którą dziś omówię będzie pakowanie projektu do pliku.apk, który jak dobrze wiemy jest plikiem instalacyjnym na platformie Android. Postępujemy więc według następującego porządku: Klikamy File->Package Project->Android->Android(ETC2). Wybieramy miejsce zapisu plików i czekamy na zakończenie budowy projektu (za pierwszym razem może trwał bardzo długo, ponieważ silnik musi zbudować od początku cały projekt). Po instalacji wchodzimy do folderu z wygenerowanym plikiem apk, znajduje się tam też plik bat o nazwie InstallProjectName... Kliknijmy na niego dwukrotnie (pamiętajmy, że musimy mieć podłączony telefon). Naszym oczom ukaże się konsola i informacja o postępie instalacji projektu. 6
Rysunek 7: Android i AndroidSDK 6 Problemy z ADB Devices Rysunek 8: Android Package Czasami mogą wystąpić problemy związane z wykryciem urządzenia, wtedy najlepiej spróbować: 7
Zmienić kabel USB na inny lub sam port w komputerze. wspisać odpowiednio komendy adb kill-server oraz adb start-server. Upewnić się, że podłączamy urzadzenie w trybie Debuging USB. 8