Microsoft Karma Gerçeklik Toolkit 2.7 Sürüm Notları

2.7.3 sürümündeki yenilikler

Redmond'dan özel bir teşekkür

MRTK ekibi, mrtk topluluğuna teşekkür etmek istiyor. Katkılarınız, geri bildirimleriniz ve oylarınız MRTK'nin 2021 En İyi Geliştirici Aracı Ödülü'nü kazanmasına yardımcı oldu! Senin desteğin olmasaydı, bugün olduğumuz yerde olmazdık. İster yeni platform desteği, yeni özellikler, hata düzeltmeleri, öneriler, sorular ya da katkıda bulunabileceğiniz diğer birçok yöntemden biri olsun: Teşekkür ederiz!

Unity 2021 desteği

2.7.3 sürümüyle Unity 2021'i derlemeyi kolaylaştırdık! Unity 2021 ile MRTK kullanırken herhangi bir sorun bulursanız GitHub depomuzda bir sorun oluşturun.

Uzaktan iletişim desteği aracılığıyla Scene Understanding (Yalnızca OpenXR)

Scene Understanding artık OpenXR platformuyla HoloLens 2 uzaktan iletişim sırasında kullanılabilir.

MRTK 2.7.3 Hata Düzeltmeleri ve Değişiklikler

