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:

• Fundacja
• Rozszerzenia
• Narzędzia
• Narzędzia testowe
• Przykłady

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.json w 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.json pliku

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)

Zobacz też

• Omówienie architektury
• Systemy, usługi rozszerzeń i Dostawca danych
• Zestaw narzędzi Mixed Reality Toolkit i Menedżer pakietów Unity