Bagikan melalui

Menyiapkan proyek OpenXR baru dengan MRTK

  • Artikel

Cara termampu untuk menyiapkan proyek Unity Anda untuk realitas campuran adalah dengan Mixed Reality Toolkit (MRTK). MRTK for Unity adalah kit pengembangan lintas platform sumber terbuka yang dirancang untuk memudahkan membangun aplikasi realitas campuran yang luar biasa.

Infografis memperlihatkan beberapa fitur Mixed Reality Toolkit.

MRTK menyediakan sistem input lintas platform, komponen dasar, dan blok penyusun umum untuk interaksi spasial. Ini dapat membantu Anda mempercepat pengembangan aplikasi Anda untuk Microsoft HoloLens, Windows Mixed Reality headset imersif (VR), dan banyak perangkat VR/AR lainnya. Proyek ini bertujuan untuk mengurangi hambatan untuk masuk, memungkinkan semua orang untuk membangun aplikasi realitas campuran dan berkontribusi kembali kepada komunitas saat kita semua tumbuh.

MRTK mendukung berbagai platform, termasuk:

  • Microsoft HoloLens

  • Microsoft HoloLens 2

  • Headset Windows Mixed Reality

  • Headset OpenVR (HTC Vive / Oculus Rift)

  • Ultraleap Hand Tracking

  • Perangkat Android dan iOS

Catatan

Kami baru-baru ini memperkenalkan MRTK3, generasi ketiga Microsoft Mixed Reality Toolkit untuk Unity yang dibangun di atas sistem Manajemen XR Unity dan XR Interaction Toolkit, dengan dukungan yang lebih baik untuk berbagai perangkat yang mematuhi OpenXR dan bahasa desain baru. Untuk informasi selengkapnya, lihat dokumentasi MRTK3.

Catatan

Anda juga dapat menyiapkan proyek OpenXR baru tanpa MRTK.

Opsi konfigurasi non-OpenXR lainnya untuk dipertimbangkan

Windows XR: Microsoft tidak merekomendasikan penggunaan plugin Windows XR untuk proyek baru apa pun di Unity 2020. Sebagai gantinya, Anda harus menggunakan plugin OpenXR Mixed Reality. Namun, jika Anda menggunakan Unity 2019 dan Anda memerlukan AR Foundation 2.0 untuk kompatibilitas dengan perangkat ARCore/ARKit, plugin ini memungkinkan dukungan tersebut.

Penting

Menggunakan plugin ini di Unity 2019 tidak kompatibel dengan Azure Spatial Anchors.

XR Warisan:

Jika Anda masih menggunakan Unity 2019 atau yang lebih lama, Microsoft merekomendasikan penggunaan dukungan XR Bawaan Warisan. Meskipun plugin Windows XR berfungsi pada Unity 2019, kami tidak merekomendasikannya karena tidak kompatibel dengan Azure Spatial Anchors pada Unity 2019.

Jika Anda memulai proyek baru, kami sarankan Anda menginstal Unity 2020 sebagai gantinya dan menggunakan plugin OpenXR Mixed Reality.

Mulai menggunakan OpenXR: Membuat proyek Unity baru

  1. Luncurkan Hub Unity.

  2. Di tab Proyek, klik Proyek Baru.

    Cuplikan layar Unity Hub di tab Proyek dengan tombol Proyek Baru disorot.

  3. Klik menu drop-down pada Proyek baru, lalu pilih versi Editor yang Anda inginkan.

    Cuplikan layar Unity Hub dengan drop-down versi Editor ditampilkan.

  4. Pastikan templat yang dipilih adalah 3D Core.

  5. Di kotak Nama proyek, masukkan nama untuk proyek Anda--misalnya, "Tutorial MRTK".

  6. Di kotak Lokasi, klik ikon map lalu navigasikan ke map tempat Anda ingin menyimpan proyek dan pilih. Anda juga dapat membuat folder baru.

    Cuplikan layar Unity Hub dengan 3D, Nama Proyek, Lokasi, dan Buat disorot.

  7. Klik Buat Project. Tindakan ini membuka proyek Anda di Unity.

    Cuplikan layar proyek Anda terbuka di Unity.

Perhatian

