MRTK paketleri — MRTK2
Karma Gerçeklik Toolkit (MRTK), Karma Gerçeklik donanım ve platformlar için destek sağlayarak platformlar arası Karma Gerçeklik uygulama geliştirmeye olanak tanıyan bir paket koleksiyonudur.
MRTK, varlık (.unitypackage) paketleri olarak ve Unity Paket Yöneticisi aracılığıyla kullanılabilir.
Varlık paketleri
MRTK varlığı (.unitypackage) GitHub'dan indirilebilir.
Varlık paketlerini kullanmanın avantajlarından bazıları şunlardır:
- Unity 2018.4 ve daha yeni sürümlerde kullanılabilir
- MRTK'da değişiklik yapmak kolay
- MRTK Varlıklar klasöründe
Bu zorlukların bazıları şunlardır:
- MRTK, projenin Varlıklar klasörünün bir parçasıdır ve
- Daha büyük projeler
- Daha yavaş derleme süreleri
- Bağımlılık yönetimi yok
- Müşterilerin paket bağımlılıklarını el ile çözümlemesi gerekir
- El ile güncelleştirme işlemi
- Birden çok adım
- Büyük (3000+dosya) kaynak denetimi güncelleştirmeleri
- MRTK'da yapılan değişiklikleri kaybetme riski
- Örnek paketini içeri aktarmak genellikle tüm örneklerin dahil olduğu anlamına gelir
Kullanılabilir paketler şunlardır:
Bu paketler GitHub'da kaynak kodundan Microsoft tarafından yayımlanıp desteklenir.
Temel paket
Karma Gerçeklik Toolkit Foundation, uygulamanızın Karma Gerçeklik Platformları genelinde ortak işlevlerden yararlanmasını sağlayan kod kümesidir.
MRTK Foundation Paketi
MRTK Foundation paketi aşağıdakileri içerir.
| Klasör | Bileşen | Açıklama |
|---|---|---|
| MRTK/Core | Arabirim ve tür tanımları, temel sınıflar, standart gölgelendirici. | |
| MRTK/Core/Sağlayıcılar | Platformdan bağımsız veri sağlayıcıları | |
| Eller | El izleme için temel sınıf desteği ve hizmetleri. | |
| InputAnimation | Baş hareketi ve el izleme verilerini kaydetme desteği. | |
| InputSimulation | El ve göz girişinin düzenleyici içi simülasyonu için destek. | |
| ObjectMeshObserver | Veri olarak 3B model kullanan uzamsal farkındalık gözlemcisi. | |
| UnityInput | Unity'nin giriş API'si aracılığıyla uygulanan ortak giriş cihazları (oyun çubuğu, fare vb.). | |
| MRTK/Sağlayıcılar | Platforma özgü veri sağlayıcıları | |
| LeapMotion | UltraLeap Artık Hareket denetleyicisi desteği. | |
| OpenVR | OpenVR cihazları için destek. | |
| Oculus | Görev gibi Oculus cihazları için destek. | |
| UnityAR | (Deneysel) Mobil AR cihazlarıyla MRTK kullanımını etkinleştiren kamera ayarları sağlayıcısı. | |
| WindowsMixedReality | Microsoft HoloLens ve çevreleyici kulaklıklar dahil olmak üzere Windows Mixed Reality cihazlar için destek. | |
| Windows | Konuşma ve dikte gibi Microsoft Windows'a özgü API'ler için destek. | |
| XR SDK | (Deneysel) Unity 2019.3 ve sonraki sürümlerde Unity'nin yeni XR çerçevesi desteği. | |
| MRTK/SDK | ||
| Deneysel | Gölgelendiriciler, kullanıcı arabirimi denetimleri ve tek tek sistem yöneticileri gibi deneysel özellikler. | |
| Özellikler | Foundation paketini temel alan işlevsellik. | |
| Profiller | Microsoft Karma Gerçeklik Araç Seti sistemleri ve hizmetleri için varsayılan profiller. | |
| StandardAssets | Ortak varlıklar; modeller, dokular, malzemeler vb. | |
| MRTK/SceneSystemResources | Sahne Sistemi tarafından kullanılan varlıklar ve kaynaklar | |
| MRTK/Hizmetler | ||
| BoundarySystem | VR sınır desteği uygulayan sistem. | |
| CameraSystem | Kamera yapılandırmasını ve yönetimini uygulayan sistem. | |
| DiagnosticsSystem | Uygulama tanılamasında uygulanan sistem, örneğin görsel profil oluşturucu. | |
| InputSystem | Kullanıcı girişlerine erişmek ve bunları işlemek için destek sağlayan sistem. | |
| SceneSystem | Çok sahneli uygulama desteği sağlayan sistem. | |
| SpatialAwarenessSystem | Kullanıcının ortamının farkındalığı için destek sağlayan sistem. | |
| TeleportSystem | ışınlanma desteği sağlayan sistem (atlamalardaki deneyim hakkında hareket etme). | |
| MRTK/StandardAssets | MrTK Standart gölgelendirici, temel malzemeler ve karma gerçeklik deneyimleri için diğer standart varlıklar |
Uzantılar paketi
İsteğe bağlı Microsoft.MixedRealityToolkit.Unity.Extensions paketi, Microsoft Karma Gerçeklik Toolkit'in işlevselliğini genişleten ek hizmetler içerir.
Not
Uzantı paketi için Microsoft.MixedRealityToolkit.Unity.Foundation gerekir.
| Klasör | Bileşen | Açıklama |
|---|---|---|
| MRTK/Uzantılar | ||
| HandPhysicsService | Ellere fizik desteği ekleyen hizmet. | |
| LostTrackingService | Microsoft HoloLens cihazlarda izleme kaybının işlenmesini basitleştiren hizmet. | |
| SceneTransitionService | Sorunsuz sahne geçişleri eklemeyi kolaylaştıran hizmet. |
Araçlar paketi
İsteğe bağlı Microsoft.MixedRealityToolkit.Unity.Tools paketi, Microsoft Karma Gerçeklik Toolkit kullanarak karma gerçeklik geliştirme deneyimini geliştiren yararlı araçlar içerir. Bu araçlar Unity Düzenleyicisi'nin Karma Gerçeklik Araç Seti > Yardımcı Programları menüsünde bulunur.
Not
Araç paketi için Microsoft.MixedRealityToolkit.Unity.Foundation gerekir.
| Klasör | Bileşen | Açıklama |
|---|---|---|
| MRTK/Araçlar | ||
| BuildWindow | UWP uygulamaları oluşturma ve dağıtma sürecini basitleştirmeye yardımcı olan araç. | |
| DependencyWindow | Projedeki varlıkların bağımlılık grafiğini oluşturan araç. | |
| ExtensionServiceCreator | Uzantı hizmetleri oluşturmaya yardımcı olan sihirbaz. | |
| MigrationWindow | Kullanım dışı MRTK bileşenlerini kullanan kodu güncelleştirmeye yardımcı olan araç. | |
| OptimizeWindow | Unity'de en iyi performans için karma gerçeklik projesi yapılandırmayı otomatikleştirmeye yardımcı olan yardımcı program. | |
| ReserializeAssetsUtility | Belirli Unity dosyalarını yeniden seri durumdan çıkarma desteği sağlar. | |
| RuntimeTools/Tools/ControllerMappingTool | Geliştiricilerin donanım denetleyicileri için Unity eşlemelerini hızla belirlemesini sağlayan yardımcı program. | |
| ScreenshotUtility | Unity düzenleyicisinde uygulama görüntülerini yakalamayı etkinleştirir. | |
| TextureCombinerWindow | Grafik dokularını birleştirmek için yardımcı program. | |
| Araç Kutusu | MRTK UX bileşenlerini bulmayı ve kullanmayı kolaylaştıran kullanıcı arabirimi. |
Test yardımcı programları paketi
İsteğe bağlı Microsoft.MixedRealityToolkit.TestUtilities paketi, geliştiricilerin kolayca yürütme modu testleri oluşturmasını sağlayan bir yardımcı betik koleksiyonudur. Bu yardımcı programlar özellikle MRTK bileşenleri oluşturan geliştiriciler için kullanışlıdır.
| Klasör | Bileşen | Açıklama |
|---|---|---|
| MRTK/Testler | ||
| TestUtilities | El simülasyonu yardımcı programları da dahil olmak üzere oyun modu testlerinin oluşturulmasını basitleştirme yöntemleri. |
Örnek paketi
Örnek paketi, temel paketteki işlevselliği kullanan tanıtımlar, örnek betikler ve örnek sahneler içerir. Bu paket, çeşitli el girişi türlerine yanıt veren örnek nesneleri içeren HandInteractionExample sahnesini (aşağıda resimlenmiştir) içerir (ifadeli ve ifadesiz).
Bu paket, burada belgelenen göz izleme tanıtımlarını da içerir
Daha genel olarak, MRTK'daki yeni özellikler örnek paketinde karşılık gelen bir örnek içermelidir ve kabaca aynı klasör yapısını ve konumunu izler.
Not
Örnek paketi için Microsoft.MixedRealityToolkit.Unity.Foundation gerekir.
| Klasör | Bileşen | Açıklama |
|---|---|---|
| MRTK/Örnekler | ||
| Demolar | Bir veya iki ilgili özelliği gösteren basit sahneler. | |
| Deneysel | Deneysel özellikleri gösteren tanıtım sahneleri. | |
| StandardAssets | Birden çok tanıtım sahnesi tarafından paylaşılan ortak varlıklar. |
Unity Paket Yöneticisi
Unity 2019.4 ve daha yeni sürümler kullanılarak oluşturulan deneyimler için MRTK, Unity Paket Yöneticisi aracılığıyla kullanılabilir.
Varlık paketlerini kullanmanın avantajlarından bazıları şunlardır:
- Daha küçük projeler
- Daha temiz Visual Studio çözümleri
- İade etmek için daha az dosya (MRTK, dosyada
Packages/manifest.jsonbasit bir başvurudur)
- Daha hızlı derleme
- Unity'nin bina sırasında MRTK'yi yeniden derlemesi gerekmez
- Bağımlılık çözümlemesi
- Bağımlılıkları olan paketler belirtilirken gerekli MRTK paketleri otomatik olarak yüklenir
- Yeni MRTK sürümlerine kolay güncelleştirme
- Dosyadaki
Packages/manifest.jsonsürümü değiştirme
- Dosyadaki
Bu zorlukların bazıları şunlardır:
- MRTK sabittir
- Paket çözümlemesi sırasında kaldırılmadan değişiklik yapılamaz
- MRTK, Unity 2018.4 ile UPM paketlerini desteklemez
Temel paket
Temel paket (com.microsoft.mixedreality.toolkit.foundation), Karma Gerçeklik Araç Seti'nin temelini oluşturur.
| Klasör | Bileşen | Açıklama |
|---|---|---|
| MRTK/Core | Arabirim ve tür tanımları, temel sınıflar, standart gölgelendirici. | |
| MRTK/Core/Sağlayıcılar | Platformdan bağımsız veri sağlayıcıları | |
| Eller | El izleme için temel sınıf desteği ve hizmetleri. | |
| InputAnimation | Baş hareketi ve el izleme verilerini kaydetme desteği. | |
| InputSimulation | El ve göz girişinin düzenleyici içi simülasyonu için destek. | |
| ObjectMeshObserver | Veri olarak 3B model kullanan uzamsal farkındalık gözlemcisi. | |
| UnityInput | Unity'nin giriş API'si aracılığıyla uygulanan ortak giriş cihazları (oyun çubuğu, fare vb.). | |
| MRTK/Sağlayıcılar | Platforma özgü veri sağlayıcıları | |
| LeapMotion | UltraLeap Artık Hareket denetleyicisi desteği. | |
| OpenVR | OpenVR cihazları için destek. | |
| Oculus | Görev gibi Oculus cihazları için destek. | |
| UnityAR | (Deneysel) Mobil AR cihazlarıyla MRTK kullanımını etkinleştiren kamera ayarları sağlayıcısı. | |
| WindowsMixedReality | Microsoft HoloLens ve çevreleyici kulaklıklar dahil olmak üzere Windows Mixed Reality cihazlar için destek. | |
| Windows | Konuşma ve dikte gibi Microsoft Windows'a özgü API'ler için destek. | |
| XR SDK | (Deneysel) Unity 2019.3 ve sonraki sürümlerde Unity'nin yeni XR çerçevesi desteği. | |
| MRTK/SDK | ||
| Deneysel | Gölgelendiriciler, kullanıcı arabirimi denetimleri ve tek tek sistem yöneticileri gibi deneysel özellikler. | |
| Özellikler | Foundation paketini temel alan işlevsellik. | |
| Profiller | Microsoft Karma Gerçeklik Araç Seti sistemleri ve hizmetleri için varsayılan profiller. | |
| StandardAssets | Ortak varlıklar; modeller, dokular, malzemeler vb. | |
| MRTK/Hizmetler | ||
| BoundarySystem | VR sınır desteği uygulayan sistem. | |
| CameraSystem | Kamera yapılandırmasını ve yönetimini uygulayan sistem. | |
| DiagnosticsSystem | Uygulama tanılamasında uygulanan sistem, örneğin görsel profil oluşturucu. | |
| InputSystem | Kullanıcı girişlerine erişmek ve bunları işlemek için destek sağlayan sistem. | |
| SceneSystem | Çok sahneli uygulama desteği sağlayan sistem. | |
| SpatialAwarenessSystem | Kullanıcının ortamının farkındalığı için destek sağlayan sistem. | |
| TeleportSystem | ışınlanma desteği sağlayan sistem (atlamalardaki deneyim hakkında hareket etme). |
Bağımlılık:
- Standart Varlıklar (
com.microsoft.mixedreality.toolkit.standardassets)
Standart Varlıklar
Standart varlık paketi (com.microsoft.mixedreality.toolkit.standardassets) aşağıdakiler dahil olmak üzere tüm karma gerçeklik deneyimleri için önerilen bileşenlerden oluşan bir koleksiyondur:
- MRTK Standart gölgelendirici
- MRTK Standart gölgelendiricisi kullanan temel malzemeler
- Ses dosyaları
- Yazı Tipleri
- Dokular
- Simgeler
Not
Derleme tanımlarına göre hataya neden olan değişiklikleri önlemek için MRTK Standart gölgelendiricisinin bazı özelliklerini denetlemek için kullanılan betikler standart varlık paketine dahil değildir. Bu betikler klasöründeki temel pakette MRTK/Core/Utilities/StandardShader bulunabilir.
Bağımlılıklar: yok
Uzantı paketleri
İsteğe bağlı uzantılar paketi (com.microsoft.mixedreality.toolkit.extensions) MRTK'nın işlevselliğini genişleten ek bileşenler içerir.
| Klasör | Bileşen | Açıklama |
|---|---|---|
| MRTK/Uzantılar | ||
| HandPhysicsService | Ellere fizik desteği ekleyen hizmet. | |
| LostTrackingService | Microsoft HoloLens cihazlarda izleme kaybının teslimini basitleştiren hizmet. | |
| SceneTransitionService | Sorunsuz sahne geçişleri eklemeyi kolaylaştıran hizmet. | |
| Örnekleri~ | Örnek sahneleri ve varlıkları içeren gizli bir klasör (Unity Düzenleyicisi'nde). |
Örnek projeleri içeren paketleri kullanma işlemiyle ilgili daha fazla ayrıntı Karma Gerçeklik Araç Seti ve Unity Paket Yöneticisi makalesinde bulunabilir.
Bağımlılık:
- Temel (
com.microsoft.mixedreality.toolkit.foundation)
Araçlar paketi
İsteğe bağlı araçlar paketi (com.microsoft.mixedreality.toolkit.tools) karma gerçeklik deneyimleri oluşturmak için yararlı araçlar içerir. Genel olarak, bu araçlar düzenleyici bileşenleridir ve kodları bir uygulamanın parçası olarak sunulmaz.
| Klasör | Bileşen | Açıklama |
|---|---|---|
| MRTK/Araçlar | ||
| BuildWindow | UWP uygulamaları oluşturma ve dağıtma sürecini basitleştirmeye yardımcı olan araç. | |
| DependencyWindow | Projedeki varlıkların bağımlılık grafiğini oluşturan araç. | |
| ExtensionServiceCreator | Uzantı hizmetleri oluşturmaya yardımcı olan sihirbaz. | |
| MigrationWindow | Kullanım dışı MRTK bileşenlerini kullanan kodu güncelleştirmeye yardımcı olan araç. | |
| OptimizeWindow | Unity'de en iyi performans için karma gerçeklik projesi yapılandırmayı otomatikleştirmeye yardımcı olan yardımcı program. | |
| ReserializeAssetsUtility | Belirli Unity dosyalarını yeniden seri durumdan çıkarma desteği sağlar. | |
| RuntimeTools/Tools/ControllerMappingTool | Geliştiricilerin donanım denetleyicileri için Unity eşlemelerini hızla belirlemesini sağlayan yardımcı program. | |
| ScreenshotUtility | Unity düzenleyicisinde uygulama görüntülerini yakalamayı etkinleştirir. | |
| TextureCombinerWindow | Grafik dokularını birleştirmek için yardımcı program. | |
| Araç Kutusu | MRTK UX bileşenlerini bulmayı ve kullanmayı kolaylaştıran kullanıcı arabirimi. |
Bağımlılık:
- Temel (
com.microsoft.mixedreality.toolkit.foundation)
Test yardımcı programları paketi
İsteğe bağlı test yardımcı programları paketi (com.microsoft.mixedreality.toolkit.testutilities), geliştiricilerin kolayca yürütme modu testleri oluşturmasını sağlayan bir yardımcı betik koleksiyonu içerir. Bu yardımcı programlar özellikle MRTK bileşenleri oluşturan geliştiriciler için kullanışlıdır.
| Klasör | Bileşen | Açıklama |
|---|---|---|
| MRTK/Testler | ||
| TestUtilities | El simülasyonu yardımcı programları da dahil olmak üzere oyun modu testlerinin oluşturulmasını basitleştirme yöntemleri. |
Bağımlılık:
- Temel (
com.microsoft.mixedreality.toolkit.foundation)
Örnek paketi
Örnek paketi ()com.microsoft.mixedreality.toolkit.examples geliştiricilerin yalnızca ilgi çekici örnekleri içeri aktarmasına izin verecek şekilde yapılandırılmıştır.
Örnek projeleri içeren paketleri kullanma işlemiyle ilgili daha fazla ayrıntı Karma Gerçeklik Araç Seti ve Unity Paket Yöneticisi makalesinde bulunabilir.
| Klasör | Bileşen | Açıklama |
|---|---|---|
| MRTK/Örnekler | ||
| Örnekleri~ | Örnek sahneleri ve varlıkları içeren gizli bir klasör (Unity Düzenleyicisi'nde). | |
| StandardAssets | Birden çok tanıtım sahnesi tarafından paylaşılan ortak varlıklar. |
Bağımlılık:
- Temel (
com.microsoft.mixedreality.toolkit.foundation) - Uzantılar (
com.microsoft.mixedreality.toolkit.extensions)