MRTK paketleri

Karma Gerçeklik araç seti (MRTK), karma gerçeklik donanım ve platformları için destek sağlayarak platformlar arası karma gerçeklik uygulaması geliştirmeyi etkinleştiren bir paket koleksiyonudur.

mrtk, varlık (. unitypackage) paketleri ve Unity Paket Yöneticisiaracılığıyla kullanılabilir.

Varlık paketleri

MRTK varlığı (. unitypackage) GitHubadresinden indirilebilir.

Varlık paketlerini kullanmanın avantajlarından bazıları şunlardır:

  • Unity 2018,4 ve üzeri için kullanılabilir
  • MRTK 'da değişiklik yapmak kolay
    • MRTK, varlıklar klasöründedir

Bu zorlukların bazıları şunlardır:

  • MRTK, projenin varlıklar klasörünün bir parçası, önde gelen
    • 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 çözmesi gerekir
  • El ile güncelleştirme işlemi
    • Birden çok adım
    • Büyük (3000 + dosya) kaynak denetimi güncelleştirmeleri
    • MRTK 'de yapılan değişiklikleri kaybetme riski
  • Örnekler paketinin içeri aktarılması genellikle tüm örneklerin dahil olduğu anlamına gelir

Kullanılabilir paketler şunlardır:

Bu paketler, GitHub mrtk_release dalındaki kaynak kodundan Microsoft tarafından yayımlanır ve desteklenir.

Foundation paketi

Karma Gerçeklik araç seti temeli, uygulamanızın karma gerçeklik platformları genelinde ortak işlevlerden yararlanmasını sağlayan kod kümesidir.

Pakage Foundationmrtk Foundation paketi

MRTK Foundation paketi aşağıdakileri içerir.

Klasör Bileşen Açıklama
MRTK/çekirdek Arabirim ve tür tanımları, temel sınıflar, standart gölgelendirici.
MRTK/çekirdek/sağlayıcılar Platform belirsiz veri sağlayıcıları
Kol Temel sınıf desteği ve el izlemeye yönelik hizmetler.
Inputanimation Baş taşıma ve izleme verilerini kaydetme desteği.
Inputsimülasyon El ve göz girişi Düzenleyicisi 'nin düzenleyici benzetimi için destek.
ObjectMeshObserver Veri olarak 3B model kullanarak uzamsal tanıma gözlemci.
Unityınput Ortak giriş aygıtları (oyun çubuğu, fare vb.) Unity 'nin giriş API 'SI ile uygulanır.
MRTK/sağlayıcılar Platforma özgü veri sağlayıcıları
LeapMotion UltraLeap artık hareket denetleyicisi için destek.
OpenVR OpenVR cihazları için destek.
Oculus No. ile birlikte 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 modern kulaklıklar gibi Windows Mixed Reality cihazları için destek.
Windows Microsoft Windows belirli apı 'ler için destek; örneğin, konuşma ve dikte.
XR SDK Deneysel Unity 'nin yeni XR Framework , Unity 2019,3 ve üzeri sürümlerde desteklenir.
MRTK/SDK
Deneysel Gölgelendiriciler, Kullanıcı arabirimi denetimleri ve ayrı sistem yöneticileri dahil deneysel Özellikler.
Özellikler Temel paket üzerinde derleme yapan 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/manzara \ kaynak Sahne sistemi tarafından kullanılan varlıklar ve kaynaklar
MRTK/hizmetler
Sıçrama Darrivsystem Sistem, VR sınırı desteğini uygulayan.
CameraSystem Kamera yapılandırmasını ve yönetimini uygulayan sistem.
DiagnosticsSystem Uygulama tanılamasında, örneğin bir görsel profil Oluşturucu için uygulama.
Inputsystem Sistem, Kullanıcı girişini erişmek ve işlemek için destek sağlar.
SceneSystem Çok sahlı uygulama desteği sağlayan sistem.
Spatıalawarenesssystem Sistem, kullanıcının ortamının farkında için destek sağlar.
TeleportSystem Telefon taşıma (atlamalar ile ilgili deneyim) için destek sağlayan sistem.
MRTK/StandardAssets Bu karma gerçeklik deneyimleri için MRTK standart gölgelendirici, temel malzemeler ve diğer standart varlıklar

Uzantı paketi

İsteğe bağlı Microsoft. MixedRealityToolkit. Unity. Extensions paketi Microsoft karma gerçeklik araç seti işlevlerini genişleten ek hizmetler içerir.

Not

Uzantılar paketi için Microsoft. MixedRealityToolkit. Unity. Foundation gerekir.