Saat bekerja di Windows, ada batas MAX_PATH sebanyak 255 karakter. Unity dipengaruhi oleh batas-batas ini dan mungkin gagal untuk mengompilasi jika ada jalur file yang lebih panjang dari 255 karakter. Oleh karena itu, kami menyarankan Anda menyimpan proyek Unity Anda sedekat mungkin dengan lokasi root drive.

Tetapkan target build Anda

  1. Pada bilah menu, pilihPengaturan BuildFile>... .

    Untuk membuat aplikasi untuk Windows Mixed Reality, Anda harus memilih target build. Pengaturan build untuk Platform Windows Universal (UWP) menargetkan perangkat apa pun, termasuk headset imersif seperti HP Reverb G2. Ini adalah pilihan terbaik jika Anda membangun untuk HoloLens 2; namun, jika Anda menargetkan VR desktop, kami sarankan Anda menggunakan platform PC, Mac & Linux Standalone.

  2. Lakukan salah satu hal berikut ini:

    Jika Anda menargetkan Desktop VR:

    • Pertahankan platform PC, Mac & Linux Standalone yang dipilih secara default pada proyek Unity baru:

    Cuplikan layar jendela Pengaturan Build terbuka di editor unity dengan PC, Mac & Platform mandiri disorot

    Jika Anda menargetkan HoloLens 2:

    • Di bawah Platform, pilih Platform Windows Universal. Pastikan pengaturan berikut aktif:

    Jenis Bangunan: Proyek D3D

    Versi SDK Target: Terbaru Dipasang

    Versi Platform Minimum: 10.0.10240.0

    Versi Visual Studio: Terbaru dipasang

    Cuplikan layar jendela Pengaturan Build terbuka di editor unity dengan Platform Windows Universal disorot.

  3. Klik tombol Ganti Platform. Unity menampilkan bilah tingkat kemajuan saat berpindah platform.

  4. Setelah proses peralihan platform selesai, tutup jendela Pengaturan Build.

Mengunduh dan menginstal Alat Fitur Mixed Reality

Plugin OpenXR Mixed Reality hadir dalam bentuk paket untuk Unity. Cara terbaik untuk menemukan, memperbarui, dan mengimpor paket fitur adalah dengan Mixed Reality Feature Tool. Anda dapat mencari paket berdasarkan nama atau kategori, melihat dependensinya, dan melihat usulan perubahan pada file manifes proyek Anda sebelum mengimpor.

  1. Unduh versi terbaru alat fitur Mixed Reality dari Pusat Unduhan Microsoft.

  2. Setelah pengunduhan selesai, navigasikan ke file yang dapat dieksekusi MixedRealityFeatureTool.exe lalu gunakan untuk meluncurkan Alat Fitur Mixed Reality.

    Cuplikan layar Membuka MixedRealityFeatureTool.

Mengimpor paket Mixed Reality Toolkit dan OpenXR

  1. Di Alat Fitur Mixed Reality, pilih Mulai.

    Cuplikan layar pembuka Alat Fitur Mixed Reality.

  2. Pilih tombol Browse (ini adalah tombol "tiga titik" pada gambar di bawah), lalu navigasikan ke proyek Anda, lalu buka.

    Buka proyek Anda

    Catatan

    Kotak Jalur Proyek di Alat harus berisi nilai, sehingga menyisipkan garis miring terbalik ("_") secara default.

    Setelah Anda memilih folder, Alat akan memeriksa untuk memastikan bahwa itu adalah folder proyek Unity yang valid.

    Cuplikan layar Jalur Proyek Alat fitur Mixed Reality.

  3. Pilih Temukan Fitur.

    Catatan: Anda mungkin perlu menunggu beberapa detik saat Alat menyegarkan paket dari umpan.

  4. Pada halaman Fitur Temukan, perhatikan bahwa ada daftar enam grup paket.

    Grup utama paket di Alat Fitur Mixed Reality

  5. Klik tombol "+" di sebelah kiri Mixed Reality Toolkit (0 dari 10) lalu pilih versi terbaru Mixed Reality Toolkit Foundation.

    Catatan

    Paket Mixed Reality Toolkit Foundation adalah satu-satunya paket yang harus diimpor dan dikonfigurasi untuk menggunakan MRTK dengan proyek Anda. Paket ini mencakup komponen inti yang diperlukan untuk membuat aplikasi realitas campuran.

  6. Klik tombol "+" di sebelah kiri Dukungan Platform (0 dari 5) lalu pilih versi terbaru Plugin Mixed Reality OpenXR.

    Cuplikan layar pilihan paket di Alat Fitur Mixed Reality.

  7. Setelah Anda menentukan pilihan, klik Dapatkan Fitur.

  8. Pilih Validasi untuk memvalidasi paket yang Anda pilih. Anda akan melihat dialog yang menyatakan Tidak ada masalah validasi yang terdeteksi. Saat Anda melakukannya, klik Oke.

  9. Pada halaman Impor Fitur, kolom sebelah kiri, Fitur, menampilkan paket yang baru saja Anda pilih. Kolom sisi kanan, Ketergantungan yang diperlukan, menampilkan dependensi apa pun. Anda dapat mengeklik tautan Detail untuk salah satu item ini untuk mempelajari lebih lanjut tentangnya.

  10. Saat Anda siap untuk melanjutkan, pilih Impor. Pada halaman Tinjau dan Setujui, Anda dapat meninjau informasi tentang paket.

  11. Pilih Setujui.

  12. Kembali ke Unity Editor dan klik area kosong di UI. Anda akan melihat bilah kemajuan yang menunjukkan bahwa paket Anda sedang diimpor.

