Microsoft Karma Gerçeklik Araç Seti 2.6 Sürüm Notları

Önemli

ARM64 kullanılarak Microsoft HoloLens 2 için oluşturulan uygulamaları etkileyen bilinen bir derleyici sorunu vardır. Bu sorun, Visual Studio 2019'un 16.8 veya sonraki bir sürümüne güncelleştirilmesiyle düzeltilmiştir. Visual Studio'yu güncelleştiremiyorsanız geçici bir çözüm uygulamak için lütfen paketi içeri aktarın com.microsoft.mixedreality.toolkit.tools .

2.6.2 sürümündeki yenilikler

Uzamsal ağın ebeveynlik işlemini düzeltir

Karma Gerçeklik Playspace nesnesi taşındıktan sonra uzamsal çizgilerin düzgün bir şekilde konumlandırılmaması sorununu düzeltir (örneğin: bir ışın aracılığıyla).

2.6.1 sürümündeki yenilikler

HoloLens 2 / UWP üzerinde OpenXR'nin çalışmaması düzeltmeleri

MRTK'nın OpenXR desteğinin UWP üzerinde çalışmasını engelleyen bir regresyonu düzeltir.

Artık Hareket ObjectManipulator'ın dönmemesini düzeltir

Artık Hareket elinin döndürmesinin ObjectManipulator betiği tarafından dikkate alınmadığı bir regresyonu düzeltir.

Örnek sahne güncelleştirmeleri

Unity eklentisinin sevk durumunu doğru yansıtacak şekilde örnek sahneyi anlamayı Güncelleştirmeler. Ayrıca, içeri aktarılan uzamsal farkındalık örnek sahnesine artık bağımlı olmayacak şekilde örneği güncelleştirir. 2.6.1'e güncelleştirmeden önce, olası çakışmaları önlemek için projenizde varsa içeri aktarılan sahne anlama ve uzamsal farkındalık örneklerini silmeniz gerekir. Bu örnekleri kaldırmadıysanız ve konsoldaki örneklerle ilgili çakışmalar görüyorsanız, lütfen her iki örneği de (veya klasörü) kaldırın ve içeri aktarmayı Assets/Samples/Mixed Reality Toolkit Examples yeniden deneyin.

Geçerli iletişim kutusu senaryolarını doğru şekilde açıklamak için iletişim kutusu örnek sahnesini Güncelleştirmeler.

2.6.0 sürümündeki yenilikler


OpenXR desteği ekleme

Unity'nin OpenXR önizleme paketi ve Microsoft'un Karma Gerçeklik OpenXR paketi için ilk destek eklendi. Daha fazla bilgi için MRTK/XRSDK kullanmaya başlama sayfasına, Unity'nin forum gönderisine veya Microsoft belgelerine bakın .

Önemli

Unity'de OpenXR yalnızca Unity 2020.2 ve üzeri sürümlerde desteklenir.

Şu anda yalnızca x64 ve ARM64 derlemelerini de desteklemektedir.

Varlık değiştirme yardımcı programı

Unity sahnesindeki birden çok varlığı yeni Varlık Değiştirme yardımcı programıyla değiştirin.

HP Hareket Denetleyicileri artık MRTK ile destekleniyor

HP Reverb G2 denetleyicileri artık MRTK ile yerel olarak çalışıyor.

Deneysel Etkileşimli Öğe + Durum Görselleştiricisi

Interactive Element, MRTK giriş sistemine basitleştirilmiş bir merkezi giriş noktasıdır. Durum yönetimi yöntemlerini, olay yönetimini ve Çekirdek Etkileşim Durumları için durum ayarı mantığını içerir. Daha fazla bilgi için etkileşimli öğe belgelerine bakın.

InteractiveElementAddCoreState

Durum Görselleştiricisi, Etkileşimli Öğeye bağımlı olan bir animasyon bileşenidir. Bu bileşen Animasyon Klipleri oluşturur, ana kareleri ayarlar ve bir Animator Durum Makinesi oluşturur. Daha fazla bilgi için bkz . Durum Görselleştiricisi Belgeleri

StateVisualizerColorChangeOnFocus

ışınlanma hareketiyle ışınlanma artık tüm platformlarda destekleniyor

Kullanıcılar artık tüm platformlarda oyun alanları arasında gezinmek için ışınlama hareketini kullanabilir. Varsayılan yapılandırmaları olan MR cihazlarında bir denetleyiciyle ışın yapmak için kontrol çubuğunu kullanın. Eklemli ellerle ışınlanma yapmak için, avuç içinizin dizinle yukarı dönük ve başparmak dışa doğru hareket ederek işaret parmağınızı kıvırarak ışınlanmayı tamamlayan bir hareket yapın. Giriş simülasyonu ile ışınlandırmak için lütfen güncelleştirilmiş Giriş Benzetimi Hizmeti belgelerimize bakın.