• Bir profil bu klasöre kopyalanmadığı sürece klasör oluşturmayı CustomProfiles durdurdu #9916
• GameObjects #9939 üzerinde çağrısı .gameObject kaldırıldı
• Devre dışı bırakılmış bileşenlere sahip nesnelerin işaretçilerin odak kilitlenmesine neden olduğu bir hata düzeltildi #9945
• Unity 2021 #9938 için kullanım dışı yöntemler güncelleştirildi ve derleyici hataları düzeltildi
• Unity 2021 #9942 için düzeltildilink.xml
• Düğme yapılandırma denetçisi simge adlarını gösterecek şekilde güncelleştirildi #9972
• Denetleyici eşleme listesinin üst bilgisi ve hizalaması güncelleştirildi #9976
• MRTK için çeşitli Unity geliştirmeleri #9940
• BoundsControl çarpıştırıcı sorunları ve tutarsızlık düzeltildi #9973
• Düğme simgesi denetçiler kümesi #9999 düzeltildi
• Sabit BoundsControl ölçek tutamacı harmanlayıcı hizalaması #10007
• #10006 kategorisine ayrılan SDF yazı tipi dokusu düzeltildi
• Sabit BoundsControl otomatik düzleştirme ve ölçek tutamacı yönlendirmesi #10013
• BoundsControl düzleştirme düzeltmesi #10016 için geri bildirim eklendi
• Animasyon kayıttan yürütme sırasında el örgüslü garip deformasyonlar düzeltildi #10024
• Scene Understanding #10026 için günlük kaydı düzeltildi SpatialAwarenessSurfaceTypes
• Artık örnek sahne betiği #10036'ya tek başına tanımlama yönergesi eklendi
• Düzenleyicide varsayılan olmayan etkinleştirme türü belirtildiğinde BoundsControlOnEnable sorunu düzeltildi #10039
• OpenGL ES ve Metal #10041 için geçersiz gölgelendirici bayt kodu hataları düzeltildi
• Unity 2020 #10046'da Derleme Penceresinin donması sorununu düzeltmek için çağrı eklendi ClearProgressBar
• Yazı tipi varlıkları için serileştirme güncelleştirildi #10047
• Uygun sıkıştırma kaydırıcısı colliders #10060 olması için el etkileşimi sahnesi düzeltildi
• Sabit Surface Manyetizma quaternion matematik #10074
• Geliştirilmiş PV kamera sürümü iletileri #10077
• Sabit BoundingBoxHelper.GetRawBoundsCorners koruma düzeyi #10093
• gLTF içeri aktarma günlükleri birden çok #10090 yerine tek günlük olacak şekilde güncelleştirildi
• MRTK olmayan sahnelerden betik kaldırıldı MRSceneContent#10091
• Unity 2018 uyumluluk #10092 için örnek sahnelerden paket tabanlı olay sistemleri kaldırıldı
• Microsoft OpenXR paketlerini önizleme desteği kaldırıldı #10119
• Veri alırken uygulamaların donması düzeltildi #10033
• #10127 olmadan ile çarpıştırıcıdan EyeTrackingTarget çarpıştırıcıya geçerken OnLookAway'in tetiklenmemesi düzeltildi EyeTrackingTarget
• Fare işaretçisi davranışını daha sezgisel hale getirmek için varsayılan işaretçi kapsamı değiştirildi #10075
• Başlatma çalıştırmaları #10177 olduğunda netleştirmek için özet güncelleştirildi
• #10190'daLinePointer bir NullReferenceException sorun düzeltildi
• Eşit olmayan ölçek sorunlarıyla boundsControl düzeltildi #10133
• Farklı kültürlerde işleme IOSMinOSVersion düzeltildi #10178
• Göz bakışı etkin nesnelerden fazladan ışın yayınları kaldırıldı #10162
• MixedRealityToolkit prefab #10180 için Düzenleyici Denetçisi'nde çeşitli profillerin üzerine gelindiğinde araç ipuçları eklendi
• EyeTrackingExample #10197 içindeki konuşma komutu açılan menüsü ve güncelleştirme komutları düzeltildi
• Unity'nin standart gölgelendiricisi #10209 ile yüklendiğinde siyah görünen 'gLTF' nesneleri düzeltildi
• Özellik false #10203 olduğunda IsEnabled kendini güncelleştirme düzeltildiUnityTouchDeviceManager
• Düğme yapılandırma yardımcısı #10221'de özellik adı güncelleştirildi
• Nesne dışarı aktarıcıda koordinat alanı, sargı sırası ve kültür biçimlendirmesi düzeltildi #10208
• Kavrama noktasını parmak ucuna taşıma seçeneği eklendi #10206
• Leap UnityModules 4.9.1 #10282 desteği eklendi
• #10280'eReserializeAssetsUtility.cs bazı küçük değişiklikler geri aktarıldı
• yanlış kullanımları enumValueIndex#10274'eintValue dönüştürüldü
• Yakın Düzenleme sırasında sürüklenen nesneler düzeltildi #10294
• Sınır denetiminin diğer bileşenleri agresif bir şekilde kaldırdığı durumlar düzeltildi #10296
• Titreyen Yakınlık aydınlatması #10325 düzeltildi
• Bu olayları tetiklemeye karar vermeden önce olaylara herhangi bir şeyin bağlanıp bağlanmadığını görmek için denetim eklendi #10330
• Küçük öğelerin çeşitli türleri değiştirildi #10316
• HasFlag #10319'a alternatif eklendi
• Çözücü hata ayıklama günlüğü istenmeyen postayı azaltma HandConstraint#10331
• #10326'danHandConstraintPalmUp.cs gelen günlük istenmeyen postaları düzeltildi
• OpenXR aracılığıyla Holografik Uzaktan İletişim için Sahne Anlama Etkinleştirildi #10338
• InteractableOnClickReceiver #10353 öğesine parametresiz oluşturucu eklendi
• FingerChaser prefab'ı Örnekler paketindeki Common klasörüne taşıdı #10358
• OpenXR üzerinde el seçimi için geri dönüş örneği eklendi #10359
• Windows Mikrofon Akışı tanıtımı UPM içeri aktarma sorunu düzeltildi #10362
• OpenXR profilleri yeniden adlandırıldı #10363
• Unity 2021 ile raycast isabet günlüğü çıkışı geliştirildi ve AssetBundles #10370 kullanılırken bir kilitlenme düzeltildi
• Dizeler, ayırıcıları azaltmak için sabit ve önbellek türüne güncelleştirildi #10369
• Uygulama tabanlı Holografik Uzaktan İletişim #10366 kullanılırken XRSDK tabanlı mesh gözlemcileri düzeltildi
• Tümleşik Oculus Görselleştirme #10067
• BoundsControl özellikleri için belgeler eklendi #10361
• El Ortak Chaser prefabrik #10377 düzeltildi
• Oculus Quest 10374 için dağıtım hataları düzeltildi
• Sahne Anlama örnek sahne profili #10368 ile ilgili sorun düzeltildi
• Unity 2021.2 #10182'nin en son sürümlerinde içeri aktarıldığında mrtk konsol hataları düzeltildi
• İmleçleri değiştirme hakkında eksik belgeler eklendi #4934
• MrTK Unity paketi sürüm sayfasında daha net hale getirmek için geliştirilmiş yönergeler #9575
• MicStream seçim tanıtım sahnesi ses (UPM paketi) #9908'i işlemediği sorun düzeltildi
• MrTK Örnekleri paketi #10216'da örneklerin tek tek içeri aktarılamadığı sorun düzeltildi
• Bazı özellikler için BoundsControl eksik belgeleri eklendi #10346
• InteractableOnClickReceiver'ın etkileşimli bileşene sahip bir oyun nesnesine eklenememesine neden olan bir hata düzeltildi #10341