Mengonfigurasi pengaturan Backend Input

  1. Setelah Unity mengimpor paket, muncul peringatan yang menanyakan apakah Anda ingin mengaktifkan backend dengan memulai ulang editor. Pilih Ya.

    Cuplikan layar Opsi Hidupkan Ulang Unity.

Mengonfigurasi proyek untuk HoloLens 2 melalui Validasi Proyek (MR OpenXR 1.6+)

Jika Anda mengembangkan untuk VR desktop, lewati bagian ini dan buka Mengonfigurasi proyek untuk VR desktop.

  1. Pada bilah menu, klik Mixed Reality > Pengaturan > Validasi Proyek HoloLens 2 Aplikasi (UWP) untuk mengaktifkan aturan validasi untuk HoloLens 2. Untuk plugin MR OpenXR sebelum versi 1.9, item menu yang tersedia Mixed Reality > pengaturan proyek yang direkomendasikan Project > Apply untuk HoloLens 2.
  2. Di jendela validasi proyek yang muncul, pastikan Anda berada di tab platform UWP (ditunjukkan oleh logo Windows), dan klik Perbaiki semua untuk mengatasi masalah validasi. Perhatikan bahwa mungkin ada masalah yang tersisa setelah mengklik Perbaiki semua. Dalam hal ini, coba klik Perbaiki semua lagi, abaikan masalah apa pun yang ditandai "spesifik adegan" (jika ada), dan lanjutkan masalah lainnya (jika ada) untuk melihat apakah ada perubahan yang disarankan yang ingin Anda buat.
  3. Proyek ini hampir siap untuk penyebaran HoloLens 2 pada saat ini. Lanjutkan ke Mengonfigurasi pengaturan Pemutar untuk langkah berikutnya.

Mengonfigurasi proyek untuk HoloLens 2 secara manual

Jika Anda mengembangkan untuk VR desktop, lewati bagian ini dan buka Mengonfigurasi proyek untuk VR desktop.

  1. Pastikan jendela Pengaturan Proyek terbuka. Jika tidak, pada bilah menu, pilih Edit>Pengaturan Proyek.

  2. Di jendela Pengaturan Proyek, pastikan Anda berada di halaman Manajemen Plug-in XR dan di tab Platform Windows Universal.

    Cuplikan layar Jendela Pengaturan Proyek terbuka ke Halaman Manajemen Plugin XR dan tab Platform Windows Universal.

  3. Pastikan bahwa Inisialisasi XR pada Startup dipilih, lalu, di bawah Penyedia Plugin, klik OpenXR.

    Cuplikan layar Jendela Pengaturan Proyek, di dalam Platform Windows Universal, dengan Inisialisasi XR pada Startup dipilih dan Plugin OpenXR disorot.

  4. Plugin OpenXR dimuat, lalu beberapa item muncul di bawah OpenXR. Pilih grup fitur Microsoft HoloLens.

    Cuplikan layar Jendela Pengaturan Proyek dengan plugin OpenXR dan Grup Fitur Microsoft HoloLens disorot.

