Ćwiczenie — importowanie i konfigurowanie zasobów

  • 10 min

Instalowanie narzędzia funkcji rzeczywistości mieszanej

Aby zaimportować zestaw narzędzi Mixed Reality Toolkit do projektu, użyjesz narzędzia funkcji rzeczywistości mieszanej. Narzędzie umożliwia deweloperom odnajdywanie, aktualizowanie i importowanie pakietów funkcji. Pakiety można przeszukiwać według nazwy lub kategorii, wyświetlać ich zależności i wyświetlać proponowane zmiany w pliku manifestu projektu przed zaimportowaniem.

  1. Pobierz najnowszą wersję narzędzia funkcji rzeczywistości mieszanej z Centrum pobierania Microsoft.

  2. Po zakończeniu pobierania otwórz plik wykonywalny MixedRealityFeatureTool.exe i użyj go do uruchomienia narzędzia funkcji rzeczywistości mieszanej.

    Notatka

    Przed uruchomieniem narzędzia funkcji rzeczywistości mieszanej może być konieczne zainstalowanie środowiska uruchomieniowego platformy .NET 6.0.

Importowanie pakietu podstawowego zestawu narzędzi MRTK Unity

  1. W Narzędziu Funkcji Rzeczywistości Mieszanej wybierz Uruchom.

    zrzut ekranu przedstawiający ekran otwierania narzędzia funkcji rzeczywistości mieszanej.

  2. Wybierz przycisk Przeglądaj (jest to przycisk ... na poniższej ilustracji), przejdź do swojego projektu i otwórz go.

    Otwórz swój projekt

    Po wybraniu folderu narzędzie sprawdza, czy jest to prawidłowy folder projektu Unity.

    zrzut ekranu przedstawiający ekran Ścieżka projektu funkcji narzędzia rzeczywistości mieszanej.

  3. Wybierz pozycję Odkryj funkcje.

    Uwaga: może być konieczne odczekanie kilku sekund, gdy narzędzie odświeża pakiety z kanałów informacyjnych.

  4. Na stronie Odkryj Funkcje zauważ, że znajduje się lista dostępnych grup pakietów.

    Główne grupy pakietów w narzędziu funkcji rzeczywistości mieszanej

  5. Wybierz przycisk + po lewej stronie Platform Support (0 z 5), a następnie wybierz najnowszą wersję wtyczki Mixed Reality OpenXR.

    Zrzut ekranu przedstawiający wybór pakietów w narzędziu funkcji rzeczywistości mieszanej.

  6. Wybierz przycisk Wybierz wszystkie po prawej stronie MRTK3, aby zaznaczyć wszystkie funkcje.

    Zrzut ekranu przedstawiający wybieranie wszystkich funkcji zestawu MRTK3.

    Notatka

    Jeśli widzisz jakiekolwiek pakiety oznaczone jako przestarzałe, usuń je i upewnij się, że Ustawienia > Funkcja > Pokaż przestarzałe pakiety jest odznaczone.

  7. Po dokonaniu wyboru wybierz Uzyskaj funkcje.

  8. Wybierz pozycję Zweryfikuj, aby zweryfikować wybrane pakiety. Powinno zostać wyświetlone okno dialogowe z informacją Nie wykryto problemów z walidacją. Gdy to zrobisz, wybierz pozycję OK.

  9. Na stronie Funkcje importu lewa kolumna Funkcjewyświetla pakiety, które wybrałeś. Kolumna po prawej stronie, Wymagane zależności, wyświetla wszelkie zależności. Możesz wybrać link Szczegóły dla dowolnego z tych elementów, aby dowiedzieć się więcej o nich.

  10. Gdy będziesz gotowy, by przejść dalej, wybierz pozycję Importuj. Na stronie Przegląd i Zatwierdzanie możesz przejrzeć informacje o pakietach.

  11. Wybierz Zatwierdź, następnie wybierz Zakończ.

  12. Wróć do Edytora Unity i wybierz pusty obszar w interfejsie użytkownika. Zobaczysz pasek postępu pokazujący, że Twoje pakiety są importowane.