Klasör Bileşen Açıklama
MRTK/Uzantılar
HandPhysicsService Açık ellere fizik desteği ekleyen hizmet.
LostTrackingService Cihazlardaki izleme kaybının işlenmesini basitleştiren Microsoft HoloLens 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 Mixed Reality 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 Bir proje içinde varlıkların bağımlılık grafı 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 boyutlandırma 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ı sağlar.
TextureCombinerWindow Grafik dokularını birleştirme yardımcı programı.
Araç Kutusu MRTK UX bileşenlerini keşfetmeyi ve kullanmayı kolaylaştıran kullanıcı arabirimi.

Test yardımcı programları paketi

İsteğe bağlı Microsoft.MixedRealityToolkit.TestUtilities paketi, geliştiricilerin kolayca oynatma modu testleri oluşturmasına olanak sağlayan yardımcı betiklerden bir koleksiyondur. Bu yardımcı programlar özellikle MRTK bileşenleri oluşturan geliştiriciler için yararlıdır.

Klasör Bileşen Açıklama
MRTK/Testler
TestUtilities El simülasyonu yardımcı programları dahil olmak üzere oynatma modu testlerinin oluşturulmasını basitleştirme yöntemleri.

Örnek paketi

Örnek paketinde tanıtımlar, örnek betikler ve temel pakette işlev alıştırması yapılan örnek sahneler yer almaktadır. Bu paket, çeşitli el girişi türlerine (ifade edilen ve ifade olmayan) yanıt veren örnek nesneleri içeren HandInteractionExample sahnesini (aşağıda gösterilmiştir) içerir.

HandInteractionExample sahnesi

Bu paket ayrıca burada belgelenmiş olan göz izleme tanıtımlarını da içerir

Daha genel olarak, MRTK'daki herhangi bir yeni özellik, örnek paketinde kabaca aynı klasör yapısını ve konumunu takip eden bir örnek içermesi gerekir.

Not

Örnek paketi için Microsoft.MixedRealityToolkit.Unity.Foundation gerekir.

Klasör Bileşen Açıklama
MRTK/Örnekler
Demolar Bir veya iki ilgili özelliğin yer alan basit sahneler.
Deneysel Deneysel özelliklerin yer alan 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ümleri kullanılarak oluşturulan deneyimler için MRTK, UnityPaket Yöneticisi.

Varlık paketlerini kullanmanın avantajlarından bazıları şunlardır:

  • Daha küçük projeler
    • Daha Visual Studio çözümleri
    • Iade etmek için daha az dosya (MRTK dosyada basit bir Packages/manifest.json başvuru)
  • Daha hızlı derleme
    • Unity'nin derleme sırasında MRTK'ı yeniden derlemesi gerek yok
  • Bağımlılık çözümlemesi
    • Bağımlılıklara sahip paketler belirtilirken gerekli MRTK paketleri otomatik olarak yüklenir
  • Yeni MRTK sürümlerine kolay güncelleştirme
    • Dosyanın sürümünü Packages/manifest.json değiştirme

Bu zorlukların bazıları şunlardır:

  • MRTK sabittir
    • Paket çözümlemesi sırasında kaldırılanlar olmadan değişiklik olamaz
  • 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/Çekirdek Arabirim ve tür tanımları, temel sınıflar, standart gölgelendirici.
MRTK/Çekirdek/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şlerinin düzenleyici içinde simülasyonu için destek.
ObjectMeshObserver Uzamsal farkındalık gözlemcisi, veri olarak 3 boyutlu bir model kullanıyor.
UnityInput Ortak giriş aygıtları (oyun çubuğu, fare vb.) Unity 'nin giriş API 'SI ile uygulanır.
MRTK/sağlayıcılar Platforma özgü veri sağlayıcıları
LeapMotion UltraLeap artık hareket denetleyicisi için destek.
OpenVR OpenVR cihazları için destek.
Oculus No. ile birlikte 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 modern kulaklıklar gibi Windows Mixed Reality cihazları için destek.
Windows Microsoft Windows belirli apı 'ler için destek; örneğin, konuşma ve dikte.
XR SDK Deneysel Unity 'nin yeni XR Framework , Unity 2019,3 ve üzeri sürümlerde desteklenir.
MRTK/SDK
Deneysel Gölgelendiriciler, Kullanıcı arabirimi denetimleri ve ayrı sistem yöneticileri dahil deneysel Özellikler.
Özellikler Temel paket üzerinde derleme yapan 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
Sıçrama Darrivsystem Sistem, VR sınırı desteğini uygulayan.
CameraSystem Kamera yapılandırmasını ve yönetimini uygulayan sistem.
DiagnosticsSystem Uygulama tanılamasında, örneğin bir görsel profil Oluşturucu için uygulama.
Inputsystem Sistem, Kullanıcı girişini erişmek ve işlemek için destek sağlar.
SceneSystem Çok sahlı uygulama desteği sağlayan sistem.
Spatıalawarenesssystem Sistem, kullanıcının ortamının farkında için destek sağlar.
TeleportSystem Telefon taşıma (atlamalar ile ilgili deneyim) için destek sağlayan sistem.

