Ć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 funkcji rzeczywistości mieszanej 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 MixedRealityFeatureTool.exe i użyj go do uruchomienia narzędzia funkcji rzeczywistości mieszanej.

    Uwaga

    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 pozycję Uruchom.

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

  2. Wybierz przycisk Przeglądaj (jest to przycisk "trzy kropki" na poniższej ilustracji), a następnie przejdź do projektu, a następnie otwórz go.

    Zrzut ekranu przedstawiający ekran Wybieranie projektu.

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

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

  3. Wybierz pozycję Odnajdź funkcje.

    Uwaga

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

  4. Na stronie Odnajdywanie funkcji zwróć uwagę, że istnieje lista dostępnych grup pakietów.

    Zrzut ekranu przedstawiający główne grupy pakietów w narzędziu funkcji rzeczywistości mieszanej.

  5. + Wybierz przycisk po lewej stronie pozycji Obsługa platformy (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 wszystko po prawej stronie zestawu NARZĘDZI MRTK3, aby wybrać wszystkie funkcje.

    Zrzut ekranu przedstawiający wybieranie wszystkich funkcji zestawu MRTK3.

    Uwaga

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

  7. Po wybraniu zaznaczenia wybierz pozycję Pobierz funkcje.

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

  9. Na stronie Importowanie funkcji po lewej stronie kolumna Funkcje wyświetla wybrane pakiety. Kolumna po prawej stronie, Wymagane zależności, wyświetla wszystkie zależności. Możesz wybrać link Szczegóły dla dowolnego z tych elementów, aby dowiedzieć się więcej o nich.

  10. Gdy wszystko będzie gotowe do przejścia, wybierz pozycję Importuj.Na stronie Przeglądanie i zatwierdzanie możesz przejrzeć informacje o pakietach.

  11. Wybierz Zatwierdź.

  12. Wybierz pozycję Zakończ.

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

Konfigurowanie projektu aparatu 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 opcję Tak.

    Zrzut ekranu przedstawiający opcję ponownego uruchomienia aparatu Unity.

  2. Aparat Unity zapyta Cię o aktualizowanie metod w elemecie InteractionLayerMask XR, wybierz przycisk I Made a Backup (Utwórz kopię zapasową), Przejdź dalej! i poczekaj na ponowne uruchomienie aparatu Unity.

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

  3. Na pasku menu wybierz pozycję Projekt>Zastosuj zalecane ustawienia projektu dla urządzenia HoloLens.

  4. Na pasku menu wybierz pozycję Edytuj>ustawienia projektu.... Wybierz pozycję Zarządzanie wtyczką XR. Upewnij się, że wybrano opcję Itialize XR on Startup (Uruchamianie), a następnie w obszarze Dostawcy wtyczek wybierz pozycję Otwórz XR.

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

  5. Wtyczka OpenXR ładuje się, a następnie dwa elementy są wyświetlane poniżej biblioteki OpenXR. Wybierz pierwszą grupę funkcji Microsoft HoloLens. Wybierz żółty wykrzyknik.

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

  6. Wybierz pozycję Napraw wszystko.

    Zrzut ekranu przedstawiający poprawkę wszystkich.

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

  7. Wybierz pozycję OpenXR w obszarze Zarządzanie wtyczką XR.

  8. W obszarze Profile interakcji dodaj profil interakcji między rękami firmy Microsoft i profil interakcji wzroku, jeśli nie został dodany.

    Zrzut ekranu przedstawiający dodawanie profilów interakcji.

  9. Upewnij się, że po lewej stronie wybrano pozycję Microsoft Hololens , a po prawej stronie wybrano pozycję Śledzenie rąk, Funkcje rzeczywistości mieszanej i Model kontrolera ruchu po prawej stronie.

  10. Wybierz znak ostrzegawczy obok pozycji Profil interakcji wzroku, 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 wszystko , aby rozwiązać problemy z walidacją. Pamiętaj, że po wybraniu pozycji Napraw wszystko mogą występować problemy, które pozostają. W takim przypadku ponownie wybierz pozycję Napraw wszystko, zignoruj wszelkie problemy oznaczone jako specyficzne dla sceny, a następnie przeczytaj zalecenia dotyczące pozostałych problemów (jeśli istnieją) i wprowadź odpowiednie zmiany.

  11. W obszarze Ustawienia projektu wybierz pozycję MRTK3, a następnie sprawdź, czy istnieje prawidłowy profil. Jeśli nie istnieje, wyszukaj plik MRTKProfile w folderze Packages (Packages/org.mixedrealitytoolkit.core/Configuration/Default Profiles/MRTKProfile.asset) i przypisz go do profilu.

    Zrzut ekranu przedstawiający profil zestawu narzędzi MRTK.

Konfigurowanie ustawień projektu

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

  2. W lewej kolumnie okna Ustawienia projektu wybierz pozycję Odtwarzacz.

  3. Należy pamiętać, że w oknie Player nazwa produktu to "MRTK Tutorial". Jest to pobierane z nazwy projektu i będzie nazwą wyświetlaną w menu Start HoloLens.

    Zrzut ekranu przedstawiający ustawienia publikowania aparatu Unity z wypełnionym polem Nazwa projektu.

    Napiwek

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

  4. Wybierz listę rozwijaną 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 aparatu Unity z wypełnionym polem nazwy pakietu.

    Uwaga

    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 pozycję Utwórz.

  2. W oknie Project (Projekt) przejdź do folderu Packages MRTK Input Assets>> zasobów wejściowych>zestawu narzędzi MRTK). Przeciągnij prefab zestawu narzędzi MRTK XR Rig do hierarchii sceny.

    Zrzut ekranu przedstawiający dodawanie platformy MRTK XR w inspektorze.

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

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

  4. Dodaj prefab do sceny prefab symulatora danych wejściowych zestawu narzędzi MRTK (pakiety>prefab symulacji>wejściowej>zestawu narzędzi MRTK).

    Uwaga

    Ten krok jest opcjonalny, ale wymagany w przypadku symulacji w edytorze.

    Zrzut ekranu przedstawiający symulator wejściowy.

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

  6. Przejdź do folderu Sceny zasobów>, a następnie nadaj projektowi nazwę, a następnie zapisz projekt.