2.7.2 sürümündeki yenilikler

UPM paketi bağımlılık sorunu düzeltildi

MRTK 2.7.1 UPM paketleriyle ilgili bağımlılıkların doğru ayarlanmamış olmasıyla ilgili bir sorun oluştu. Bu sorun, Karma Gerçeklik Özellik Aracı'nın MRTK 2.7.1 paketlerini düzgün içeri aktaramamasına neden olur. Sorun artık 2.7.2'de çözülür. Bu sürümde 2.7.1 ile karşılaştırıldığında kod değişikliği yoktur.

2.7.1 sürümündeki yenilikler

Sürümü göster

Karma Gerçeklik > Araç Seti menüsü artık proje tarafından kullanılan MRTK sürümünü belirlemek için Karma Gerçeklik Toolkit Foundation paketini inceleyen bir Sürümü göster... girdisini içerir.

Not

MRTK GitHub deposundan kopyalanırsa sürüm bilgileri ayarlanamaz.

Yazarlar listesi

MRTK 2.7.1'den başlayarak yazar listesi dosyası Karma Gerçeklik Toolkit Foundation paketine eklenir.

Configurator kurulum akışına tümleşik OpenXR projesi kurulumu

MRTK 2.7.1'den başlayarak, Karma Gerçeklik OpenXR eklentisi kullanıcıları bu eklentiyi MRTK ile ayarlama yönergelerini alır. HoloLens 2 hedefleyen kullanıcıların önerilen ayarları otomatik olarak uygulaması için bir seçenek vardır.

Önemli Hata Düzeltmeleri ve Değişiklikler

• XR SDK işlem hattı #9954, #9994'te desteklenen Unity Oyun Çubuğu Yöneticisi olarak işaretlendi
• Null hataları önlemek için etkileşimli denetçi koduna denetimler eklendi #9943
• Darbe gölgelendiricisi örnek sahnesine OpenXR mesh sağlayıcısı ekleme #9902
• El fiziği profilini örnek görünüme geri yükleme #9915
• Betikler HandConstraint için biraz temizleme #9935
• Profil oluşturma ve kopyalamayı etkileyen bazı hatalar düzeltildi #9982

2.7.0 sürümündeki yenilikler

OpenXR artık MRTK'da resmi olarak destekleniyor

Yeni OpenXR eklentileri daha olgun hale geldikçe MRTK artık OpenXR'yi resmi olarak destekliyor. Önceki sürümlerle karşılaştırıldığında, OpenXR kullanan projelere aşağıdaki özellikleri ekledik:

