2. Inicjowanie projektu i pierwszej aplikacji

W pierwszym samouczku zaczniesz od nowego projektu Unreal i włączysz wtyczkę HoloLens, utworzysz i zapalisz poziom, a następnie dodasz kawałki szachowe. Będziesz używać naszych wstępnie wykonanych zasobów dla wszystkich obiektów i materiałów 3D, więc nie martw się o modelowanie niczego samodzielnie. Na koniec tego samouczka będziesz mieć pustą kanwę, która jest gotowa do obsługi rzeczywistości mieszanej.

Ważne

Upewnij się, że masz wszystkie wymagania wstępne ze strony Wprowadzenie.

Cele

  • Konfigurowanie projektu Unreal na potrzeby programowania HoloLens
  • Importowanie zasobów i konfigurowanie sceny
  • Tworzenie aktorów i zdarzeń na poziomie skryptu przy użyciu strategii

Tworzenie nowego projektu Unreal

Pierwszą rzeczą, z którą musisz pracować, jest projekt. Jeśli jesteś pierwszym deweloperem Unreal, musisz pobrać pliki pomocnicze z programu Epic Launcher.

  1. Uruchamianie aparatu Unreal Engine

  2. Wybierz pozycję Gry w obszarze Nowe Project Kategorie, a następnie kliknij przycisk Dalej.

Select Games project template

  1. Wybierz pusty szablon i kliknij przycisk Dalej.

Select the Blank template

  1. Ustaw pozycję C++, Skalowalne 3D lub 2D, Mobile/Tablet i Brak zawartości początkowej jako Project Ustawienia, a następnie wybierz lokalizację zapisu i kliknij przycisk Utwórz Project.

Uwaga

Aby skompilować wtyczkę narzędzia UX Tools, musisz wybrać projekt C++, a nie projekt strategii, który zostanie skonfigurowany w dalszej części sekcji 4.

Initial project settings

Projekt powinien zostać otwarty automatycznie w edytorze Unreal, co oznacza, że jesteś gotowy do następnej sekcji.

Włączanie wymaganych wtyczek

Aby korzystać z funkcji dostępnych za pośrednictwem platformy rzeczywistości mieszanej firmy Microsoft, należy najpierw zainstalować i włączyć wtyczkę Microsoft OpenXR. Aby dowiedzieć się więcej na temat wtyczki, możesz zapoznać się z projektem w GitHub.

  1. Otwórz aplikację Epic Games Launcher. Przejdź do witryny Unreal Engine Marketplace i wyszukaj ciąg "Microsoft OpenXR". Zainstaluj wtyczkę do aparatu.

Unreal Marketplace

  1. Wróć do edytora Unreal, przejdź do Project Ustawienia>Plugins i wyszukaj ciąg "Microsoft OpenXR". Upewnij się, że wtyczka jest włączona i uruchom ponownie edytor, jeśli zostanie wyświetlony monit.

Enabling Microsoft OpenXR plugin

Włączenie wtyczki Microsoft OpenXR spowoduje automatyczne włączenie wszystkich innych wtyczek wymaganych do opracowywania rzeczywistości mieszanej. Należy pamiętać, że wtyczka "Microsoft Windows Mixed Reality" musi być wyłączona w celu korzystania z biblioteki OpenXR.

Tworzenie poziomu

Następnym zadaniem jest utworzenie konfiguracji odtwarzacza z punktem wyjścia i modułem do celów referencyjnych i skalowania.

  1. Wybierz pozycję Plik > nowy poziom i wybierz pozycję Pusty poziom. Domyślna scena w widoku powinna być teraz pusta.

  2. Wybierz pozycję Podstawowe na karcie Tryby i przeciągnij pozycję PlayerStart do sceny.

    • Ustaw wartość LokalizacjaX = 0, Y = 0 i Z = 0 na karcie Szczegóły , aby ustawić użytkownika w środku sceny po uruchomieniu aplikacji.

Viewport with PlayerStart

  1. Przeciągnij moduł z karty Podstawowa do sceny.
    • Ustaw wartość LokalizacjaX = 50, Y = 0 i Z = 0. aby ustawić kostkę 50 cm od odtwarzacza w czasie rozpoczęcia.
    • Zmień skalę na X = 0,2, Y = 0,2 i Z = 0,2 , aby zmniejszyć moduł w dół.

Nie widzisz modułu, chyba że dodasz światło do sceny, czyli ostatnie zadanie przed przetestowaniem sceny.

  1. Przejdź do karty Światła na panelu Tryby i przeciągnij światło kierunkowe do sceny. Umieść światło powyżej pozycji PlayerStart , aby można było go zobaczyć.

Viewport with light added

  1. Przejdź do pozycji Zapisz plik > Bieżący, nadaj poziomowi nazwę Main i wybierz pozycję Zapisz.

