Catatan Rilis Microsoft Mixed Reality Toolkit 2.7

  • Artikel

Yang baru di 2.7.3

Terima kasih khusus dari Redmond

Tim MRTK ingin memperluas kehangatan terima kasih kepada Anda, komunitas MRTK. Kontribusi, umpan balik, dan suara Anda telah membantu MRTK memenangkan Auggie Award 2021 untuk Alat Pengembang Terbaik! Tanpa dukungan Anda, kami tidak akan berada di tempat kami hari ini. Baik menambahkan dukungan platform baru, fitur baru, perbaikan bug, saran, pertanyaan, atau berbagai cara lain yang mungkin telah Anda kontribusikan: Terima kasih!

Alat Pengembang Terbaik Auggie Awards 2021

Dukungan Unity 2021

Kami telah mempermudah pembangunan Unity 2021 dengan rilis 2.7.3! Jika Anda menemukan masalah saat menggunakan MRTK dengan Unity 2021, ajukan masalah di repositori GitHub kami.

Pemahaman Adegan melalui dukungan Jarak Jauh (Hanya OpenXR)

Scene Understanding sekarang tersedia selama remoting pada HoloLens 2 dengan platform OpenXR.

MRTK 2.7.3 Bugfixes dan Perubahan

  • Menghentikan pembuatan CustomProfiles folder kecuali profil telah dikloning ke folder tersebut #9916
  • Menghapus panggilan ke .gameObject di GameObjects #9939
  • Memperbaiki bug di mana objek dengan komponen yang dinonaktifkan dapat menyebabkan pointer menjadi fokus terkunci #9945
  • Memperbarui metode yang tidak digunakan lagi dan kesalahan pengkompilasi tetap untuk Unity 2021 #9938
  • Diperbaiki link.xml untuk Unity 2021 #9942
  • Pemeriksa konfigurasi tombol yang diperbarui untuk menampilkan nama ikon #9972
  • Header dan perataan daftar pemetaan pengontrol yang diperbarui #9976
  • Berbagai peningkatan Unity untuk MRTK #9940
  • Memperbaiki masalah BoundsControl collider dan inkonsistensi #9973
  • Memperbaiki pemeriksa set ikon tombol #9999
  • Fixed BoundsControl scale handle collider alignment #10007
  • Memperbaiki tekstur font SDF mengategorikan #10006
  • Memperbaiki BoundsControl auto-flatten dan orientasi handel skala #10013
  • Menambahkan umpan balik untuk perbaikan perataan BoundsControl#10016
  • Memperbaiki deformasi aneh dengan jala tangan selama pemutaran animasi #10024
  • Memperbaiki pengelogan dan SpatialAwarenessSurfaceTypes untuk Scene Understanding #10026
  • Menambahkan direktif definisi Mandiri ke contoh Leap skrip adegan #10036
  • Memperbaiki masalah BoundsControlOnEnable ketika jenis aktivasi non-default yang ditentukan dalam editor #10039
  • Memperbaiki kesalahan bytecode shader yang tidak valid untuk OpenGL ES dan Metal #10041
  • Menambahkan ClearProgressBar panggilan untuk memperbaiki Build Window freeze pada Unity 2020 #10046
  • Serialisasi yang diperbarui untuk aset font #10047
  • Memperbaiki adegan interaksi tangan untuk memiliki tabrakan slider mencubit yang tepat #10060
  • Fixed Surface Magnetism quaternion matematika #10074
  • Pesan versi kamera PV yang disempurnakan #10077
  • Tingkat perlindungan tetap BoundingBoxHelper.GetRawBoundsCorners#10093
  • Memperbarui log impor gLTF menjadi satu log alih-alih beberapa #10090
  • MRSceneContent Menghapus skrip dari adegan yang tidak memiliki MRTK di dalamnya #10091
  • Menghapus sistem peristiwa berbasis paket dari contoh adegan untuk kompatibilitas Unity 2018 #10092
  • Menghapus dukungan untuk pratinjau paket Microsoft OpenXR #10119
  • Memperbaiki pembekuan aplikasi saat menerima data #10033
  • Memperbaiki EyeTrackingTarget tidak memicu OnLookAway saat meneruskan dari collider dengan EyeTrackingTarget ke collider tanpa #10127
  • Mengubah tingkat penunjuk default untuk membuat perilaku penunjuk mouse lebih intuitif #10075
  • Ringkasan yang diperbarui untuk mengklarifikasi saat Inisialisasi berjalan #10177
  • Memperbaiki NullReferenceException masalah di LinePointer#10190
  • Memperbaiki BoundsControl dengan masalah skala non-seragam #10133
  • Penanganan IOSMinOSVersion tetap dalam budaya yang berbeda #10178
  • Menghapus raycast tambahan dari objek yang diaktifkan tatapan mata #10162
  • Menambahkan tipsalat saat mengarahkan kursor ke berbagai profil di Pemeriksa Editor untuk prefab MixedRealityToolkit #10180
  • Memperbaiki perintah ucapan dropdown dan memperbarui perintah di EyeTrackingExample #10197
  • Memperbaiki objek 'gLTF' yang tampak hitam ketika dimuat dengan shader standar Unity #10209
  • MemperbaikiUnityTouchDeviceManager pembaruan dirinya sendiri ketika IsEnabled properti false #10203
  • Memperbarui nama properti di pembantu konfigurasi tombol #10221
  • Memperbaiki ruang koordinat, urutan berliku, dan pemformatan budaya dalam pengekspor objek #10208
  • Menambahkan opsi untuk memindahkan titik genggaman ke ujung jari #10206
  • Menambahkan dukungan untuk Leap UnityModules 4.9.1 #10282
  • Mendukung beberapa perubahan kecil pada ReserializeAssetsUtility.cs#10280
  • Mengonversi penggunaan yang salah menjadi enumValueIndexintValue#10274
  • Objek tetap menyimpang selama Manipulasi Dekat #10294
  • Memperbaiki kasus di mana kontrol terikat akan secara agresif menghapus komponen lain #10296
  • Memperbaiki pencahayaan Kedekatan berkedot #10325
  • Menambahkan pemeriksaan untuk melihat apakah ada yang terkait dengan peristiwa sebelum menentukan untuk menembakkan peristiwa tersebut #10330
  • Mengubah berbagai macam hal kecil #10316
  • Memperkenalkan alternatif untuk HasFlag #10319
  • Mengurangi HandConstraint spam log debug pemecah #10331
  • Memperbaiki spam log yang berasal dari HandConstraintPalmUp.cs#10326
  • Mengaktifkan Pemahaman Adegan untuk Akses Jauh Holografik melalui OpenXR #10338
  • Menambahkan konstruktor tanpa parameter ke InteractableOnClickReceiver #10353
  • Memindahkan prefab FingerChaser ke folder Umum dalam paket Contoh #10358
  • Menambahkan kasus fallback untuk pilih tangan artikulasi pada OpenXR #10359
  • Memperbaiki masalah impor UPM demo Windows Mic Stream #10362
  • Mengganti nama profil OpenXR #10363
  • Meningkatkan output log hit raycast dengan Unity 2021 dan memperbaiki crash saat menggunakan AssetBundles #10370
  • String yang diperbarui ke const dan jenis cache untuk mengurangi alokasi #10369
  • Memperbaiki pengamat jala berbasis XRSDK saat menggunakan Akses Jauh Holografik berbasis aplikasi #10366
  • Visualisasi Oculus Terintegrasi #10067
  • Menambahkan dokumentasi untuk properti BoundsControl#10361
  • Prefab Hand Joint Chaser tetap #10377
  • Memperbaiki kesalahan penyebaran untuk Oculus Quest 10374
  • Memperbaiki masalah dengan contoh scene understanding profil adegan #10368
  • Memperbaiki kesalahan konsol MRTK saat diimpor dalam versi terbaru Unity 2021.2 #10182
  • Menambahkan dokumentasi yang hilang tentang cara mengubah kursor #4934
  • Instruksi yang disempurnakan pada halaman rilis paket MRTK Unity untuk membuatnya lebih jelas #9575
  • Memperbaiki masalah di mana adegan demo pemilihan MicStream tidak memproses suara (paket UPM) #9908
  • Memperbaiki masalah di mana sampel tidak dapat diimpor secara individual dalam paket Contoh MRTK #10216
  • Menambahkan dokumentasi BoundsControl missing untuk beberapa properti #10346
  • Memperbaiki bug di mana InteractableOnClickReceiver tidak dapat ditambahkan ke objek game dengan komponen yang dapat berinteraksi #10341