• Sistem tarafından sağlanan hareket denetleyicisi modeli desteği
• WinMR hareketleri desteği (seçme, bekleme, işleme ve gezinti) #9843
• Denetleyici haptics desteği
• HoloLens 2 üzerinde eklemli el örgü desteği
• HoloLens 2 #9567, #9827 üzerinde Uzamsal Eşleme desteği
• HoloLens 2 Üzerinde Scene Understanding Desteği #9744

OpenXR aracılığıyla HoloLens 2 veya Windows Mixed Reality kulaklıkları hedefliyorsanız, Karma Gerçeklik Özellik Aracı aracılığıyla OpenXR eklenti sürümü 0.9.5 veya sonraki Karma Gerçeklik yüklediğinizden/güncelleştirdiğinizden emin olun; aksi takdirde yukarıdaki iyileştirmelerden bazılarını kaçırabilirsiniz.

Eski XR ve XR SDK Veri Sağlayıcıları artık aynı profil içinde kullanılabilir

Veri sağlayıcıları da artık yalnızca uygun işlem hattı seçildiğinde yüklenerek hem Eski XR hem de XR SDK'sı veri sağlayıcılarının aynı profilde birlikte bulunmasına olanak sağlanır. Buna uyum sağlamak için Eski XR ve XR SDK Veri Sağlayıcıları artık profil görünümündeki farklı sekmeler altında düzenlenmiştir. Bu kuruluş, hedeflenen XR işlem hattı için doğru profilin seçilip seçilmediğini belirlemeye yardımcı olmalıdır.

Buna uyum sağlamak için null veri sağlayıcıları artık yüklenmeyecek ve profil denetçisinde görüntülenmeyecek. Kullanıcılar, eksik veri sağlayıcılarıyla beklenmeyen davranışlarda hata ayıklamak için Düzenle -> Proje Ayarları -> Karma Gerçeklik Araç Seti altında geçiş Show null data providers in the profile inspector yapabilir.

Deneyim Ayarları ve ilişkili Karma Gerçeklik Sahne İçeriği davranışı eklendi

Kullanıcılar artık MrTK'nin hedeflenen deneyime göre Karma Gerçeklik Sahne İçeriğini uygun şekilde görüntülemesini sağlayacak Deneyim Ayarları'nı yapılandırabilir.

Kullanıcının önceki Deneyim Ölçeği ayarları yeni Deneyim Ayarları Profili ile eşleşmiyorsa, Denetçi'de düzeltmesi istenir.

Yeniden Tasarlanan Yapılandırıcı artık kullanıcıya kurulum işleminde yol gösteriyor

Yeni MRTK Configurator, kullanıcılara projeyi XR geliştirme ve MRTK ile kullanmak üzere düzgün bir şekilde yapılandırmak için adım adım yönergeler sağlar. XR işlem hattı seçimini, platforma özgü eklentileri almayı, TextMeshPro'nun içeri aktarılmasını, örneklerin (UPM kullanırken) ve daha önce proje için önerilen diğer ayarların görüntülenmesini kapsar.

Mezun Teleport Etkin Noktası

Yeni bir ışınlanan etkin nokta bileşeni mezun edildi. Kullanıcının o konuma ışınlandığında belirli bir konumda ve yönlendirmede olduğundan emin olmak için cihazınıza bir ışınlama etkin noktası GameObject ekleyebilirsiniz.

Mezun Konut

Konut özelliği ve örneği artık deneyselden mezun oldu. Örnek görünüme yeni volumetrik HoloLens 2 stili düğmeleri örnekleri eklenmiştir.

Leap Motion Unity Modülleri sürüm 4.6.0, 4.7.0, 4.7.1 ve 4.8.0 için destek eklendi

Artık Motion Unity Modüllerinin en son sürümleri için destek artık MRTK 2.7.0 ile uyumludur. Daha fazla bilgi için bkz. Artık Hareket için MRTK'yi Yapılandırma.