Po ustawieniu sceny naciśnij przycisk Odtwórz na pasku narzędzi, aby zobaczyć moduł w akcji! Po zakończeniu podziwiania pracy naciśnij klawisz Esc , aby zatrzymać aplikację.

A cube in the viewport

Po skonfigurowaniu sceny możesz rozpocząć dodawanie na tablicy szachowej i kawałku, aby zaokrąglić środowisko aplikacji.

Importowanie zasobów

Scena wygląda nieco pusta w tej chwili, ale naprawisz to, importując gotowe zasoby do projektu.

  1. Pobierz i rozpakuj folder zasobów GitHub przy użyciu pliku 7-zip.

  2. Wybierz pozycję Dodaj nowy nowy > folder z przeglądarki zawartości i nadaj jej nazwę ChessAssets.

    • Kliknij dwukrotnie nowy folder, w którym zaimportujesz zasoby 3D.

Show or hide the sources panel

  1. Wybierz pozycję Importuj z przeglądarki zawartości, wybierz wszystkie elementy w rozpakowanym folderze zasobów, a następnie kliknij przycisk Otwórz.

    • Zasoby obejmują siatki obiektów 3D dla szachownicy i kawałki w formacie FBX i map tekstury w formacie TGA, który będzie używany do materiałów.
  2. Gdy pojawi się okno Opcje importu FBX, rozwiń sekcję Materiał i zmień metodę importu materiału na Nie utwórz materiału.

    • Wybierz pozycję Importuj wszystko.

Import FBX options

To wszystko, co musisz zrobić dla zasobów. Następnym zestawem zadań jest utworzenie bloków konstrukcyjnych aplikacji przy użyciu strategii.

Dodawanie strategii

  1. Wybierz pozycję Dodaj nowy folder > w przeglądarce zawartości i nadaj mu nazwę Blueprints.

Uwaga

Jeśli dopiero zaczynasz planować, są to specjalne zasoby, które udostępniają interfejs oparty na węźle do tworzenia nowych typów aktorów i zdarzeń na poziomie skryptu.

  1. Kliknij dwukrotnie folder Blueprints , a następnie kliknij prawym przyciskiem myszy i wybierz pozycję Klasa strategii.
    • Wybierz pozycję Aktor i nadaj nazwę tablicy strategii.

Select a parent class for your Blueprint

Nowa strategia tablicy jest teraz wyświetlana w folderze Blueprints , jak pokazano na poniższym zrzucie ekranu.

The new Board Blueprint

Wszystko jest ustawione, aby rozpocząć dodawanie materiałów do utworzonych obiektów.

Praca z materiałami

Utworzone obiekty są domyślnie szare, co nie jest bardzo zabawne, aby przyjrzeć się temu. Dodawanie materiałów i siatk do obiektów jest ostatnim zestawem zadań w tym samouczku.

  1. Kliknij dwukrotnie tablicę , aby otworzyć edytor strategii.

  2. Wybierz pozycję Dodaj scenę składnika > z panelu Składniki i nadaj mu nazwę Root. Zwróć uwagę, że element root jest wyświetlany jako element podrzędny DefaultSceneRoot na poniższym zrzucie ekranu:

Replacing the root in blueprint

  1. Kliknij i przeciągnij pozycję Root na wartość DefaultSceneRoot , aby go zastąpić i pozbyć się kuli w widoku.

Replacing the root

  1. Wybierz pozycję Dodaj statyczną Mesh składników > z panelu Składniki i nadaj jej nazwę SM_Board. Zostanie wyświetlony jako obiekt podrzędny w obszarze Root.

Adding a static mesh

  1. Wybierz pozycję SM_Board, przewiń w dół do sekcji Statyczna Mesh w panelu Szczegóły i wybierz pozycję Szachownica z listy rozwijanej.

The board mesh in the viewport

  1. Nadal w panelu Szczegóły rozwiń sekcję Materiały i wybierz pozycję Utwórz nowy materiał zawartości > z listy rozwijanej.
    • Nadaj materiałowi nazwę M_ChessBoard i zapisz go w folderze ChessAssets .

Create a new material

  1. Kliknij dwukrotnie materiał M_ChessBoard , aby otworzyć Edytor materiałów.

Open material editor

  1. W Edytorze materiałów kliknij prawym przyciskiem myszy i wyszukaj pozycję Przykład tekstury.
    • Rozwiń sekcję Baza tekstury wyrażenia materiału w panelu Szczegóły i ustaw pozycję Tekstura na ChessBoard_Albedo.
    • Przeciągnij wyprowadzenie danych wyjściowych RGB do pinezki Kolor podstawowy M_ChessBoard.