Yang baru di 2.7.2

Memperbaiki masalah dependensi paket UPM

Ada masalah dengan paket UPM MRTK 2.7.1 di mana dependensi tidak disiapkan dengan benar. Masalah ini menyebabkan Mixed Reality Feature Tool gagal mengimpor paket MRTK 2.7.1 dengan benar. Masalah ini sekarang diselesaikan di 2.7.2. Tidak ada perubahan kode dalam versi ini dibandingkan dengan 2.7.1.

Apa yang baru di 2.7.1

Tampilkan versi

Menu Mixed Reality > Toolkit sekarang berisi versi Show... entri yang memeriksa paket Mixed Reality Toolkit Foundation untuk menentukan versi MRTK yang sedang digunakan oleh proyek.

Tampilkan menu versi

Dialog versi MRTK

Catatan

Jika MRTK dikloning dari repositori GitHub, informasi versi tidak akan diatur.

Tidak dapat menentukan versi

Daftar penulis

Dimulai dengan MRTK 2.7.1, file daftar penulis disertakan dalam paket Mixed Reality Toolkit Foundation.

Penyiapan proyek OpenXR terintegrasi ke dalam alur penyiapan Configurator

Dimulai dengan MRTK 2.7.1, pengguna plugin Mixed Reality OpenXR akan menerima instruksi tentang cara mengatur plugin tersebut dengan MRTK. Ada opsi bagi pengguna yang menargetkan HoloLens 2 untuk menerapkan pengaturan yang direkomendasikan secara otomatis.

