Pakiety zestawu narzędzi MRTK — MRTK2
Mixed Reality Toolkit (MRTK) to zbiór pakietów, które umożliwiają tworzenie aplikacji Mixed Reality międzyplatformowych, zapewniając obsługę Mixed Reality sprzętu i platform.
Zestaw narzędzi MRTK jest dostępny jako pakiety zawartości (unitypackage) i za pośrednictwem Menedżera 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 zestawu 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 dla 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 poziomu 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 Mixed Reality.
MRTK Foundation Package
Pakiet MRTK Foundation zawiera następujące elementy.
| Folder | Składnik | Opis |
|---|---|---|
| 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 ruchu głowy i danych ś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 (infrastruktura, mysz itp.) implementowane za pośrednictwem wejściowego interfejsu API 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 umożliwiający korzystanie z zestawu narzędzi MRTK z urządzeniami przenośnymi AR. | |
| WindowsMixedReality | Obsługa urządzeń Windows Mixed Reality, w tym 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 środowisku Unity 2019.3 i nowszych. | |
| Zestaw MRTK/SDK | ||
| Eksperymentalne | Funkcje eksperymentalne, w tym cieniowanie, kontrolki interfejsu użytkownika i poszczególne menedżery systemu. | |
| Funkcje | Funkcjonalność, która opiera się na pakiecie Foundation. | |
| Profile | Domyślne profile 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 sceny | |
| MRTK/Usługi | ||
| BoundarySystem | System implementuje obsługę granic VR. | |
| CameraSystem | System implementuje konfigurację aparatu i zarządzanie nimi. | |
| DiagnosticsSystem | Implementacja systemu w diagnostyce aplikacji, na przykład profiler wizualizacji. | |
| InputSystem | System zapewnia obsługę uzyskiwania dostępu do danych wejściowych użytkowników i 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 w skokach). | |
| ZASOBY MRTK/StandardAssets | 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 wsparcie 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, które rozszerzają ś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 |
|---|---|---|
| MRTK/Narzędzia | ||
| BuildWindow | Narzędzie ułatwiające proces kompilowania i wdrażania aplikacji platformy UWP. | |
| ZależnośćWindow | Narzędzie tworzące graf zależności zasobów w projekcie. | |
| ExtensionServiceCreator | Kreator pomagający w tworzeniu 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 afiszowaniu aparatu 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ładów zawiera pokazy, przykładowe skrypty i przykładowe sceny, które ćwiczą funkcjonalność w pakiecie podstawowym. Ten pakiet zawiera scenę HandInteractionExample (na zdjęciu poniżej), która zawiera przykładowe obiekty reagujące na różne typy danych wejściowych ręcznych (wyartykułowane i niezgubskrypcyjne).
Ten pakiet zawiera również pokazy śledzenia oczu, które zostały opisane tutaj
Ogólnie rzecz biorąc, każda nowa funkcja zestawu narzędzi MRTK powinna zawierać odpowiedni przykład w pakiecie examples, mniej więcej po tej samej strukturze folderów i lokalizacji.
Uwaga
Pakiet przykładów wymaga zestawu Microsoft.MixedRealityToolkit.Unity.Foundation.
| Folder | Składnik | Opis |
|---|---|---|
| MrTK/Przykłady | ||
| Dema | 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żera 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 do 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 pakietów
- 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 |
|---|---|---|
| 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 ruchu głowy i danych ś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 (infrastruktura, mysz itp.) implementowane za pośrednictwem wejściowego interfejsu API 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 umożliwiający korzystanie z zestawu narzędzi MRTK z urządzeniami przenośnymi AR. | |
| WindowsMixedReality | Obsługa urządzeń Windows Mixed Reality, w tym 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 środowisku Unity 2019.3 i nowszych. | |
| Zestaw MRTK/SDK | ||
| Eksperymentalne | Funkcje eksperymentalne, w tym cieniowanie, kontrolki interfejsu użytkownika i poszczególne menedżery systemu. | |
| Funkcje | Funkcjonalność, która opiera się na pakiecie Foundation. | |
| Profile | Domyślne profile systemów i usług microsoft Mixed Reality Toolkit. | |
| Elementy zawartości standardowej | Wspólne zasoby; modele, tekstury, materiały itp. | |
| MRTK/Usługi | ||
| BoundarySystem | System implementuje obsługę granic VR. | |
| CameraSystem | System implementuje konfigurację aparatu i zarządzanie nimi. | |
| DiagnosticsSystem | Implementacja systemu w diagnostyce aplikacji, na przykład profiler wizualizacji. | |
| InputSystem | System zapewnia obsługę uzyskiwania dostępu do danych wejściowych użytkowników i 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 w skokach). |
Zależności:
- Zasoby standardowe (
com.microsoft.mixedreality.toolkit.standardassets)
Standardowe zasoby
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 wsparcie 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) zawierający 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 Package Manager (Menedżer pakietów aparatu 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 częścią aplikacji.
| Folder | Składnik | Opis |
|---|---|---|
| MRTK/Narzędzia | ||
| BuildWindow | Narzędzie ułatwiające proces kompilowania i wdrażania aplikacji platformy UWP. | |
| ZależnośćWindow | Narzędzie tworzące graf zależności zasobów w projekcie. | |
| ExtensionServiceCreator | Kreator pomagający w tworzeniu 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 afiszowaniu aparatu 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 pomocników, 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 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:
- Foundation (
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 przykładów zainteresowania.
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 Package Manager (Menedżer pakietów aparatu Unity).
| Folder | Składnik | Opis |
|---|---|---|
| MrTK/Przykłady | ||
| Próbki~ | Ukryty folder (w edytorze aparatu Unity) zawierający przykładowe sceny i zasoby. | |
| Zasoby standardowe | Wspólne zasoby współużytkowane przez wiele scen demonstracyjnych. |
Zależności:
- Foundation (
com.microsoft.mixedreality.toolkit.foundation) - Rozszerzenia (
com.microsoft.mixedreality.toolkit.extensions)