Yeni LeapMotionOrientationExample sahneye katkıda bulunmak için @jackyangzzh çok teşekkürler!

Tetiklenen hedeflenen konuşma olayları artık bakış işaretçileriyle sınırlı değil

Daha önce, hedeflenen konuşma olayları yalnızca bakış işaretçisiyle odaklanmış nesneler üzerinde tetiklenebiliyordu. Artık nesneler herhangi bir işaretçiye odaklanmışsa konuşma olaylarını alabilir.

TextToSpeech HTK'den MRTK'ye taşıma

Sevgili TextToSpeech betik artık kullanarak UWP platformundaki SpeechSynthesizermetinden konuşma oluşturmanıza yardımcı olmak için MRTK'de kullanıma sunuldu. Ayrıca, özelliği göstermek için örnek bir sahne eklendi.

OpenXR'de sistem tarafından sağlanan hareket denetleyicisi modeli desteği

OpenXR'de sistem tarafından sağlanan hareket denetleyicisi modeli için hem düzenleyicide hem de çalışma zamanında destek eklendi.

OpenXR'de HoloLens 2 zikirli el örgü desteği

Eski WMR, Windows XR Eklentisi ve OpenXR genelinde denetleyici haptics desteği

Eski WMR, Windows XR Eklentisi ve OpenXR'de denetleyici haptics desteği eklendi. #9735

Windows XR Eklentisinde göz izleme desteği

Windows XR Eklentisi en düşük 2.7.0 (Unity 2019), 4.4.2 (Unity 2020) ve 5.2.2 (Unity 2021) sürümleri kullanılırken göz bakışı desteği eklendi. #9609

Önemli Hata Düzeltmeleri ve Değişiklikler