Bağlantılıdır

  • Standart varlıklar ( com.microsoft.mixedreality.toolkit.standardassets )

Standart varlıklar

Standart varlıklar paketi ( com.microsoft.mixedreality.toolkit.standardassets) aşağıdakiler de dahil olmak üzere tüm karma gerçeklik deneyimleri için önerilen bileşenlerin koleksiyonudur:

  • MRTK standart gölgelendirici
  • MRTK standart gölgelendiricisi kullanan temel malzemeler
  • Ses dosyaları
  • Yazı Tipleri
  • Dokular
  • Simgeler

Not

Derleme tanımlarına göre önemli değişikliklerden kaçınmak için, MRTK standart gölgelendirici 'nın bazı özelliklerini denetlemek için kullanılan betikler standart varlıklar paketine dahil edilmez. Bu betikler klasöründeki Foundation paketinde bulunabilir MRTK/Core/Utilities/StandardShader .

Bağımlılıklar: yok

Uzantı paketleri

İsteğe bağlı uzantılar paketi ( com.microsoft.mixedreality.toolkit.extensions) MRTK işlevlerini genişleterek ek bileşenleri içerir.

Klasör Bileşen Açıklama
MRTK/uzantılar
HandPhysicsService İfade etmek için fizik desteği ekleyen hizmet.
LostTrackingService Microsoft HoloLens cihazlarında izleme kaybını kolaylaştıran hizmet.
Manzara hizmeti Yumuşak sahne geçişleri eklemeyi kolaylaştıran hizmet.
Örnekler ~ Örnek sahneleri ve varlıkları içeren bir gizli (Unity düzenleyici) klasörü.

örnek projeler içeren paketleri kullanma işlemi hakkında daha fazla ayrıntı, karma gerçeklik araç seti ve Unity Paket Yöneticisi makalesinde bulunabilir.

Bağlantılıdır

  • Foundation ( com.microsoft.mixedreality.toolkit.foundation )

Araçlar paketi

İsteğe bağlı Araçlar paketi ( com.microsoft.mixedreality.toolkit.tools) karışık gerçeklik deneyimleri oluşturmak için yararlı olan araçları içerir. Genel olarak, bu araçlar düzenleyici bileşenleridir ve kodu bir uygulamanın parçası olarak gelmez.

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ı olacak sihirbaz.
MigrationWindow Kullanım dışı MRTK bileşenlerini kullanan kodu güncelleştirmede yardımcı olan araç.
OptimizeWindow Unity 'de en iyi performans için bir karma gerçeklik projesinin yapılandırılmasını otomatik hale getirmeye yardımcı olan yardımcı program.
Reserializeassetsusystemutility Belirli Unity dosyalarının yeniden serileştirilmesi için destek sağlar.
RuntimeTools/Tools/ControllerMappingTool Yardımcı program, geliştiricilerin donanım denetleyicileri için Unity eşlemelerini hızlıca belirlemesine olanak sağlar.
Ekransal Unity düzenleyicisinde uygulama görüntülerinin yakalamaya izin vermez.
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 ( ), geliştiricilerin kolayca oynatma modu testleri oluşturmasına olanak com.microsoft.mixedreality.toolkit.testutilities sağlayan bir yardımcı betik koleksiyonu içerir. Bu yardımcı programlar özellikle MRTK bileşenleri oluşturan geliştiriciler için yararlıdır.

Klasör Bileşen Açıklama
MRTK/Testler
TestUtilities El simülasyonu yardımcı programları dahil olmak üzere oynatma 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 alanlarına sahip örnekleri içeri aktarmasına olanak sağlayacak şekilde yapılandırılmıştır.

Örnek projeler içeren paketleri kullanma işlemiyle ilgili diğer ayrıntılar Karma Gerçeklik Araç Seti ve Unity Paket Yöneticisi bulunabilir.

Klasör Bileşen Açıklama
MRTK/Örnekler
Örnekler~ Örnek sahneleri ve varlıkları içeren gizli (Unity Düzenleyicisi'nde) bir klasör.
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 )

Ayrıca bkz.