Set the base color

  1. Powtórz poprzedni krok 4 razy więcej, aby utworzyć cztery więcej węzłów Przykład tekstury z następującymi ustawieniami:
    • Ustaw pozycję Teksturana ChessBoard_AO i połącz rgb z pinem Ambient Occlusion .
    • Ustaw pozycję Tekstura, aby ChessBoard_Metal i połączyć rgb z metalowym przypięciem.
    • Ustaw pozycję Teksturana wartość ChessBoard_Normal i połącz rgb znumerem PIN Normal .
    • Ustaw pozycję Teksturana ChessBoard_Rough i połącz rgb z przypięciem Szorstkość .
    • Kliknij pozycję Zapisz.

Hook up the remaining textures

Przed kontynuowaniem upewnij się, że konfiguracja materiału wygląda podobnie do powyższego zrzutu ekranu.

Wypełnianie sceny

Jeśli wrócisz do strategii Zarządu , zobaczysz, że właśnie utworzony materiał został zastosowany. Wszystko, co pozostało, to skonfigurowanie sceny! Najpierw zmień następujące właściwości, aby upewnić się, że tablica jest rozsądnym rozmiarem i poprawnie po umieszczeniu jej w scenie:

  1. Ustaw wartość Scalena (0.05, 0.05, 0.05) i Z Rotation na 90.
    • Kliknij pozycję Skompiluj na górnym pasku narzędzi, a następnie zapisz i wróć do okna Głównego.

Chessboard with material applied

  1. Kliknij prawym przyciskiem myszy > pozycję Edytuj > usuń moduł i przeciągnij tablicę z przeglądarki zawartości do widoku.

    • Ustaw wartość LokalizacjaX = 80, Y = 0 i Z = -20.
  2. Wybierz przycisk Odtwórz , aby wyświetlić nową tablicę na poziomie. Naciśnij klawisz Esc , aby powrócić do edytora.

Teraz wykonasz te same kroki, aby utworzyć kawałek szachowy, jak w przypadku tablicy:

  1. Przejdź do folderu Blueprints , kliknij prawym przyciskiem myszy i wybierz pozycję Klasa strategii , a następnie wybierz pozycję Aktor. Nadaj aktorowi nazwę WhiteKing.

  2. Kliknij dwukrotnie pozycję WhiteKing, aby otworzyć go w Edytorze strategii, wybierz pozycję Dodaj scenę składnika > i nadaj mu nazwę Root.

    • Przeciągnij i upuść element Root na wartość DefaultSceneRoot , aby go zastąpić.
  3. Kliknij pozycję Dodaj Mesh statyczny składnik > i nadaj mu nazwę SM_King.

    • Ustaw Mesh statyczne na Chess_King i Materiał na nowy materiał o nazwie M_ChessWhite w panelu Szczegóły.
  4. Otwórz M_ChessWhite w edytorze materiałów i podłącz następujące węzły przykładu tekstury do następujących elementów:

    • Ustaw pozycję Teksturana ChessWhite_Albedo i połącz rgb z numerem PIN koloru podstawowego .
    • Ustaw pozycję Teksturana wartość ChessWhite_AO i połącz rgb z przypięciem Ambient Occlusion .
    • Ustaw pozycję Teksturana ChessWhite_Metal i połącz rgb zmetalowym przypięciem.
    • Ustaw pozycję Teksturana ChessWhite_Normal i połącz rgb zpinezką Normal .
    • Ustaw pozycję Tekstura, aby ChessWhite_Rough i połączyć rgb z pinezką szorstkości.
    • Kliknij pozycję Zapisz.

Przed kontynuowaniem materiał M_ChessKing powinien wyglądać jak na poniższej ilustracji.

Create the material for the chess king

Prawie tam jesteś, po prostu musisz dodać nowy kawałek szachowy do sceny:

  1. Otwórz strategię WhiteKing i zmień skalę na (0.05, 0.05, 0.05) i Obrót Z na 90.

    • Skompiluj i zapisz strategię, a następnie wróć do okna głównego.
  2. Przeciągnij pozycję WhiteKing do widoku, przejdź do panelu World Outliner przeciągnij pozycję WhiteKing na tablicę, aby utworzyć obiekt podrzędny.

World Outliner

  1. W panelu Szczegóły w obszarze Przekształć ustaw wartość LokalizacjaWhiteKing na X = -26, Y = 4 i Z = 0.

To zawijanie! Wybierz pozycję Odtwórz , aby wyświetlić wypełniony poziom w akcji, a następnie naciśnij klawisz Esc , gdy wszystko będzie gotowe do zakończenia. Omówiono wiele podstaw po prostu tworzenie prostego projektu, ale teraz możesz przejść do następnej części serii: konfigurowanie rzeczywistości mieszanej.

Następna sekcja: 3. Konfigurowanie projektu dla rzeczywistości mieszanej