Pakiety MRTK — MRTK2
Zestaw narzędzi Mixed Reality Toolkit (MRTK) to kolekcja pakietów, które umożliwiają tworzenie aplikacji rzeczywistości mieszanej dla wielu platform, zapewniając obsługę sprzętu i platform rzeczywistości mieszanej.
Zestaw NARZĘDZI MRTK jest dostępny jako pakiety zawartości (unitypackage) i za pośrednictwem Menedżer pakietów aparatu Unity.
Pakiety zasobów
Zasób zestawu narzędzi MRTK (.unitypackage) można pobrać z usługi GitHub.
Oto niektóre korzyści wynikające z używania pakietów zasobów:
- Dostępne dla aparatu Unity 2018.4 i nowszych
- Łatwe wprowadzanie zmian w zestawach narzędzi MRTK
- Zestaw narzędzi MRTK znajduje się w folderze Assets
Niektóre wyzwania:
- Zestaw narzędzi MRTK jest częścią folderu Assets projektu, co prowadzi do
- Większe projekty
- Wolniejsze czasy kompilacji
- Brak zarządzania zależnościami
- Klienci są zobowiązani do ręcznego rozwiązywania zależności pakietów
- Proces ręcznej aktualizacji
- Wiele kroków
- Aktualizacje kontroli źródła dużych (3000+ plików)
- Ryzyko utraty zmian wprowadzonych w mrTK
- Importowanie pakietu przykładów zwykle oznacza uwzględnienie wszystkich przykładów
Dostępne pakiety to:
Te pakiety są wydawane i obsługiwane przez firmę Microsoft z kodu źródłowego w witrynie GitHub.
Pakiet foundation
Mixed Reality Toolkit Foundation to zestaw kodu, który umożliwia aplikacji korzystanie z typowych funkcji na platformach rzeczywistości mieszanej.
Pakiet MRTK Foundation
Pakiet MRTK Foundation zawiera następujące elementy.
| Folder | Składnik | opis |
|---|---|---|
| ZESTAW NARZĘDZI MRTK/Core | Definicje interfejsów i typów, klasy bazowe, cieniowanie standardowe. | |
| MrTK/Core/Providers | Niezależni dostawcy danych platformy | |
| Ręce | Obsługa klasy bazowej i usługi do śledzenia rąk. | |
| InputAnimation | Obsługa rejestrowania danych śledzenia głowy i śledzenia rąk. | |
| InputSimulation | Obsługa symulacji w edytorze danych wejściowych rąk i oczu. | |
| ObjectMeshObserver | Obserwator świadomości przestrzennej używający modelu 3D jako danych. | |
| UnityInput | Typowe urządzenia wejściowe (mysz, mysz itp.) implementowane za pośrednictwem interfejsu API wejściowego aparatu Unity. | |
| MRTK/Dostawcy | Dostawcy danych specyficznych dla platformy | |
| LeapMotion | Obsługa kontrolera UltraLeap Leap Motion. | |
| OpenVR | Obsługa urządzeń OpenVR. | |
| Oculus | Obsługa urządzeń Oculus, takich jak Quest. | |
| UnityAR | (Eksperymentalne) Dostawca ustawień aparatu, który umożliwia korzystanie z zestawu narzędzi MRTK z urządzeniami przenośnymi AR. | |
| WindowsMixedReality | Obsługa urządzeń z systemem Windows Mixed Reality, w tym urządzeń Microsoft HoloLens i immersywnych zestawów słuchawkowych. | |
| Windows | Obsługa interfejsów API specyficznych dla systemu Microsoft Windows, na przykład mowy i dyktowania. | |
| XR SDK | (Eksperymentalne) Obsługa nowej platformy XR aparatu Unity w wersji Unity 2019.3 i nowszych. | |
| Zestaw MRTK/ZESTAW SDK | ||
| Eksperymentalne | Funkcje eksperymentalne, w tym cieniowania, kontrolki interfejsu użytkownika i poszczególne menedżery systemu. | |
| Funkcje | Funkcjonalność, która opiera się na pakiecie Foundation. | |
| Profile | Domyślne profile dla systemów i usług microsoft Mixed Reality Toolkit. | |
| Elementy zawartości standardowej | Wspólne zasoby; modele, tekstury, materiały itp. | |
| MRTK/SceneSystemResources | Zasoby i zasoby używane przez system scen | |
| MRTK/Services | ||
| BoundarySystem | System implementuje obsługę granic VR. | |
| CameraSystem | System implementuje konfigurację i zarządzanie kamerą. | |
| DiagnosticsSystem | System implementowania w diagnostyce aplikacji, na przykład profiler wizualizacji. | |
| InputSystem | System zapewnia obsługę uzyskiwania dostępu do danych wejściowych użytkownika i obsługi ich obsługi. | |
| SceneSystem | System zapewniający obsługę aplikacji z wieloma scenami. | |
| SpatialAwarenessSystem | System zapewnia obsługę świadomości środowiska użytkownika. | |
| TeleportSystem | System zapewniający obsługę teleportowania (poruszanie się o środowisku skoków). | |
| Elementy MRTK/StandardowaAssets | Cieniowania standardowe mrTK, podstawowe materiały i inne standardowe zasoby dla środowisk rzeczywistości mieszanej |
Pakiet rozszerzeń
Opcjonalny pakiet Microsoft.MixedRealityToolkit.Unity.Extensions zawiera dodatkowe usługi rozszerzające funkcjonalność zestawu narzędzi Microsoft Mixed Reality Toolkit.
Uwaga
Pakiet rozszerzeń wymaga zestawu Microsoft.MixedRealityToolkit.Unity.Foundation.
| Folder | Składnik | opis |
|---|---|---|
| Zestaw narzędzi MRTK/rozszerzenia | ||
| HandPhysicsService | Usługa, która dodaje obsługę fizyki do przegubowych rąk. | |
| LostTrackingService | Usługa, która upraszcza obsługę śledzenia utraty na urządzeniach Microsoft HoloLens. | |
| SceneTransitionService | Usługa, która upraszcza dodawanie płynnych przejść scen. |
Pakiet narzędzi
Opcjonalny pakiet Microsoft.MixedRealityToolkit.Unity.Tools zawiera przydatne narzędzia zwiększające środowisko programowania rzeczywistości mieszanej przy użyciu zestawu narzędzi Microsoft Mixed Reality Toolkit. Te narzędzia znajdują się w menu narzędzi Mixed Reality Toolkit > w Edytorze aparatu Unity.
Uwaga
Pakiet narzędzi wymaga zestawu Microsoft.MixedRealityToolkit.Unity.Foundation.
| Folder | Składnik | opis |
|---|---|---|
| NARZĘDZIA MRTK/Narzędzia | ||
| Kompilowanie systemu Windows | Narzędzie ułatwiające proces kompilowania i wdrażania aplikacji platformy UNIWERSALNEJ systemu Windows. | |
| ZależnośćWindow | Narzędzie, które tworzy graf zależności zasobów w projekcie. | |
| ExtensionServiceCreator | Kreator ułatwia tworzenie usług rozszerzeń. | |
| Migracja w systemie Windows | Narzędzie, które pomaga w aktualizowaniu kodu, który używa przestarzałych składników zestawu narzędzi MRTK. | |
| Optymalizowanie systemu Windows | Narzędzie ułatwiające automatyzowanie konfigurowania projektu rzeczywistości mieszanej w celu uzyskania najlepszej wydajności w środowisku Unity. | |
| ReserializeAssetsUtility | Zapewnia obsługę reserializowania określonych plików aparatu Unity. | |
| RuntimeTools/Tools/ControllerMappingTool | Narzędzie umożliwiające deweloperom szybkie określanie mapowań aparatu Unity dla kontrolerów sprzętu. | |
| Zrzut ekranuUtility | Umożliwia przechwytywanie obrazów aplikacji w edytorze aparatu Unity. | |
| TextureCombinerWindow | Narzędzie do łączenia tekstur graficznych. | |
| Przybornik | Interfejs użytkownika, który ułatwia odnajdywanie i używanie składników środowiska użytkownika zestawu narzędzi MRTK. |
Pakiet narzędzi testowych
Opcjonalny pakiet Microsoft.MixedRealityToolkit.TestUtilities to kolekcja skryptów pomocnika, które umożliwiają deweloperom łatwe tworzenie testów trybu odtwarzania. Te narzędzia są szczególnie przydatne dla deweloperów tworzących składniki zestawu narzędzi MRTK.
| Folder | Składnik | opis |
|---|---|---|
| MRTK/Testy | ||
| Narzędzia testowe | Metody upraszczania tworzenia testów trybu odtwarzania, w tym narzędzi symulacji ręcznej. |
Pakiet przykłady
Pakiet przykłady zawiera pokazy, przykładowe skrypty i przykładowe sceny, które wykonują funkcje w pakiecie podstawowym. Ten pakiet zawiera scenę HandInteractionExample (na zdjęciu poniżej), która zawiera przykładowe obiekty, które reagują na różne typy danych wejściowych ręcznych (przegubowych i niezgartowanych).
Ten pakiet zawiera również pokazy śledzenia oczu, które zostały udokumentowane tutaj
Ogólnie rzecz biorąc, każda nowa funkcja w zestawie narzędzi MRTK powinna zawierać odpowiedni przykład w pakiecie examples, w przybliżeniu po tej samej strukturze folderów i lokalizacji.
Uwaga
Pakiet przykładów wymaga zestawu Microsoft.MixedRealityToolkit.Unity.Foundation.
| Folder | Składnik | opis |
|---|---|---|
| Zestaw narzędzi MRTK/Przykłady | ||
| Wersje demonstracyjne | Proste sceny ilustrujące jedną lub dwie powiązane funkcje. | |
| Eksperymentalne | Pokazowe sceny ilustrujące funkcje eksperymentalne. | |
| Elementy zawartości standardowej | Wspólne zasoby współużytkowane przez wiele scen demonstracyjnych. |
Menedżer pakietów aparatu Unity
W przypadku środowisk tworzonych przy użyciu aparatu Unity 2019.4 i nowszych zestaw NARZĘDZI MRTK jest dostępny za pośrednictwem Menedżer pakietów aparatu Unity.
Oto niektóre korzyści wynikające z używania pakietów zasobów:
- Mniejsze projekty
- Czystsze rozwiązania programu Visual Studio
- Mniej plików do zaewidencjonowania (MRTK jest prostym odwołaniem
Packages/manifest.jsonw pliku)
- Szybsza kompilacja
- Aparat Unity nie musi ponownie kompilować zestawu narzędzi MRTK podczas kompilowania
- Rozwiązywanie zależności
- Wymagane pakiety zestawu narzędzi MRTK są instalowane automatycznie podczas określania pakietów z zależnościami
- Łatwa aktualizacja nowych wersji zestawu narzędzi MRTK
- Zmienianie wersji w
Packages/manifest.jsonpliku
- Zmienianie wersji w
Niektóre wyzwania:
- Zestaw narzędzi MRTK jest niezmienny
- Nie można wprowadzać zmian bez ich usuwania podczas rozwiązywania problemów z pakietem
- Zestaw narzędzi MRTK nie obsługuje pakietów UPM z aparatem Unity 2018.4
Pakiet foundation
Pakiet podstawowy (com.microsoft.mixedreality.toolkit.foundation) stanowi podstawę zestawu narzędzi Mixed Reality Toolkit.
| Folder | Składnik | opis |
|---|---|---|
| ZESTAW NARZĘDZI MRTK/Core | Definicje interfejsów i typów, klasy bazowe, cieniowanie standardowe. | |
| MrTK/Core/Providers | Niezależni dostawcy danych platformy | |
| Ręce | Obsługa klasy bazowej i usługi do śledzenia rąk. | |
| InputAnimation | Obsługa rejestrowania danych śledzenia głowy i śledzenia rąk. | |
| InputSimulation | Obsługa symulacji w edytorze danych wejściowych rąk i oczu. | |
| ObjectMeshObserver | Obserwator świadomości przestrzennej używający modelu 3D jako danych. | |
| UnityInput | Typowe urządzenia wejściowe (mysz, mysz itp.) implementowane za pośrednictwem interfejsu API wejściowego aparatu Unity. | |
| MRTK/Dostawcy | Dostawcy danych specyficznych dla platformy | |
| LeapMotion | Obsługa kontrolera UltraLeap Leap Motion. | |
| OpenVR | Obsługa urządzeń OpenVR. | |
| Oculus | Obsługa urządzeń Oculus, takich jak Quest. | |
| UnityAR | (Eksperymentalne) Dostawca ustawień aparatu, który umożliwia korzystanie z zestawu narzędzi MRTK z urządzeniami przenośnymi AR. | |
| WindowsMixedReality | Obsługa urządzeń z systemem Windows Mixed Reality, w tym urządzeń Microsoft HoloLens i immersywnych zestawów słuchawkowych. | |
| Windows | Obsługa interfejsów API specyficznych dla systemu Microsoft Windows, na przykład mowy i dyktowania. | |
| XR SDK | (Eksperymentalne) Obsługa nowej platformy XR aparatu Unity w wersji Unity 2019.3 i nowszych. | |
| Zestaw MRTK/ZESTAW SDK | ||
| Eksperymentalne | Funkcje eksperymentalne, w tym cieniowania, kontrolki interfejsu użytkownika i poszczególne menedżery systemu. | |
| Funkcje | Funkcjonalność, która opiera się na pakiecie Foundation. | |
| Profile | Domyślne profile dla systemów i usług microsoft Mixed Reality Toolkit. | |
| Elementy zawartości standardowej | Wspólne zasoby; modele, tekstury, materiały itp. | |
| MRTK/Services | ||
| BoundarySystem | System implementuje obsługę granic VR. | |
| CameraSystem | System implementuje konfigurację i zarządzanie kamerą. | |
| DiagnosticsSystem | System implementowania w diagnostyce aplikacji, na przykład profiler wizualizacji. | |
| InputSystem | System zapewnia obsługę uzyskiwania dostępu do danych wejściowych użytkownika i obsługi ich obsługi. | |
| SceneSystem | System zapewniający obsługę aplikacji z wieloma scenami. | |
| SpatialAwarenessSystem | System zapewnia obsługę świadomości środowiska użytkownika. | |
| TeleportSystem | System zapewniający obsługę teleportowania (poruszanie się o środowisku skoków). |
Zależności:
- Elementy zawartości standardowej (
com.microsoft.mixedreality.toolkit.standardassets)
Elementy zawartości standardowej
Standardowy pakiet zasobów (com.microsoft.mixedreality.toolkit.standardassets) to kolekcja składników, które są zalecane dla wszystkich środowisk rzeczywistości mieszanej, w tym:
- Cieniowania standardowego zestawu narzędzi MRTK
- Podstawowe materiały korzystające z cieniowania standardowego zestawu narzędzi MRTK
- Pliki audio
- Czcionki
- Tekstury
- Ikony
Uwaga
Aby uniknąć zmian powodujących niezgodność w oparciu o definicje zestawów, skrypty używane do kontrolowania niektórych funkcji cieniowania standardowego zestawu MRTK nie są uwzględniane w standardowym pakiecie zasobów. Te skrypty można znaleźć w pakiecie podstawowym w folderze MRTK/Core/Utilities/StandardShader .
Zależności: brak
Pakiety rozszerzeń
Opcjonalny pakiet rozszerzeń (com.microsoft.mixedreality.toolkit.extensions) zawiera dodatkowe składniki, które rozszerzają funkcjonalność zestawu narzędzi MRTK.
| Folder | Składnik | opis |
|---|---|---|
| Zestaw narzędzi MRTK/rozszerzenia | ||
| HandPhysicsService | Usługa, która dodaje obsługę fizyki do przegubowych rąk. | |
| LostTrackingService | Usługa, która upraszcza przekazywanie śledzenia utraty na urządzeniach Microsoft HoloLens. | |
| SceneTransitionService | Usługa, która upraszcza dodawanie płynnych przejść scen. | |
| Próbki~ | Ukryty folder (w edytorze aparatu Unity), który zawiera przykładowe sceny i zasoby. |
Więcej szczegółów na temat procesu używania pakietów zawierających przykładowe projekty można znaleźć w artykule Mixed Reality Toolkit and Unity Menedżer pakietów (Zestaw narzędzi Mixed Reality Toolkit i Unity).
Zależności:
- Fundacja (
com.microsoft.mixedreality.toolkit.foundation)
Pakiet narzędzi
Opcjonalny pakiet narzędzi (com.microsoft.mixedreality.toolkit.tools) zawiera narzędzia przydatne do tworzenia środowisk rzeczywistości mieszanej. Ogólnie rzecz biorąc, te narzędzia są składnikami edytora, a ich kod nie jest dostarczany jako część aplikacji.
| Folder | Składnik | opis |
|---|---|---|
| NARZĘDZIA MRTK/Narzędzia | ||
| Kompilowanie systemu Windows | Narzędzie ułatwiające proces kompilowania i wdrażania aplikacji platformy UNIWERSALNEJ systemu Windows. | |
| ZależnośćWindow | Narzędzie, które tworzy graf zależności zasobów w projekcie. | |
| ExtensionServiceCreator | Kreator ułatwia tworzenie usług rozszerzeń. | |
| Migracja w systemie Windows | Narzędzie, które pomaga w aktualizowaniu kodu, który używa przestarzałych składników zestawu narzędzi MRTK. | |
| Optymalizowanie systemu Windows | Narzędzie ułatwiające automatyzowanie konfigurowania projektu rzeczywistości mieszanej w celu uzyskania najlepszej wydajności w środowisku Unity. | |
| ReserializeAssetsUtility | Zapewnia obsługę reserializowania określonych plików aparatu Unity. | |
| RuntimeTools/Tools/ControllerMappingTool | Narzędzie umożliwiające deweloperom szybkie określanie mapowań aparatu Unity dla kontrolerów sprzętu. | |
| Zrzut ekranuUtility | Umożliwia przechwytywanie obrazów aplikacji w edytorze aparatu Unity. | |
| TextureCombinerWindow | Narzędzie do łączenia tekstur graficznych. | |
| Przybornik | Interfejs użytkownika, który ułatwia odnajdywanie i używanie składników środowiska użytkownika zestawu narzędzi MRTK. |
Zależności:
- Fundacja (
com.microsoft.mixedreality.toolkit.foundation)
Pakiet narzędzi testowych
Opcjonalny pakiet narzędzi testowych (com.microsoft.mixedreality.toolkit.testutilities) zawiera kolekcję skryptów pomocnika, które umożliwiają deweloperom łatwe tworzenie testów trybu odtwarzania. Te narzędzia są szczególnie przydatne dla deweloperów tworzących składniki zestawu narzędzi MRTK.
| Folder | Składnik | opis |
|---|---|---|
| MRTK/Testy | ||
| Narzędzia testowe | Metody upraszczania tworzenia testów trybu odtwarzania, w tym narzędzi symulacji ręcznej. |
Zależności:
- Fundacja (
com.microsoft.mixedreality.toolkit.foundation)
Pakiet przykłady
Pakiet przykładów (com.microsoft.mixedreality.toolkit.examples) jest ustrukturyzowany, aby umożliwić deweloperom importowanie tylko interesujących ich przykładów.
Więcej szczegółów na temat procesu używania pakietów zawierających przykładowe projekty można znaleźć w artykule Mixed Reality Toolkit and Unity Menedżer pakietów (Zestaw narzędzi Mixed Reality Toolkit i Unity).
| Folder | Składnik | opis |
|---|---|---|
| Zestaw narzędzi MRTK/Przykłady | ||
| Próbki~ | Ukryty folder (w edytorze aparatu Unity), który zawiera przykładowe sceny i zasoby. | |
| Elementy zawartości standardowej | Wspólne zasoby współużytkowane przez wiele scen demonstracyjnych. |
Zależności:
- Fundacja (
com.microsoft.mixedreality.toolkit.foundation) - Rozszerzenia (
com.microsoft.mixedreality.toolkit.extensions)