Jendela Configurator dengan instruksi penyiapan OpenXR

Bugfixes dan Perubahan penting

  • Menandai Unity Joystick Manager sebagai didukung pada alur XR SDK #9954, #9994
  • Menambahkan pemeriksaan ke kode inspektur yang dapat berinteraksi untuk mencegah kesalahan null #9943
  • Tambahkan penyedia jala OpenXR ke contoh adegan shader pulse #9902
  • Pulihkan profil fisika tangan ke contoh adegan #9915
  • Beberapa pembersihan ke HandConstraint skrip #9935
  • Memperbaiki beberapa bug yang memengaruhi pembuatan dan kloning profil #9982

Apa yang baru di 2.7.0

OpenXR sekarang secara resmi didukung di MRTK

Karena plugin OpenXR baru menjadi lebih matang, MRTK sekarang secara resmi mendukung OpenXR. Dibandingkan dengan rilis sebelumnya, kami menambahkan kemampuan berikut ke proyek menggunakan OpenXR:

Jika Anda menargetkan headset HoloLens 2 atau Windows Mixed Reality melalui OpenXR, pastikan untuk menginstal/memperbarui ke plugin OpenXR Mixed Reality versi 0.9.5 atau yang lebih baru melalui Alat Fitur Mixed Reality, jika tidak, Anda mungkin melewatkan beberapa peningkatan di atas.

Penyedia Data XR dan XR SDK warisan sekarang dapat digunakan dalam profil yang sama

Penyedia data sekarang juga hanya akan dimuat ketika alur yang sesuai dipilih, memungkinkan penyedia data Legacy XR dan XR SDK untuk berdampingan dalam profil yang sama. Untuk mengakomodasi hal ini, Penyedia Data Legacy XR dan XR SDK sekarang diatur di bawah tab yang berbeda dalam tampilan profil. Organisasi ini akan membantu menentukan apakah profil yang benar dipilih untuk alur XR yang ditargetkan.

Penyedia data Warisan dan XR SDK sekarang dapat disatukan dalam satu profil

Untuk mengakomodasi hal ini, penyedia data null sekarang tidak akan lagi dimuat dan ditampilkan di pemeriksa profil. Pengguna dapat beralih Show null data providers in the profile inspector di bawah Edit -> Pengaturan Proyek -> Mixed Reality Toolkit untuk men-debug perilaku tak terduga dengan penyedia data yang hilang.

Penyedia data null sekarang disembunyikan secara defaultToggle memperlihatkan penyedia data null di pemeriksa profil

Menambahkan Pengaturan Pengalaman dan perilaku Konten Adegan Mixed Reality terkait

Pengguna sekarang dapat mengonfigurasi Pengaturan Pengalaman, yang akan memungkinkan MRTK menampilkan konten adegan Mixed Reality dengan tepat berdasarkan pengalaman yang ditargetkan.

Jika pengaturan Skala Pengalaman pengguna sebelumnya tidak cocok dengan Profil Pengaturan Pengalaman baru, mereka akan diminta untuk memperbaikinya di Pemeriksa.