ışın hareketi

Scene Understanding artık deneysel bir uzamsal farkındalık gözlemcisi olarak MRTK'de kullanılabilir

MrTK 2.6'da Scene Understanding'in deneysel desteği sunulmuştur. Kullanıcılar, mrtk tabanlı projelerde uzamsal farkındalık gözlemcisi olarak HoloLens 2 sahne anlama özelliklerini birleştirebilir. Daha fazla bilgi için lütfen Scene Understanding belgelerini okuyun.

Önemli

Scene Understanding yalnızca HoloLens 2 ve Unity 2019.4 ve üzeri sürümlerde desteklenir.

Bu özellik, artık Karma Gerçeklik Özellik Aracı aracılığıyla kullanılabilen Scene Understanding paketini gerektirir. Karma Gerçeklik Özellik Aracı'nı kullanırken veya UPM aracılığıyla başka bir şekilde içeri aktarırken, bir bağımlılık sorunu nedeniyle Deneysel - SahneKlasör Anlama örneğini içeri aktarmadan önce lütfen Tanıtımlar - SpatialAwareness örneğini içeri aktarın. Daha fazla bilgi için lütfen bu GitHub sorununa bakın.

SahneYi Anlama

Çalışma zamanı profili değiştirme desteği

MRTK artık hem MRTK örneğinin başlatılmasından önce (mrtk başlatma profil anahtarı) hem de bir profil etkin kullanımda olduktan sonra (örn. Etkin profil anahtarı) profil değiştirmesine izin verir. Eski anahtar, donanımın özelliklerine göre belirli bileşenleri etkinleştirmek için kullanılabilirken, ikincisi kullanıcı uygulamanın bir alt bölümüne girerken deneyimi değiştirmek için kullanılabilir. Daha fazla bilgi ve kod örnekleri için profil değiştirme ile ilgili belgeleri okuyun.

Yön göstergesi ve deneyselden mezun olan çözücüleri takip edin

İki yeni çözücü, ana hat MRTK ile kullanıma hazırdır.

Yön Göstergesi Çözücü

El Koçu deneysel mezun oldu

El Koçu özelliği artık ana hat MRTK ile kullanıma hazırdır.

El Koçu Örneği

Deneyselden mezun olan iletişim kutusu denetimleri

İletişim kutusu denetimleri artık ana hat MRTK ile kullanıma hazırdır.

İletişim Kutusu Denetimleri

Pulse gölgelendiricisi deneyselden mezun oldu

Pulse gölgelendirici betikleri deneyselden mezun oldu. Daha fazla bilgi için bkz. Pulse Shader Belgeleri

MRTK_SpatialMesh_Pulse

Giriş Kayıt Hizmeti geliştirmeleri

InputRecordingService ve InputPlaybackService artık göz bakışı girişlerini kaydedip oynatabilir. Kayıt süresi boyunca tutarlı bir kare hızı sağlamak için iyileştirildiğinden, kayıt dosyası boyutu ve tasarruf süresi de yaklaşık %50 azaltılır. Kayıt dosyalarını kaydetme ve yükleme işlemi artık zaman uyumsuz olarak gerçekleştirilebilir. Bu MRTK sürümünde kaydın dosya biçiminin değiştiğini unutmayın. Yeni sürüm 1.1 belirtimleri hakkında daha fazla bilgi için lütfen buraya bakın.

Okuma modu

HoloLens 2'da okuma modu desteği eklendi. Okuma modu sistemin görüş alanını azaltır ancak Unity'nin çıkışının ölçeklendirilmesini ortadan kaldırır. Unity tarafından işlenen piksel, HoloLens 2 üzerinde öngörülen bir piksele karşılık gelir. Uygulama yazarları, bunun kendi uygulamalarında istedikleri avantaj olduğundan emin olmak için birden çok kişiyle test yapmalıdır.

okuma modunu Windows Mixed Reality

UWP'de 3B uygulama başlatıcı desteği

UWP için 3B uygulama başlatıcı ayarlama özelliğini ekler. Bu ayar hem MRTK Derleme Penceresi'nde hem de MRTK Proje Ayarları'nda, Derleme Ayarları'nın altında gösterilir. Unity'de derleme sırasında projeye otomatik olarak yazılır.

Derleme ayarları

Yeni değişiklikler

İçeri aktarılan GLTF nesnelerinin belirli alanları artık büyük harfle yazılıyor

Seri durumdan çıkarmayla ilgili sorunlar nedeniyle, içeri aktarılan GLTF nesnelerinin bazı alanları artık büyük harflerle başlıyor. Etkilenen alanlar şunlardır (yeni adlarında): ComponentType, Path, Interpolation, , Target, Type, , Mode, MagFilterMinFilter, , WrapS, . WrapT

Giriş animasyonu ikili dosyası güncelleştirilmiş sürüm 1.1 biçimine sahip

