Catatan Rilis Microsoft Mixed Reality Toolkit 2.7

Yang baru di 2.7.3

Terima kasih khusus dari Redmond

Tim MRTK ingin menyampaikan terima kasih yang hangat kepada Anda, komunitas MRTK. Kontribusi, umpan balik, dan suara Anda telah membantu MRTK memenangkan Auggie Award for Best Developer Tool 2021! 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!

Kami juga ingin mengucapkan terima kasih kepada teman terkasih kami Lachlan Ford karena telah menerima Penghargaan Auggie atas nama kami dan untuk memastikan bahwa kami menerima penghargaan dengan aman dan sehat. 2021 Auggie Awards Best Developer Tool

Dukungan Unity 2021

Kami telah mempermudah pembangunan Unity 2021 dengan rilis 2.7.3! Jika Anda menemukan masalah saat menggunakan MRTK dengan Unity 2021, silakan 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 iconset tombol #9999
  • Fixed BoundsControl scale handle collider alignment #10007
  • Tetap tekstur font SDF mengategorikan #10006
  • Memperbaiki BoundsControl auto-flatten and scale handle orientation #10013
  • Menambahkan umpan balik untuk perbaikan perataan BoundsControl#10016
  • Memperbaiki deformasi aneh dengan jala tangan selama pemutaran animasi #10024
  • Memperbaiki pengelogan dan SpatialAwarenessSurfaceTypes untuk Pemahaman Adegan #10026
  • Menambahkan direktif definisi Mandiri ke contoh leap skrip adegan #10036
  • Memperbaiki masalah BoundsControlOnEnable saat 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 Pembekuan Jendela Build pada Unity 2020 #10046
  • Serialisasi yang diperbarui untuk aset font #10047
  • Memperbaiki adegan interaksi tangan agar memiliki tabrakan penggerak 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, bukan beberapa #10090
  • Skrip yang dihapus MRSceneContent dari adegan yang tidak memiliki MRTK di dalamnya #10091
  • Menghapus sistem peristiwa berbasis paket dari contoh adegan untuk kompatibilitas Unity 2018 #10092
  • Dukungan yang dihapus untuk pratinjau paket Microsoft OpenXR #10119
  • Memperbaiki pembekuan aplikasi saat menerima data #10033
  • Diperbaiki EyeTrackingTarget tidak memicu OnLookAway saat melewati dari collider dengan EyeTrackingTarget ke collider tanpa #10127
  • Mengubah tingkat pointer default untuk membuat perilaku pointer 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
  • Memperbaiki penanganan IOSMinOSVersion dalam budaya yang berbeda #10178
  • Dihapus raycast ekstra dari tatapan mata diaktifkan objek #10162
  • Menambahkan tipsalat saat mengarahkan kursor ke berbagai profil di Pemeriksa Editor untuk prefab MixedRealityToolkit #10180
  • Perintah ucapan tetap dropdown dan perintah pembaruan 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 pegangan ke ujung jari #10206
  • Menambahkan dukungan untuk Leap UnityModules 4.9.1 #10282
  • Mendukung beberapa perubahan kecil pada ReserializeAssetsUtility.cs#10280
  • Penggunaan yang salah dikonversi menjadi enumValueIndexintValue#10274
  • Memperbaiki objek yang menyimpang selama Manipulasi Dekat #10294
  • Memperbaiki kasus di mana kontrol terikat akan secara agresif menghapus komponen lain #10296
  • Memperbaiki kedinginan pencahayaan Kedekatan #10325
  • Menambahkan pemeriksaan untuk melihat apakah ada yang terkait dengan peristiwa sebelum menentukan untuk menembakkan peristiwa tersebut #10330
  • Mengubah berbagai hal kecil #10316
  • Memperkenalkan alternatif untuk . HasFlag #10319
  • Kurangi 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 fallback case untuk hand select 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 Chaser Sendi Tangan Tetap #10377
  • Memperbaiki kesalahan penyebaran untuk Oculus Quest 10374
  • Memperbaiki masalah dengan contoh scene profile Scene Understanding #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 hilang 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 Alat Fitur Mixed Reality 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.

Show version menu

MRTK version dialog

Catatan

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

Unable to determine version

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.

Configurator window with OpenXR setup instructions

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 MRTK yang semakin matang 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, membantu pengguna menentukan apakah mereka memiliki profil yang benar untuk alur XR yang ditargetkan.

Legacy and XR SDK data providers can now be unified under a single profile

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 -> Project Pengaturan -> Mixed Reality Toolkit untuk men-debug perilaku tak terduga dengan penyedia data yang hilang.

Null data providers are now hidden by defaultToggle show null data providers in the profile inspector

Menambahkan Pengaturan Pengalaman dan perilaku Konten Adegan Mixed Reality terkait

Pengguna sekarang dapat mengonfigurasi Experience Pengaturan, 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 inspektur.

Experience Scale Migration

Konfigurasi yang Didesain Ulang sekarang memandu pengguna melalui proses penyiapan

Konfigurator MRTK baru menyediakan panduan langkah demi langkah kepada pengguna untuk mengonfigurasi proyek dengan benar untuk pengembangan XR dan digunakan 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 showing the pipelines list

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.

Teleport Hotspot example

Tempat Tinggal Lulusan

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

Dwell hero

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. Lihat Cara Mengonfigurasi MRTK untuk Leap Motion untuk informasi selengkapnya.

Terima kasih banyak 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 pada dengan penunjuk tatapan. Sekarang, objek dapat menerima peristiwa ucapan jika difokuskan oleh penunjuk apa pun.

Speech Events with Far Pointers

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.

Editor window showing two motion controller models

Dukungan untuk HoloLens 2 jala tangan artikulasi di OpenXR

The hand mesh running on-device in an MRTK example scene

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

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

Dukungan untuk pelacakan mata pada Plugin XR Windows

Menambahkan dukungan untuk tatapan mata saat menggunakan versi minimum Windows XR Plugin 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 mandirinya 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, silakan 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 dua kali lipat. #9890
  • Memperbaiki masalah saat menggunakan fitur jarak jauh otomatis Windows XR Plugin menyebabkan hilangnya input dan interaksi. #9868
  • Memperbaiki masalah di mana akan mencoba mengkueri BuildDeployWindow kunci reg yang tidak valid untuk jalur SDK Windows. #9664
  • Importir MRTK glTF sekarang bersifat opsional. Jika ada beberapa glTF importir, MRTK dapat dinonaktifkan dengan menambahkan MRTK_GLTF_IMPORTER_OFF ke skrip kustom menentukan simbol. #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)

Saat mengimpor MRTK melalui Alat Fitur Mixed Reality, sampel dan demo ditambahkan ke proyek menggunakan Unity Package Manager UI. Setelah mengimpor demo Audio, WindowsMicrophoneStreamDemo.unity adegan tidak akan bertingkah benar. 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 pada Unity 2020.3 di mana setelah berhasil melakukan build UWP, dialog "Mengimpor aset" tidak selesai. Masalah ini sedang diselidiki dalam kemitraan 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 berdampak pada contoh adegan MRTK dan dapat dibersihkan dari konsol. Lihat Masalah 9811 untuk detail selengkapnya.