Migrasi Skala Pengalaman

Konfigurasi yang Didesain Ulang sekarang memandu pengguna melalui proses penyiapan

Konfigurator MRTK baru memberi pengguna panduan langkah demi langkah untuk mengonfigurasi proyek dengan benar untuk pengembangan dan penggunaan XR dengan MRTK. Ini mencakup pemilihan alur XR, mendapatkan plugin khusus platform, mengimpor TextMeshPro, menampilkan contoh (saat menggunakan UPM), dan pengaturan lain yang direkomendasikan yang disertakan sebelumnya untuk proyek.

Configurator memperlihatkan daftar alur

Hotspot Teleport Lulusan

Komponen hotspot teleport baru telah diluluskan. Anda dapat menambahkan hotspot teleport ke Anda GameObject untuk memastikan bahwa pengguna berada dalam posisi dan orientasi tertentu saat mereka melakukan teleportasi ke lokasi tersebut.

Contoh Hotspot Teleport

Tempat Tinggal Lulusan

Fitur dan contoh tinggal sekarang lulus dari eksperimental. Contoh baru tombol gaya HoloLens 2 volumetrik disertakan dalam adegan sampel.

Pahlawan tinggal

Menambahkan dukungan untuk Modul Leap Motion Unity versi 4.6.0, 4.7.0, 4.7.1 dan 4.8.0

Dukungan untuk versi terbaru Modul Leap Motion Unity sekarang kompatibel dengan MRTK 2.7.0. Untuk informasi selengkapnya, lihat Cara Mengonfigurasi MRTK untuk Leap Motion.

Banyak terima kasih untuk @jackyangzzh berkontribusi adegan baru LeapMotionOrientationExample !

Peristiwa ucapan yang ditargetkan yang diangkat tidak lagi dibatasi untuk menatap penunjuk

Sebelumnya, peristiwa ucapan yang ditargetkan hanya dapat dinaikkan pada objek yang difokuskan dengan penunjuk tatapan. Sekarang, objek dapat menerima peristiwa ucapan jika difokuskan oleh penunjuk apa pun.

Peristiwa Ucapan dengan Penunjuk Jauh

Port dari TextToSpeech HTK ke MRTK

Skrip tercinta TextToSpeech sekarang akhirnya tersedia di MRTK untuk membantu Anda menghasilkan ucapan dari teks di platform UWP menggunakan SpeechSynthesizer. Juga menambahkan adegan sampel untuk menunjukkan fitur.

Dukungan untuk model pengontrol gerakan yang disediakan sistem pada OpenXR

Menambahkan dukungan, baik dalam editor maupun saat runtime, untuk model pengontrol gerakan yang disediakan sistem pada OpenXR.

Jendela editor memperlihatkan dua model pengontrol gerakan

Dukungan untuk HoloLens 2 jala tangan artikulasi di OpenXR

Jala tangan yang berjalan di perangkat dalam adegan contoh MRTK

Dukungan untuk haptik pengontrol di seluruh WMR warisan, Plugin Windows XR, dan OpenXR

Menambahkan dukungan untuk haptik pengontrol di seluruh WMR warisan, Plugin Windows XR, dan OpenXR. #9735

Dukungan untuk pelacakan mata pada Plugin Windows XR

Menambahkan dukungan untuk tatapan mata saat menggunakan versi minimum Plugin Windows XR 2.7.0 (Unity 2019), 4.4.2 (Unity 2020), dan 5.2.2 (Unity 2021). #9609