ve InputPlaybackServicetarafından InputRecordingService kullanılan giriş animasyonu ikili dosyası artık bu iki hizmette yapılan iyileştirmeleri etkinleştirmek için güncelleştirilmiş bir dosya biçimine sahiptir. Yeni sürüm 1.1 belirtimleri hakkında daha fazla bilgi için lütfen buraya bakın.

Unity için MSBuild desteği

Unity'nin yeni paket kılavuzuyla uyumlu olması için Unity için MSBuild desteği 2.5.2 sürümünden itibaren kaldırılmıştır.

Bilinen sorunlar

OpenXR

Şu anda Holographic Remoting ve OpenXR ile ilgili bilinen bir sorun vardır ve burada el eklemleri tutarlı bir şekilde kullanılamaz. Buna ek olarak, göz izleme örnek sahneleri şu anda uyumlu değildir, ancak göz izleme işe yaramaz .

Bazı Karma Gerçeklik Toolkit Standart Gölgelendirici özellikleri için Foundation paketi gerekir

Unity Paket Yöneticisi aracılığıyla içeri aktarıldığında, MRTK Standart Gölgelendirici yardımcı programları betikleri (örn. HoverLight.cs) Standart Varlıklar paketindeki gölgelendiriciyle birlikte konumlandırılmaz. Bu işleve erişmek için uygulamalar, Foundation paketinin içeri aktarılmasını gerektirir.

CameraCache kapatılmada yeni bir kamera oluşturabilir

Bazı durumlarda (örneğin Unity Düzenleyicisi'nde LeapMotion sağlayıcısı kullanılırken), CameraCache'in kapatma sırasında MainCamera'yi yeniden oluşturması mümkündür. Daha fazla bilgi için lütfen bu soruna bakın.

Örnekler Unity Paket Yöneticisi aracılığıyla içeri aktarıldığında FileNotFoundException

Proje yolunun uzunluğuna bağlı olarak, Unity Paket Yöneticisi aracılığıyla örnekleri içeri aktarmak Unity Konsolunda FileNotFoundException iletileri oluşturabilir. Bunun nedeni, "eksik" dosyanın MAX_PATH (256 karakter) uzun olmasının yoludur. Sorunu çözmek için lütfen proje yolunun uzunluğunu kısaltın.

Uzamsallaştırıcı belirtilmedi. Uygulama Uzamsal Ses'i desteklemez

Ses uzamsallaştırıcı yapılandırılmamışsa "Uzamsallaştırıcı belirtilmedi" uyarısı görüntülenir. Unity bu paketlerde uzamsallaştırıcılar içerdiği için XR paketi yüklü değilse bu durum oluşabilir.

Sorunu çözmek için lütfen aşağıdakilere dikkat edin:

  • Pencere>Paket Yöneticisi'nin yüklü bir veya daha fazla XR paketi var

  • Karma Gerçeklik Araç Seti>Yardımcı Programları>Unity Projesini Yapılandırır ve Ses Uzamsallaştırıcı için bir seçim yapar

    Ses Uzamsallaştırıcı'ya tıklayın

NullReferenceException: Nesne başvurusu bir nesnenin örneğine ayarlanmadı (SceneTransitionService.Initialize)

Bazı durumlarda, açmak EyeTrackingDemo-00-RootScene SceneTransitionService sınıfının Initialize yönteminde NullReferenceException'a neden olabilir. Bu hata, Sahne Geçiş Hizmeti'nin yapılandırma profilinin ayarlanmamış olmasından kaynaklanır. Sorunu çözmek için lütfen aşağıdaki adımları kullanın:

  • Hiyerarşideki MixedRealityToolkit nesneye gitme
  • Denetçi penceresinde Extensions
  • Genişletilmediyse, Scene Transition Service
  • değerini Configuration ProfileMRTKExamplesHubSceneTransitionServiceProfile olarak ayarlayın

Sahne Geçiş Profilini Düzeltme

Oculus Görevi

Şu anda Tek başına platformları hedeflerken ile Oculus XR eklentisini kullanmaya yönelik bilinen bir sorun vardır. Güncelleştirmeler için Oculus hata izleyicisine/forumlarına/sürüm notlarına bakın.

Hata, şu 3 hata kümesiyle işaret edilir:

Oculus XR Eklentisi Hatası

UnityUI ve TextMeshPro

TextMeshPro'nun daha yeni sürümleri (1.5.0+ veya 2.1.1+) için bilinen bir sorun vardır ve burada açılan liste ve kalın yazı tipi karakter aralığı için varsayılan yazı tipi boyutu değiştirilmiştir.

TMP resmi

Bu, TextMeshPro'nun önceki bir sürümüne düşürülerek geçici bir çözüm olabilir. Daha fazla ayrıntı için sorun #8556'ya bakın.