Perhatikan bahwa ada segitiga peringatan kuning di samping OpenXR. Ini menunjukkan bahwa Anda memiliki pengaturan yang tidak kompatibel yang perlu diselesaikan. Untuk mengetahui cara mengatasinya, lewati bagian berikutnya tentang mengonfigurasi VR dan lanjutkan dengan bagian berikut, Menyelesaikan pengaturan yang tidak kompatibel.

Mengonfigurasi proyek untuk VR desktop melalui Validasi Proyek (MR OpenXR 1.9+)

  1. Pada bilah menu, klik Mixed Reality > Pengaturan > Validasi Proyek Aplikasi Win32 (Mandiri) untuk mengaktifkan aturan validasi untuk aplikasi XR desktop.
  2. Di jendela validasi proyek yang muncul, pastikan Anda berada di tab Platform mandiri, dan klik Perbaiki semua untuk mengatasi masalah validasi. Perhatikan bahwa mungkin ada masalah yang tersisa setelah mengklik Perbaiki semua. Dalam hal ini, coba klik Perbaiki semua lagi, abaikan masalah apa pun yang ditandai "spesifik adegan" (jika ada), dan lanjutkan masalah lainnya (jika ada) untuk melihat apakah ada perubahan yang disarankan yang ingin Anda buat.

Mengonfigurasi proyek untuk VR desktop secara manual

  1. Pastikan jendela Pengaturan Proyek terbuka. Jika tidak, buka bilah menu, pilih Edit>Pengaturan Proyek.

  2. Di jendela Pengaturan Proyek , pastikan Anda berada di halaman Manajemen Plug-in XR dan di tab PC, Mac & Linux Standalone .

    Cuplikan layar Jendela Pengaturan Proyek terbuka ke Halaman Manajemen Plugin XR dan tab PC, Mac & Linux Mandiri.

  3. Pastikan bahwa Inisialisasi XR pada Startup dipilih, lalu, di bawah Penyedia Plugin, klik OpenXR.

    Cuplikan layar Jendela Pengaturan Proyek, di dalam tab PC, Mac & Linux Mandiri, dengan Inisialisasi XR pada Startup dipilih dan Plugin OpenXR disorot.

  4. Plugin OpenXR dimuat, lalu dua item muncul di bawah OpenXR. Pilih yang pertama, Windows Mixed Reality grup fitur.

    Cuplikan layar Jendela Pengaturan Proyek, Plugin OpenXR dan grup fitur Windows Mixed Reality disorot.

Perhatikan bahwa sekarang ada segitiga peringatan kuning di sebelah OpenXR. Ini menunjukkan bahwa Anda memiliki pengaturan yang tidak kompatibel yang perlu diselesaikan. Untuk mengetahui cara mengatasinya, lanjutkan ke bagian berikutnya, Menyelesaikan pengaturan yang tidak kompatibel.

Mengatasi pengaturan yang tidak kompatibel

Penting