Bugfixes dan Perubahan penting

  • Deteksi mencubit membuat lebih halus. Sekarang lebih sulit untuk secara tidak sengaja menjatuhkan gerakan mencubit. #9576
  • Objek dengan komponen Object Manipulator sekarang secara konsisten mempertahankan kecepatan pada rilis saat bendera diatur. #9733
  • Back-strafing sekarang memeriksa lantai, membantu mencegah situasi di mana kamera dapat memotong ke lingkungan atau di mana pengguna dibiarkan melayang di atas ruang kosong. #9697
  • IsNearObject sekarang menjadi properti virtual, memungkinkan lebih banyak fleksibilitas saat memperluas sphere atau poke pointer. #9803
  • Tombol sekarang menampilkan kata kunci yang tepat saat menampilkan perintah ucapan yang tersedia. #9824
  • Pengontrol Oculus sekarang menggunakan visualizer mandiri mereka sendiri, mencegah visualisasi MRTK berbenturan dengan visualisasi Paket Integrasi Oculus. #9589
  • Skrip terkait keyboard telah diubah agar selaras dengan perilaku dalam versi Unity terbaru (2019.4.25+ & 2020.3.2+). Pada rilis, masih ada bug penyelesaian otomatis dan bug Bidang Input TMP (keduanya berada di luar MRTK) yang berdampak pada HoloLens. Untuk informasi selengkapnya, lihat #9056 dan #9724.
  • Meningkatkan performa Pengumpulan Objek Pengguliran. Juga memperbaiki masalah yang menyebabkan GameObject dalam koleksi kehilangan materi saat diduplikasi. #9813, #9718
  • Dalam skrip demo Scene Understanding, tambahkan GetSceneObjectsOfType fungsi untuk mengambil semua objek adegan yang diamati dari jenis tertentu. #9524, #9744
  • Di alat build baris perintah, hanya adegan yang ditentukan oleh sceneList bendera atau sceneListFile (ketika ada bendera apa pun) yang akan disertakan dalam build. #9695
  • Di alat build, ada opsi baru untuk menentukan jalur ke nuget.exe dan menggunakannya untuk melakukan pemulihan paket alih-alih menggunakan msbuild (opsi default). #9556
  • Memperbaiki masalah saat menggunakan Plugin Windows XR dapat mengakibatkan sendi tangan kedaluarsa dan jala tangan ganda. #9890
  • Memperbaiki masalah saat menggunakan fitur remoting otomatis Plugin Windows XR menyebabkan input dan interaksi hilang. #9868
  • Memperbaiki masalah di mana akan mencoba mengkueri BuildDeployWindow kunci reg yang tidak valid untuk jalur Windows SDK. #9664
  • Importir MRTK glTF sekarang bersifat opsional. Jika ada beberapa glTF importir, MRTK dapat dinonaktifkan dengan menambahkan MRTK_GLTF_IMPORTER_OFF ke simbol definisi skrip kustom. #9658
  • Memperbaiki masalah di mana pengontrol Knuckles pada OpenVR tidak terdeteksi dengan benar. #9881
  • Kurangi jumlah alokasi per bingkai saat memvisualisasikan jala tangan #9756
  • Menambahkan item menu untuk meluncurkan paket Contoh MRTK (di Unity Package Manager) untuk mempermudah impor sampel #9798
  • Mengurangi jumlah peringatan waktu muat saat menggunakan Unity 2020.3.
  • Menambahkan dokumentasi fitur Jendela Build: Kunjungi halaman

Masalah Umum

Demo audio kehilangan asmdef file (paket UPM)

Ketika MRTK diimpor melalui Alat Fitur Mixed Reality, sampel dan demo ditambahkan ke proyek menggunakan UI Unity Package Manager. Setelah demo Audio diimpor, WindowsMicrophoneStreamDemo.unity adegan tidak akan bertingkah benar. Perilaku ini adalah hasil dari file asmdef yang hilang untuk sampel.

Untuk mengatasi masalah ini, lakukan langkah-langkah berikut:

  • Salin Pustaka/PackageCache/com.microsoft.mixedreality.toolkit.examples@[...] Mrtk. Examples.asmdef ke dalam folder "Contoh Aset/Sampel/Mixed Reality Toolkit" Anda
  • Ganti nama file yang disalin menjadi Contoh
  • Buka file Contoh
  • Dalam kotak Nama, ganti konten dengan Contoh
  • Klik Terapkan
  • Membuat dan menyebarkan

Masalah ini akan diperbaiki dalam rilis MRTK mendatang.

Jendela build MRTK memicu dialog "Mengimpor aset" yang tidak terbatas di Unity 2020.3

Ada masalah yang diketahui dengan jendela build MRTK di Unity 2020.3, di mana dialog "Mengimpor aset" tidak selesai setelah build UWP. Masalah ini sedang diselidiki dengan Unity.

Peringatan Text Mesh Pro Canvas Renderer di Unity 2020

Peringatan berikut dicatat di sebagian besar adegan contoh MRTK saat menggunakan Unity 2020:

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

Peringatan Canvas Renderer ditambahkan di TextMeshPro versi 3.0.3. Peringatan ini tidak berpengaruh pada contoh adegan MRTK dan dapat dibersihkan dari konsol. Untuk detail selengkapnya, lihat Masalah 9811.