Mulai menggunakan MRTK2 dan XR SDK

  • Artikel

XR SDK adalah alur XR baru Unity di Unity 2019.3 dan seterusnya. Di Unity 2019, ini menyediakan alternatif untuk alur XR yang ada. Di Unity 2020, ini adalah satu-satunya alur XR di Unity.

Mengonfigurasi Unity untuk alur XR SDK

Alur XR SDK saat ini mendukung 3 platform: Windows Mixed Reality, Oculus, dan OpenXR. Bagian di bawah ini akan membahas langkah-langkah yang diperlukan untuk mengonfigurasi XR SDK untuk setiap platform.

Realitas Campuran Windows

Buka Unity's Package Manager dan instal paket Plugin Windows XR, yang menambahkan dukungan untuk Windows Mixed Reality di XR SDK. Ini juga akan menurunkan beberapa paket dependensi.

  1. Pastikan bahwa semua berikut ini berhasil diinstal:

    • Manajemen Plugin XR
    • Windows XR Plugin
    • Pembantu Input Warisan XR

  2. Buka Edit > Pengaturan Proyek.

  3. Klik pada tab Manajemen Plug-in XR di jendela Pengaturan Proyek.

  4. Buka pengaturan Platform Windows Universal dan pastikan Windows Mixed Reality dicentang di bawah Penyedia Plug-in.

  5. Pastikan bahwa Inisialisasi XR pada Startup dicentang.

  6. (Diperlukan untuk HoloLens Remoting dalam editor, jika tidak opsional) Buka pengaturan Mandiri dan pastikan Windows Mixed Reality dicentang di bawah Penyedia Plug-in. Pastikan juga bahwa Inisialisasi XR pada Startup dicentang.

    Manajemen Plugin XR dengan tab Mandiri dipilih

  7. (Opsional) Klik tab Windows Mixed Reality di bawah Manajemen Plug-in XR dan buat profil pengaturan kustom untuk mengubah default. Jika daftar pengaturan sudah ada, tidak ada profil yang perlu dibuat.

    Manajemen Plugin XR dengan tab Windows dipilih

Oculus

  1. Ikuti Panduan Cara mengonfigurasi Oculus Quest di MRTK menggunakan panduan alur XR SDK hingga akhir. Panduan ini menguraikan langkah-langkah yang diperlukan untuk mengonfigurasi Unity dan MRTK untuk menggunakan alur XR SDK untuk Oculus Quest.

OpenXR

Penting

OpenXR di Unity hanya didukung pada Unity 2020.2 dan yang lebih tinggi. Ini juga hanya mendukung build x64, ARM, dan ARM64.

  1. Ikuti instruksi Siapkan proyek OpenXR baru dengan MRTK untuk menambahkan plug-in OpenXR ke proyek Anda. Pastikan bahwa berikut ini telah berhasil diinstal:

    1. Manajemen Plugin XR
    2. OpenXR Plugin
    3. Mixed Reality Plugin OpenXR

  2. Buka Edit > Pengaturan Proyek.

  3. Klik pada tab Manajemen Plug-in XR di jendela Pengaturan Proyek.

  4. Pastikan bahwa Inisialisasi XR pada Startup dicentang.

  5. (Opsional) Jika menargetkan HoloLens 2, pastikan Anda berada di platform UWP dan pilih "grup fitur Microsoft HoloLens".

  6. (Opsional) Jika menargetkan Quest 2, pastikan Anda berada di platform Android dan pilih "Pelacakan Tangan" dan "Dukungan Quest Meta".

    Manajemen plugin OpenXR

Catatan

Jika Anda memiliki proyek yang sudah ada sebelumnya yang menggunakan MRTK dari UPM, pastikan baris berikut berada di file link.xml yang terletak di folder MixedRealityToolkit.Generated.

<assembly fullname = "Microsoft.MixedReality.Toolkit.Providers.OpenXR" preserve="all"/>

Mengonfigurasi MRTK untuk alur XR SDK

Gunakan salah satu profil MRTK default, yang semuanya dikonfigurasi di seluruh alur XR Unity. "DefaultOpenXRConfigurationProfile" dan "DefaultXRSDKConfigurationProfile" sebelumnya sekarang diberi label usang.

Jika menggunakan OpenXR, pilih "DefaultOpenXRConfigurationProfile" sebagai profil aktif atau kloning untuk membuat kustomisasi.

Jika menggunakan runtime XR lainnya dalam konfigurasi Manajemen Plug-in XR, seperti Windows Mixed Reality atau Oculus, pilih "DefaultXRSDKConfigurationProfile" sebagai profil aktif atau kloning untuk membuat kustomisasi.

Profil ini disiapkan dengan sistem dan penyedia yang benar, jika diperlukan. Lihat dokumen profil untuk informasi selengkapnya tentang profil dan contoh dukungan dengan XR SDK.

Untuk memigrasikan profil yang ada ke XR SDK, layanan dan penyedia data berikut harus diperbarui.

Anda akan dapat melihat penyedia data baru di bawah tab XR SDK di Unity 2019, atau dalam tampilan utama/hanya di Unity 2020+, di mana XR warisan tidak ada.

Tab XR SDK

Kamera

Tambahkan penyedia data berikut

Pengaturan kamera XR SDK

Input

Tambahkan penyedia data berikut

OpenXR Plugin Windows XR Plugin
OpenXRDeviceManager XRSDK.WindowsMixedReality.WindowsMixedRealityDeviceManager

OpenXR:

Pengaturan input OpenXR

Windows Mixed Reality:

Pengaturan input XR SDK

Perbatasan

Tambahkan penyedia data berikut

OpenXR Plugin Windows XR Plugin
XRSDKBoundarySystem XRSDKBoundarySystem

Pengaturan batas XR SDK

Kesadaran spasial

Tambahkan penyedia data berikut

Pengaturan kesadaran spasial XR SDK

Pemetaan pengontrol

Jika Anda menggunakan profil pemetaan pengontrol kustom, buka salah satunya dan jalankan item menu Mixed Reality Toolkit - Utilities ->> Update -> Controller Mapping Profiles untuk memastikan jenis pengontrol XR SDK baru ditentukan.

Lihat juga