Gambar di bagian ini memperlihatkan opsi di tab Platform Windows Universal. Namun, instruksinya sama untuk tab Desktop VR, kecuali jika disebutkan.

  1. Arahkan kursor Anda ke segitiga peringatan kuning di samping OpenXR, lalu baca pesan di popup, lalu pilih segitiga.

    Cuplikan layar peringatan tentang pengaturan yang tidak kompatibel.

  2. Di jendela OpenXR Project Validation, ada beberapa masalah yang terdaftar. Pilih tombol Perbaiki Semua. CATATAN: Daftar ini mungkin terlihat berbeda tergantung pada tab tempat Anda berada.

    Cuplikan layar tombol Perbaiki Semua di jendela Validasi Proyek OpenXR.

  3. Satu masalah tetap ada dan memberi tahu Anda bahwa Anda harus menambahkan setidaknya satu profil interaksi. Untuk melakukannya, klik Edit. Ini membawa Anda ke setelan untuk plugin OpenXR di jendela Pengaturan Proyek.

    Cuplikan layar jendela Pengaturan Proyek dengan pengaturan OpenXR ditampilkan.

  4. Di bagian Profil Interaksi, perhatikan tombol tanda tambah (+).

    Cuplikan layar tombol Tambahkan Profil Interaksi.

  5. Klik tombol tiga kali, setiap kali memilih profil yang berbeda:

    Profil Interaksi Tatapan Mata

    Profil Interaksi Tangan Microsoft

    Profil Pengontrol Gerakan Microsoft

    Cuplikan layar profil interaksi yang harus ditambahkan.

    Jika Profil Interaksi Tatapan Mata, atau profil lainnya, muncul dengan segitiga kuning di sampingnya, pilih segitiga tersebut, lalu di jendela OpenXR Project Validation, klik ikon tombol Perbaiki. Setelah selesai, tutup jendela OpenXR Project Validation.

    Cuplikan layar tombol Perbaiki untuk profil interaksi Tatapan Mata.

  6. Di jendela Pengaturan Proyek di bagian Grup Fitur OpenXR, pastikan bahwa yang berikut ini dipilih:

    Jika Anda berada di tab Desktop VR:

    Realitas Campuran Windows

    Pelacakan Tangan

    Model Pengontrol Gerak

    Cuplikan layar Grup Fitur OpenXR untuk tab Desktop VR.

    Jika Anda berada di tab Platform Windows Universal:

    Microsoft HoloLens

    Pelacakan Tangan

    Model Pengontrol Gerak

    Cuplikan layar fitur yang dipilih untuk OpenXR.

  7. Klik menu dropdown Mode Pengiriman Kedalaman, lalu pilih Kedalaman 16 Bit.

    Cuplikan layar Kedalaman 16 Bit dipilih untuk Mode Pengiriman Kedalaman.

    Tip

    Mengurangi Format Kedalaman menjadi 16-bit adalah opsional, tetapi hal tersebut dapat meningkatkan performa grafis dalam proyek Anda. Untuk mempelajari lebih lanjut, lihat Berbagi buffer kedalaman (HoloLens).

    Catatan

    Pengaturan Mode Render, yang terletak tepat di atas Mode Pengiriman Kedalaman, secara default disetel ke Instance Pass Tunggal. Dalam aplikasi realitas campuran, pemandangan dirender dua kali: sekali untuk setiap mata. Hasilnya adalah "penglihatan stereoskopik." Ini menggandakan jumlah komputasi yang diperlukan, jadi penting untuk memilih jalur rendering yang paling efisien di Unity untuk menghemat waktu CPU dan GPU. Render instans satu pass adalah pilihan terbaik di sini--kami menyarankan Anda mengaktifkannya secara default untuk setiap proyek. Untuk mempelajari lebih lanjut tentang ini, lihat dokumentasi Unity.

Mengonfigurasi pengaturan Pemutar

  1. Di kolom sisi kiri jendela Pengaturan Proyek, pilih Pemutar.

  2. Perhatikan bahwa di jendela Pemutar , kotak Nama Produk sudah terisi. Ini diambil dari nama proyek Anda dan akan menjadi nama yang ditampilkan di menu Mulai HoloLens.

    Cuplikan layar Pengaturan Penerbitan Unity dengan kotak Nama Proyek terisi.

    Tip

    Untuk membuat aplikasi lebih mudah ditemukan selama pengembangan, tambahkan garis bawah di depan nama untuk mengurutkannya ke bagian atas daftar apa pun.

  3. Klik menu drop-down Pengaturan Penerbitan , lalu di bidang Nama paket, masukkan nama yang sesuai.

    Cuplikan layar Pengaturan Penerbitan Unity dengan kotak nama paket terisi.

    Catatan

    Nama paket adalah pengidentifikasi unik untuk aplikasi. Jika Anda ingin menghindari menimpa versi aplikasi yang diinstal sebelumnya dengan nama yang sama, Anda harus mengubah pengenal ini sebelum menerapkan aplikasi.

  4. Tutup jendela Pengaturan Proyek.

Anda sekarang siap untuk mulai mengembangkan dengan OpenXR di Unity!

Proyek sampel Unity

Lihat repositori sampel OpenXR Mixed Reality untuk contoh proyek unity yang menampilkan cara membangun aplikasi Unity untuk headset HoloLens 2 atau Mixed Reality menggunakan plugin OpenXR Mixed Reality.

Lihat juga