Bagikan melalui


Lintas Platform menggunakan sistem Plugin XR SDK Unity

Pengembangan awal World Locking Tools menargetkan keluarga perangkat HoloLens melalui Unity's XR. API WSA (Aplikasi Windows Store VR/AR). Ini adalah bagian dari apa yang telah dikenal sebagai antarmuka XR Warisan Unity, atau dukungan VR bawaan Unity.

Unity telah memperkenalkan arsitektur Plugin XR-nya, yang tujuannya adalah untuk menyediakan abstraksi lintas platform yang memberi pengembang akses ke fitur umum di seluruh perangkat VR dan AR yang tersedia.

Selama fase transisi ini, WLT telah mendukung antarmuka XR Warisan untuk HoloLens, dan AR Subsystems/XR Plugin Management untuk lintas platform. Perlu dicatat bahwa antarmuka XR Warisan tidak digunakan lagi sejak Unity 2019, dan tidak lagi didukung pada Unity 2020.

WLT saat ini mendukung Ar Subsistem versi 2.X.Y untuk Unity 2019.4 (LTS) dan XR Plugin Management versi 4.0.7 dan yang lebih baru untuk Unity 2020.3 (LTS). Dukungan versi lebih lanjut akan diluncurkan dalam rilis berikutnya.

Mengalihkan WLT ke SDK XR target

Menargetkan WLT untuk XR SDK sangat sederhana. Pertama, konfigurasikan proyek Anda untuk menggunakan sistem Plugin XR.

Jika menggunakan MRTK, ikuti instruksi ini. Ada tips dan catatan tambahan nanti di artikel ini.

Jika tidak menggunakan MRTK, ikuti instruksi yang sedikit lebih rumit ini.

Dalam kedua kasus, Anda akan berakhir dengan sistem Unity XR Plug-in Management yang diinstal dan diaktifkan, dan dengan yang XR Plug-in provider sesuai untuk platform Anda yang diinstal dan dipilih.

Setelah sumber daya yang diperlukan diinstal, ubah jenis Subsistem Jangkar di Konteks Penguncian Dunia di adegan Anda.

Pilihan otomatis

Menjalankan skrip Mixed Reality => World Locking Tools => Configure scene akan memilih Subsistem Jangkar yang benar berdasarkan bagaimana proyek dan adegan Anda dikonfigurasi. Aman untuk menjalankan Configure scene skrip berulang kali. Jika adegan sudah dikonfigurasi dengan benar, adegan tersebut tidak akan membuat perubahan.

Pilihan manual

  1. Buka WorldLockingManager GameObject di adegan awal (atau global) Anda.
  2. Di inspektur, temukan WorldLockingContext.
  3. Buka pengaturan Manajemen Jangkar.
  4. Pastikan kotak centang "Gunakan Default" tidak dicentang.
  5. Ubah jenis Subsistem Jangkar menjadi XRSDK.

Jika proyek dan adegan Anda disiapkan untuk digunakan AR Foundation, pilih AR Foundation Subsistem Jangkar sebagai gantinya. Sampel Azure Spatial Anchors menunjukkan konfigurasi yang tepat untuk digunakan AR Foundation (saat ini persyaratan ASA).

Bagian manajemen jangkar dari pengaturan konteks

Menggunakan MRTK dengan WLT di XR SDK

MRTK, selain nilai luar biasa yang disediakannya untuk interaksi pengguna yang abstrak di VR dan AR, sangat menyederhanakan penargetan perangkat melalui XR SDK. Berikut ini adalah catatan yang mungkin terbukti membantu saat menyiapkan MRTK untuk menargetkan perangkat tertentu.

Semua ini mengasumsikan bahwa Subsistem Jangkar Manajemen Jangkar WLT telah ditetapkan dengan tepat seperti yang dijelaskan di bagian sebelumnya.

Pastikan untuk menjalankan Mixed Reality Toolkit => Utilities => UnityAR => Update Scripting Defines saat mengubah target plugin.

Penyiapan untuk Plugin Windows XR (HoloLens)

Lihat instruksi lengkap di Memulai MRTK dan XR SDK.

Jika bekerja dalam proyek WLT, Anda dapat menggunakan WLT yang disediakan "WLT HL2 MRTKProfile" di HoloLens2, atau "WLT AR MRTKProfile" di perangkat seluler, untuk memulai.

WLT yang menggunakan Plugin Windows XR telah diuji pada Unity 2019.4 dan Unity 2020.3, menggunakan versi berikut:

  • Manajemen Plugin XR: v3.2.16 (diharapkan berfungsi dengan v3. X.Y, X >= 2)
  • Plugin Windows XR: v2.4.1 (sebelum jangkar v2.4.1 rusak. Diharapkan berfungsi v2.4.Y, Y>=1, v2. X.Y, X>=1).
  • Plugin Mixed Reality OpenXR: v1.2.0 (versi sebelumnya berfungsi, dengan masalah kecil. Plugin MR OpenXR terbaru sangat disarankan.)

Anda hanya perlu salah satu dari Windows MR Plugin atau Mixed Reality OpenXR Plugin.

Penyiapan untuk Plugin ARCore XR (Android)

Untuk mendapatkan Plugin Android XR yang mengendarai aplikasi AR MRTK, ikuti instruksi di Cara mengonfigurasi MRTK untuk iOS dan Android

CATATAN: Anda memerlukan SEMUA:

  • Manajemen Plugin XR (diuji v3.2.16, v3 yang diharapkan. X.Y, X>=2).
  • Subsistem AR (diuji v2.1.3, v2 yang diharapkan. X.Y, X>1).
  • Plugin AR Core XR (diuji v2.1.12, v2 yang diharapkan. X.Y, X>1).
  • AR Foundation (diuji v2.1.10, diharapkan v2. X.Y, X>1).

Saya sarankan menggunakan WLT yang disediakan "WLT AR MRTKProfile" untuk memulai.

CATATAN: Jika Anda mengalami kesalahan build tentang manifest-merger gagal, ikuti instruksi yang sesuai di sini: https://developers.google.com/ar/develop/unity/android-11-build

Penyiapan untuk Plugin XR lainnya (ARKit, Oculus, dll.)

Penyiapan untuk platform lain mungkin dianalogikan untuk penyiapan ARCore, tetapi belum diuji. Jika Anda memiliki akses ke perangkat tersebut dan kesempatan untuk mencobanya, umpan balik apa pun akan membantu komunitas dan sangat dihargai.