Ć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 MixedRealityFeatureTool.exe wykonywalny 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.

    Screenshot of the Mixed Reality Feature Tool opening screen.

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

    Open your project

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

    Screenshot of the Mixed Reality feature Tool Project Path screen.

  3. Wybierz pozycję Odnajdź funkcje.

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

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

    The main groups of packages in the Mixed Reality Feature Tool

  5. + Wybierz przycisk po lewej stronie pozycji Obsługa platformy (0 z 5), a następnie wybierz najnowszą wersję wtyczki Mixed Reality OpenXR.

    Screenshot of package selections in the Mixed Reality Feature Tool.

  6. Wybierz przycisk Wybierz wszystko po prawej stronie zestawu NARZĘDZI MRTK3, aby wybrać wszystkie funkcje.

    Screenshot of selecting all feature of MRTK3.

    Uwaga

    Jeśli widzisz wszystkie pakiety oznaczone jako przestarzałe, należy je usunąć i upewnić się, że Ustawienia > opcja 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 pozycję Zatwierdź, a następnie wybierz pozycję Zakończ.

  12. 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.

    Screenshot of Unity Restart Option.

  2. Aparat Unity może zapytać o aktualizowanie metod w elemecie InteractionLayerMask XR. Wybierz przycisk Utwórz kopię zapasową, Przejdź dalej! i poczekaj na ponowne uruchomienie aparatu Unity.

    Screenshot of updating methods in the XR InteractionLayerMask.

  3. Na pasku menu wybierz pozycję Edytuj>projekt Ustawienia. Wybierz pozycję Zarządzanie wtyczką XR. Upewnij się, że wybrano opcję Inicjowanie XR przy uruchamianiu , a następnie zaznacz pole wyboru Otwórz XR w obszarze Dostawcy wtyczek.

    Screenshot of Initialize XR on Startup.

  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.

    Screenshot of Open XR option.

  5. Wybierz pozycję Napraw wszystko.

    Screenshot of Fix All.

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

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

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

    Screenshot of Add Interaction Profiles.

  8. Upewnij się, że po lewej stronie wybrano pozycję Microsoft Hololens, a po prawej stronie wybrano pozycję Funkcje rzeczywistości mieszanej i model kontrolera ruchu.

  9. Wybierz żółty wykrzyknik 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 niektóre problemy mogą pozostać. 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.

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

    Screenshot of MRTK profile.

Konfigurowanie ustawień projektu

  1. Na pasku menu wybierz pozycję Edytuj>projekt Ustawienia.

  2. W oknie Project Settings (Ustawienia projektu) wybierz pozycję Player (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.

    Screenshot of Unity Publishing Settings with the Project Name box filled in.

    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ą Publikowanie Ustawienia, a następnie w polu Nazwa pakietu wprowadź odpowiednią nazwę, na przykład MRTK-Tutorials-Getting-Started:

    Screenshot of Unity Publishing Settings with the package name box filled in.

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

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

    Screenshot of the adding MRTK XR Rig in the Inspector.

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

    Screenshot of the Mixed Reality Toolkit in the Inspector.

  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 przez symulacje w edytorze.

    Screenshot of the input simulator.

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

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