Ćwiczenie — importowanie i konfigurowanie zasobów

Ukończone

Instalowanie narzędzia funkcji rzeczywistości mieszanej

Aby zaimportować zestaw narzędzi Mixed Reality Toolkit do projektu, użyjemy narzędzia Mixed Reality Feature Tool, które 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.

    Screenshot of the Mixed Reality Feature Tool opening screen.

  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.

    Screenshot of the Select Project screen.

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

    Screenshot of 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ź.

  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.

    Screenshot of Unity Restart Option.

  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.

    Screenshot of updating methods in the XR InteractionLayerMask.

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

  4. Na pasku menu wybierz pozycję Edytuj>projekt Ustawienia.... 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.

    Screenshot of Initialize XR on Startup.

  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.

    Screenshot of Open XR option.

  6. Wybierz pozycję Napraw wszystko.

    Screenshot of Fix All.

    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.

    Screenshot of Add Interaction Profiles.

  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 Projekt Ustawienia 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.

    Screenshot of MRTK profile.

Konfigurowanie ustawień projektu

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

  2. W lewej kolumnie okna project Ustawienia 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 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 Sceny zasobów>, a następnie nadaj projektowi nazwę, a następnie zapisz projekt.