Paket MRTK — MRTK2
Mixed Reality Toolkit (MRTK) adalah kumpulan paket yang memungkinkan pengembangan aplikasi lintas platform Mixed Reality dengan memberikan dukungan untuk perangkat keras dan platform Mixed Reality.
MRTK tersedia sebagai paket aset (.unitypackage) dan melalui Unity Package Manager.
Paket aset
Aset MRTK (.unitypackage) dapat diunduh dari GitHub.
Beberapa manfaat menggunakan paket aset meliputi:
- Tersedia untuk Unity 2018.4 dan yang lebih baru
- Mudah untuk membuat perubahan pada MRTK
- MRTK berada di folder Aset
Beberapa tantangannya adalah:
- MRTK adalah bagian dari folder Aset proyek, yang mengarah ke
- Proyek yang lebih besar
- Waktu kompilasi yang lebih lambat
- Tidak ada manajemen dependensi
- Pelanggan diharuskan untuk menyelesaikan dependensi paket secara manual
- Proses pembaruan manual
- Beberapa langkah
- Pembaruan kontrol sumber besar (3000+ file)
- Risiko kehilangan perubahan yang dilakukan pada MRTK
- Mengimpor paket contoh biasanya berarti termasuk semua contoh
Paket yang tersedia adalah:
Paket-paket ini dirilis dan didukung oleh Microsoft dari kode sumber di GitHub.
Paket fondasi
Mixed Reality Toolkit Foundation adalah sekumpulan kode yang memungkinkan aplikasi Anda memanfaatkan fungsionalitas umum di seluruh platform Mixed Reality.
Paket MrTK Foundation yayasan
Paket MRTK Foundation berisi hal-hal berikut.
| Folder | Komponen | Deskripsi |
|---|---|---|
| MRTK/Core | Definisi antarmuka dan jenis, kelas dasar, shader standar. | |
| MRTK/Core/Providers | Penyedia data agnostik platform | |
| Tangan | Dukungan dan layanan kelas dasar untuk pelacakan tangan. | |
| InputAnimation | Dukungan untuk merekam pergerakan kepala dan data pelacakan tangan. | |
| InputSimulation | Dukungan untuk simulasi in-editor input tangan dan mata. | |
| ObjectMeshObserver | Pengamat kesadaran spasial menggunakan model 3D sebagai data. | |
| UnityInput | Perangkat input umum (joystick, mouse, dll.) diimplementasikan melalui API input Unity. | |
| MRTK/Penyedia | Penyedia data khusus platform | |
| LeapMotion | Dukungan untuk pengontrol UltraLeap Leap Motion. | |
| OpenVR | Dukungan untuk perangkat OpenVR. | |
| Oculus | Dukungan untuk perangkat Oculus, seperti Quest. | |
| UnityAR | (Eksperimental) Penyedia pengaturan kamera yang memungkinkan penggunaan MRTK dengan perangkat AR seluler. | |
| WindowsMixedReality | Dukungan untuk perangkat Windows Mixed Reality, termasuk Microsoft HoloLens dan headset imersif. | |
| Windows | Dukungan untuk API khusus Microsoft Windows, misalnya ucapan dan dikte. | |
| XR SDK | (Eksperimental) Dukungan untuk kerangka kerja XR baru Unity di Unity 2019.3 dan yang lebih baru. | |
| MRTK/SDK | ||
| Eksperimental | Fitur eksperimental, termasuk shader, kontrol antarmuka pengguna, dan manajer sistem individual. | |
| Fitur | Fungsionalitas yang dibangun berdasarkan paket Foundation. | |
| Profil | Profil default untuk sistem dan layanan Microsoft Mixed Reality Toolkit. | |
| StandardAssets | Aset umum; model, tekstur, bahan, dll. | |
| MRTK/SceneSystemResources | Aset dan sumber daya yang digunakan oleh Sistem Adegan | |
| MRTK/Services | ||
| BoundarySystem | Sistem yang menerapkan dukungan batas VR. | |
| CameraSystem | Sistem yang mengimplementasikan konfigurasi dan manajemen kamera. | |
| DiagnosticsSystem | Penerapan sistem dalam diagnostik aplikasi, misalnya profiler visual. | |
| InputSystem | Sistem menyediakan dukungan untuk mengakses dan menangani input pengguna. | |
| SceneSystem | Sistem menyediakan dukungan aplikasi multi-adegan. | |
| SpatialAwarenessSystem | Sistem memberikan dukungan untuk kesadaran akan lingkungan pengguna. | |
| TeleportSystem | Sistem menyediakan dukungan untuk teleportasi (bergerak tentang pengalaman dalam lompatan). | |
| MRTK/StandardAssets | Shader MRTK Standard, bahan dasar, dan aset standar lainnya untuk pengalaman realitas campuran |
Paket ekstensi
Paket Microsoft.MixedRealityToolkit.Unity.Extensions opsional mencakup layanan tambahan yang memperluas fungsionalitas Microsoft Mixed Reality Toolkit.
Catatan
Paket ekstensi memerlukan Microsoft.MixedRealityToolkit.Unity.Foundation.
| Folder | Komponen | Deskripsi |
|---|---|---|
| MRTK/Extensions | ||
| HandPhysicsService | Layanan yang menambahkan dukungan fisika ke tangan artikulasi. | |
| LostTrackingService | Layanan yang menyederhanakan penanganan kehilangan pelacakan pada perangkat Microsoft HoloLens. | |
| SceneTransitionService | Layanan yang menyederhanakan penambahan transisi adegan yang lancar. |
Paket alat
Paket Microsoft.MixedRealityToolkit.Unity.Tools opsional mencakup alat bermanfaat yang meningkatkan pengalaman pengembangan realitas campuran menggunakan Microsoft Mixed Reality Toolkit. Alat-alat ini terletak di menu Utilitas Toolkit > Mixed Reality di Editor Unity.
Catatan
Paket alat memerlukan Microsoft.MixedRealityToolkit.Unity.Foundation.
| Folder | Komponen | Deskripsi |
|---|---|---|
| MRTK/Alat | ||
| BuildWindow | Alat yang membantu menyederhanakan proses pembangunan dan penyebaran aplikasi UWP. | |
| DependencyWindow | Alat yang membuat grafik dependensi aset dalam proyek. | |
| ExtensionServiceCreator | Wizard untuk membantu dalam membuat layanan ekstensi. | |
| MigrationWindow | Alat yang membantu memperbarui kode yang menggunakan komponen MRTK yang tidak digunakan lagi. | |
| OptimizeWindow | Utilitas untuk membantu mengotomatiskan konfigurasi proyek realitas campuran untuk performa terbaik di Unity. | |
| ReserializeAssetsUtility | Menyediakan dukungan untuk menserialisasi ulang file Unity tertentu. | |
| RuntimeTools/Tools/ControllerMappingTool | Utilitas yang memungkinkan pengembang menentukan pemetaan Unity dengan cepat untuk pengontrol perangkat keras. | |
| Cuplikan layarUtilitas | Memungkinkan pengambilan gambar aplikasi di editor Unity. | |
| TextureCombinerWindow | Utilitas untuk menggabungkan tekstur grafis. | |
| Toolbox | UI yang memudahkan untuk menemukan dan menggunakan komponen MRTK UX. |
Menguji paket utilitas
Paket Microsoft.MixedRealityToolkit.TestUtilities opsional adalah kumpulan skrip pembantu yang memungkinkan pengembang membuat pengujian mode putar dengan mudah. Utilitas ini sangat berguna bagi pengembang yang membuat komponen MRTK.
| Folder | Komponen | Deskripsi |
|---|---|---|
| MRTK/Tes | ||
| TestUtilities | Metode untuk menyederhanakan pembuatan tes mode bermain, termasuk utilitas simulasi tangan. |
Contoh paket
Paket contoh berisi demo, contoh skrip, dan sampel adegan yang menjalankan fungsionalitas dalam paket fondasi. Paket ini berisi adegan HandInteractionExample (digambarkan di bawah) yang berisi objek sampel yang merespons berbagai jenis input tangan (diartikulasikan dan tidak diartikulasikan).
Paket ini juga berisi demo pelacakan mata, yang di dokumentasikan di sini
Secara umum, fitur baru apa pun di MRTK harus berisi contoh yang sesuai dalam paket contoh, kira-kira mengikuti struktur dan lokasi folder yang sama.
Catatan
Paket contoh memerlukan Microsoft.MixedRealityToolkit.Unity.Foundation.
| Folder | Komponen | Deskripsi |
|---|---|---|
| MRTK/Contoh | ||
| Demo | Adegan sederhana yang mengilustrasikan satu atau dua fitur terkait. | |
| Eksperimental | Adegan demo yang mengilustrasikan fitur eksperimental. | |
| StandardAssets | Aset umum dibagikan oleh beberapa adegan demo. |
Manajer Paket Unity
Untuk pengalaman yang dibuat menggunakan Unity 2019.4 dan yang lebih baru, MRTK tersedia melalui Unity Package Manager.
Beberapa manfaat menggunakan paket aset meliputi:
- Proyek yang lebih kecil
- Solusi Visual Studio yang lebih bersih
- Lebih sedikit file untuk dicek masuk (MRTK adalah referensi sederhana dalam
Packages/manifest.jsonfile)
- Kompilasi yang lebih cepat
- Unity tidak perlu mengkombinasi ulang MRTK selama membangun
- Resolusi dependensi
- Paket MRTK yang diperlukan diinstal secara otomatis saat menentukan paket dengan dependensi
- Pembaruan mudah ke versi MRTK baru
- Mengubah versi dalam
Packages/manifest.jsonfile
- Mengubah versi dalam
Beberapa tantangannya adalah:
- MRTK tidak dapat diubah
- Tidak dapat membuat perubahan tanpa dihapus selama resolusi paket
- MRTK tidak mendukung paket UPM dengan Unity 2018.4
Paket fondasi
Paket dasar (com.microsoft.mixedreality.toolkit.foundation) membentuk dasar Mixed Reality Toolkit.
| Folder | Komponen | Deskripsi |
|---|---|---|
| MRTK/Core | Definisi antarmuka dan jenis, kelas dasar, shader standar. | |
| MRTK/Core/Providers | Penyedia data agnostik platform | |
| Tangan | Dukungan dan layanan kelas dasar untuk pelacakan tangan. | |
| InputAnimation | Dukungan untuk merekam pergerakan kepala dan data pelacakan tangan. | |
| InputSimulation | Dukungan untuk simulasi in-editor input tangan dan mata. | |
| ObjectMeshObserver | Pengamat kesadaran spasial menggunakan model 3D sebagai data. | |
| UnityInput | Perangkat input umum (joystick, mouse, dll.) diimplementasikan melalui API input Unity. | |
| MRTK/Penyedia | Penyedia data khusus platform | |
| LeapMotion | Dukungan untuk pengontrol UltraLeap Leap Motion. | |
| OpenVR | Dukungan untuk perangkat OpenVR. | |
| Oculus | Dukungan untuk perangkat Oculus, seperti Quest. | |
| UnityAR | (Eksperimental) Penyedia pengaturan kamera yang memungkinkan penggunaan MRTK dengan perangkat AR seluler. | |
| WindowsMixedReality | Dukungan untuk perangkat Windows Mixed Reality, termasuk Microsoft HoloLens dan headset imersif. | |
| Windows | Dukungan untuk API khusus Microsoft Windows, misalnya ucapan dan dikte. | |
| XR SDK | (Eksperimental) Dukungan untuk kerangka kerja XR baru Unity di Unity 2019.3 dan yang lebih baru. | |
| MRTK/SDK | ||
| Eksperimental | Fitur eksperimental, termasuk shader, kontrol antarmuka pengguna, dan manajer sistem individual. | |
| Fitur | Fungsionalitas yang dibangun berdasarkan paket Foundation. | |
| Profil | Profil default untuk sistem dan layanan Microsoft Mixed Reality Toolkit. | |
| StandardAssets | Aset umum; model, tekstur, bahan, dll. | |
| MRTK/Services | ||
| BoundarySystem | Sistem yang menerapkan dukungan batas VR. | |
| CameraSystem | Sistem yang mengimplementasikan konfigurasi dan manajemen kamera. | |
| DiagnosticsSystem | Penerapan sistem dalam diagnostik aplikasi, misalnya profiler visual. | |
| InputSystem | Sistem menyediakan dukungan untuk mengakses dan menangani input pengguna. | |
| SceneSystem | Sistem menyediakan dukungan aplikasi multi-adegan. | |
| SpatialAwarenessSystem | Sistem memberikan dukungan untuk kesadaran akan lingkungan pengguna. | |
| TeleportSystem | Sistem menyediakan dukungan untuk teleportasi (bergerak tentang pengalaman dalam lompatan). |
Dependensi:
- Aset Standar (
com.microsoft.mixedreality.toolkit.standardassets)
Aset Standar
Paket aset standar (com.microsoft.mixedreality.toolkit.standardassets) adalah kumpulan komponen yang direkomendasikan untuk semua pengalaman realitas campuran, termasuk:
- Shader Standar MRTK
- Bahan dasar menggunakan shader MRTK Standard
- File audio
- Font
- Tekstur
- Ikon
Catatan
Untuk menghindari melanggar perubahan berdasarkan definisi assembly, skrip yang digunakan untuk mengontrol beberapa fitur shader MRTK Standard tidak termasuk dalam paket aset standar. Skrip ini dapat ditemukan dalam paket fondasi di MRTK/Core/Utilities/StandardShader folder .
Dependensi: tidak ada
Paket ekstensi
Paket ekstensi opsional (com.microsoft.mixedreality.toolkit.extensions) berisi komponen tambahan yang memperluas fungsionalitas MRTK.
| Folder | Komponen | Deskripsi |
|---|---|---|
| MRTK/Ekstensi | ||
| HandPhysicsService | Layanan yang menambahkan dukungan fisika ke tangan artikulasi. | |
| LostTrackingService | Layanan yang menyederhanakan penyerahan kehilangan pelacakan pada perangkat Microsoft HoloLens. | |
| SceneTransitionService | Layanan yang menyederhanakan penambahan transisi adegan yang lancar. | |
| Sampel~ | Folder tersembunyi (di Unity Editor) yang berisi sampel adegan dan aset. |
Detail selengkapnya tentang proses penggunaan paket yang berisi contoh proyek dapat ditemukan di artikel Mixed Reality Toolkit dan Unity Package Manager.
Dependensi:
- Fondasi (
com.microsoft.mixedreality.toolkit.foundation)
Paket alat
Paket alat opsional (com.microsoft.mixedreality.toolkit.tools) berisi alat yang berguna untuk menciptakan pengalaman realitas campuran. Secara umum, alat-alat ini adalah komponen editor dan kodenya tidak dikirim sebagai bagian dari aplikasi.
| Folder | Komponen | Deskripsi |
|---|---|---|
| MRTK/Alat | ||
| BuildWindow | Alat yang membantu menyederhanakan proses pembangunan dan penyebaran aplikasi UWP. | |
| DependencyWindow | Alat yang membuat grafik dependensi aset dalam proyek. | |
| ExtensionServiceCreator | Wizard untuk membantu dalam membuat layanan ekstensi. | |
| MigrationWindow | Alat yang membantu memperbarui kode yang menggunakan komponen MRTK yang tidak digunakan lagi. | |
| OptimizeWindow | Utilitas untuk membantu mengotomatiskan konfigurasi proyek realitas campuran untuk performa terbaik di Unity. | |
| ReserializeAssetsUtility | Menyediakan dukungan untuk menserialisasi ulang file Unity tertentu. | |
| RuntimeTools/Tools/ControllerMappingTool | Utilitas yang memungkinkan pengembang menentukan pemetaan Unity dengan cepat untuk pengontrol perangkat keras. | |
| Cuplikan layarUtilitas | Memungkinkan pengambilan gambar aplikasi di editor Unity. | |
| TextureCombinerWindow | Utilitas untuk menggabungkan tekstur grafis. | |
| Toolbox | UI yang memudahkan untuk menemukan dan menggunakan komponen MRTK UX. |
Dependensi:
- Fondasi (
com.microsoft.mixedreality.toolkit.foundation)
Menguji paket utilitas
Paket utilitas pengujian opsional (com.microsoft.mixedreality.toolkit.testutilities) berisi kumpulan skrip pembantu yang memungkinkan pengembang membuat pengujian mode putar dengan mudah. Utilitas ini sangat berguna bagi pengembang yang membuat komponen MRTK.
| Folder | Komponen | Deskripsi |
|---|---|---|
| MRTK/Tes | ||
| TestUtilities | Metode untuk menyederhanakan pembuatan tes mode bermain, termasuk utilitas simulasi tangan. |
Dependensi:
- Fondasi (
com.microsoft.mixedreality.toolkit.foundation)
Contoh paket
Paket contoh (com.microsoft.mixedreality.toolkit.examples), disusun untuk memungkinkan pengembang mengimpor hanya contoh yang diminati.
Detail selengkapnya tentang proses penggunaan paket yang berisi contoh proyek dapat ditemukan di artikel Mixed Reality Toolkit dan Unity Package Manager.
| Folder | Komponen | Deskripsi |
|---|---|---|
| MRTK/Contoh | ||
| Sampel~ | Folder tersembunyi (di Unity Editor) yang berisi sampel adegan dan aset. | |
| StandardAssets | Aset umum dibagikan oleh beberapa adegan demo. |
Dependensi:
- Fondasi (
com.microsoft.mixedreality.toolkit.foundation) - Ekstensi (
com.microsoft.mixedreality.toolkit.extensions)