• Sıkıştırma algılama daha sorunsuz hale getirildi. Şimdi sıkıştırma hareketini yanlışlıkla bırakmak daha zor. #9576
• Object Manipulator bileşenine sahip nesneler artık bayrak ayarlandığında yayında tutarlı bir şekilde hızı korur. #9733
• Arka arkaya sapma artık zemini denetler ve kameranın ortama kırpabileceği veya kullanıcının boş alanın üzerine geldiği durumları önlemeye yardımcı olur. #9697
• IsNearObject artık küreyi veya dürtme işaretçisini genişletirken daha fazla esneklik sağlayan bir sanal özelliktir. #9803
• Düğmeler artık kullanılabilir konuşma komutunu gösterirken uygun anahtar sözcüğü görüntüler. #9824
• Oculus Denetleyicileri artık kendi tek başına görselleştiricilerini kullanarak MRTK görselleştirmesinin Oculus Tümleştirme Paketi'nin görselleştirmesiyle çakışmasını önlüyor. #9589
• Klavyeyle ilgili betikler, en son Unity sürümlerindeki davranışla uyumlu olacak şekilde değiştirildi (2019.4.25+ & 2020.3.2+). Yayından itibaren, HoloLens'i etkileyen bir otomatik tamamlama hatası ve TMP Giriş Alanı hatası (her ikisi de MRTK dışındadır) vardır. Daha fazla bilgi için bkz. #9056 ve #9724.
• Kaydırma Nesnesi Koleksiyonu'nun performansı iyileştirildi. Ayrıca koleksiyon içinde çoğaltıldığında malzemenin kaybolmasına neden olan GameObject bir sorun düzeltildi. #9813, #9718
• Scene Understanding tanıtım betiğinde, belirli bir türdeki GetSceneObjectsOfType tüm gözlemlenen sahne nesnesini almak için işlevini ekledik. #9524, #9744
• Komut satırı derleme aracında, derlemeye yalnızca veya sceneListFile bayrakları tarafından sceneList belirtilen sahneler (herhangi bir bayrak mevcut olduğunda) eklenir. #9695
• Derleme aracında, yolunu belirtmek ve bunu kullanmak yerine paket geri yükleme gerçekleştirmek için kullanmak msbuild için yeni bir nuget.exe seçenek vardır (varsayılan seçenek). #9556
• Windows XR Eklentisi'nin kullanılmasının eski el eklemlerine ve iki kat el örgülerine neden olması sorunu düzeltildi. #9890
• Windows XR Eklentisi'nin otomatik uzaktan iletişim özelliğinin kullanılmasıyla girişlerin ve etkileşimlerin eksik olmasına neden olan sorun düzeltildi. #9868
• dosyasının BuildDeployWindow Windows SDK yolu için geçersiz bir reg anahtarını sorgulamaya çalışması sorunu düzeltildi. #9664
• MRTK'nin glTF içeri aktarıcıları artık isteğe bağlıdır. Birden çok glTF içeri aktarıcı varsa, özel betik tanımlama simgelerine eklenerek MRTK_GLTF_IMPORTER_OFF MRTK'lar devre dışı bırakılabilir. #9658
• OpenVR üzerindeki Knuckles denetleyicilerinin düzgün algılanmaması sorunu düzeltildi. #9881
• El örgüsünün görselleştirilmesi sırasında çerçeve başına ayırma sayısını azaltın #9756
• Örnekleri içeri aktarmayı kolaylaştırmak için MRTK Örnekleri paketini (Unity Paket Yöneticisi'nde) başlatmak için bir menü öğesi eklendi #9798
• Unity 2020.3 kullanılırken yük süresi uyarılarının sayısı azaltıldı.
• Derleme Penceresi özellik belgeleri eklendi: Sayfayı ziyaret edin

Bilinen Sorunlar

Ses tanıtımlarında dosya asmdef eksik (UPM paketi)

MRTK Karma Gerçeklik Özellik Aracı aracılığıyla içeri aktarıldığında, Örnekler ve tanıtımlar Unity Paket Yöneticisi kullanıcı arabirimi kullanılarak projeye eklenir. Ses tanıtımları içeri aktarıldıktan sonra sahne WindowsMicrophoneStreamDemo.unity düzgün davranmaz. Bu davranış, örnek için eksik bir asmdef dosyasının sonucudur.

Bu sorunu geçici olarak çözmek için aşağıdaki adımları uygulayın:

• Kitaplık/PackageCache/com.microsoft.mixedreality.toolkit.examples@ Kopyala[...] /MRTK. Samples.asmdef dosyasını "Assets/Samples/Karma Gerçeklik Toolkit Examples" klasörünüzde belirleyin
• Kopyalanan dosyayı Örnekler olarak yeniden adlandırın
• Örnekler dosyasını açma
• Ad kutusunda içeriği Örnekler ile değiştirin
• Uygula'ya tıklayın
• Oluşturma ve dağıtma

Bu sorun, gelecek MRTK sürümünde düzeltilecektir.

MRTK derleme penceresi Unity 2020.3'te süresiz "Varlıkları içeri aktarma" iletişim kutusunu tetikler

Unity 2020.3'te MRTK derleme penceresinde bir UWP derlemesi sonrasında "Varlıkları içeri aktarma" iletişim kutusunun tamamlanmamasıyla ilgili bilinen bir sorun vardır. Bu sorun Unity ile araştırılmaktadır.

Unity 2020'de Text Mesh Pro Tuval oluşturucu uyarıları

Unity 2020 kullanılırken MRTK örnek sahnelerinin çoğunda aşağıdaki uyarı günlüğe kaydedilir:

Please remove the `CanvasRenderer` component from the [TextMeshPro] GameObject as this component is no longer necessary.

Tuval oluşturucu uyarısı TextMeshPro sürüm 3.0.3'e eklendi. Bu uyarıların MRTK'nin örnek sahneleri üzerinde bir etkisi yoktur ve konsoldan temizlenebilir. Diğer ayrıntılar için bkz . Sorun 9811.