Skonfiguruj projekt Unity

  1. Po zaimportowaniu pakietów przez środowisko Unity zostanie wyświetlone ostrzeżenie z pytaniem, czy chcesz włączyć zaplecza przez ponowne uruchomienie edytora. Wybierz pozycję Tak.

    zrzut ekranu opcji ponownego uruchamiania Unity.

  2. Unity może zapytać o aktualizację metod w XR InteractionLayerMask. Wybierz przycisk Zrobiłem kopię zapasową, kontynuuj i poczekaj, aż Unity zostanie ponownie uruchomione.

    Zrzut ekranu przedstawiający aktualizowanie metod w elemencie XR InteractionLayerMask.

  3. Na pasku menu wybierz pozycję Edytuj ustawienia projektu>. Wybierz Zarządzanie wtyczkami XR Upewnij się, że Inicjuj XR przy starcie jest zaznaczone, a następnie zaznacz pole wyboru dla Otwórz XR w sekcji Dostawcy wtyczek.

    zrzut ekranu przedstawiający inicjowanie środowiska XR podczas uruchamiania.

  4. Wtyczka OpenXR ładuje się, a dwa elementy są wyświetlane w obszarze OpenXR. Zaznacz pole wyboru dla pierwszej grupy funkcji Microsoft HoloLens. Wybierz żółty wykrzyknik .

    Zrzut ekranu przedstawiający opcję Otwórz XR.

  5. Wybierz opcję Napraw wszystko.

    zrzut ekranu Napraw Wszystko.

    Niektóre ostrzeżenia mogą pozostać. Ignoruj je na razie.

  6. Wybierz OpenXR pod Zarządzanie wtyczkami XR.

  7. W obszarze profile interakcji wybierz pozycję +, a następnie dodaj profil interakcji między rękami firmy Microsoft i profil interakcji oczy, jeśli nie zostały jeszcze dodane.

    zrzut ekranu przedstawiający dodawanie profilów interakcji.

  8. Upewnij się, że microsoft Hololens po lewej stronie jest zaznaczona, a funkcji rzeczywistości mieszanej i model kontrolera ruchu po prawej stronie.

  9. Wybierz żółty wykrzyknik obok pozycji Profil interakcji wzroku oka, aby przywrócić okno Walidacja projektu. Upewnij się, że jesteś na karcie platformy UWP (na karcie jest wyświetlane logo systemu Windows), a następnie wybierz pozycję Napraw wszystkie, aby rozwiązać problemy z walidacją. Pamiętaj, że niektóre problemy mogą pozostać. W takim przypadku ponownie wybierz pozycję Napraw wszystkie, zignoruj wszelkie problemy oznaczone jako specyficzne dla sceny, a następnie przeczytaj zalecenia dotyczące pozostałych problemów (jeśli istnieją) i wprowadź dowolne zmiany.

  10. W oknie Ustawienia projektu wybierz MRTK3 i sprawdź, czy istnieje prawidłowy Profil. Jeśli tak nie jest, wyszukaj MRTKProfile w folderze Packages (Packages/org.mixedrealitytoolkit.core/Configuration/Default Profiles/MRTKProfile.asset) i przypisz go do profilu.

    zrzut ekranu profilu MRTK.

Konfigurowanie ustawień projektu

  1. Na pasku menu wybierz pozycję Edytuj ustawienia projektu>.

  2. W oknie Ustawienia projektu wybierz Player.

  3. Pamiętaj, że w oknie Player nazwa produktu jest samouczka zestawu narzędzi MRTK. Jest to pobierane z nazwy projektu i będzie nazwą wyświetlaną w menu Start urządzenia HoloLens.

    Zrzut ekranu przedstawiający ustawienia publikowania Unity z wypełnionym polem

    Napiwek

    Aby ułatwić znajdowanie aplikacji podczas programowania, dodaj podkreślenie przed nazwą, aby posortować ją na początku dowolnej listy.

  4. Wybierz z listy rozwijanej Ustawienia publikowania, a następnie w polu nazwa pakietu wprowadź odpowiednią nazwę; na przykład MRTK-Tutorials-Getting-Started:

    Zrzut ekranu przedstawiający ustawienia publikowania Unity z wypełnionym polem nazwy pakietu.

    Notatka

    Nazwa pakietu jest unikatowym identyfikatorem aplikacji. Jeśli chcesz uniknąć zastępowania wcześniej zainstalowanych wersji aplikacji o tej samej nazwie, należy zmienić ten identyfikator przed wdrożeniem aplikacji.

  5. Zamknij okno ustawienia projektu.

Tworzenie sceny i konfigurowanie zestawu narzędzi MRTK

  1. Na pasku menu wybierz pozycję Plik>Nowa scena. Wybierz opcję Podstawowa (wbudowana), a następnie wybierz opcję Utwórz.

  2. W oknie Project przejdź do folderu Packages>MRTK Input>Assets>Prefabs. Przeciągnij prefab MRTK XR Rig do Hierarchii sceny.

    Zrzut ekranu przedstawiający dodawanie zestawu narzędzi MRTK XR Rig w inspektorze.

  3. Usuń obiekt gry Main Camera, ponieważ obiekt gry MRTK XR Rig zawiera już kamerę.

    zrzut ekranu przedstawiający zestaw narzędzi Mixed Reality Toolkit w inspektorze.

  4. Dodaj prefabrykat Symulator danych wejściowych MRTK (Pakiety>MRTK Input>Simulation>Prefabs) do swojej sceny.

    Notatka

    Ten krok jest opcjonalny, ale wymagany przez symulacje w edytorze.

    Zrzut ekranu przedstawiający symulator wejściowy.

  5. Na pasku menu wybierz pozycję Plik>Zapisz jako.

  6. Przejdź do folderu Assets>Scenes, a następnie nadaj projektowi nazwę i zapisz go.