Bagikan melalui

Menggunakan Alat Fitur Mixed Reality untuk menginstal Alat Penguncian Dunia

  • Artikel

Alat Fitur MR

Mixed Reality Feature Tool bisa menjadi cara yang sangat berguna untuk mendapatkan World Locking Tools, serta paket Mixed Reality berharga lainnya untuk Unity.

Informasi lebih lanjut tentang Alat Fitur MR dapat ditemukan dalam dokumentasi onlinenya, tetapi sangat mudah digunakan.

Cuplikan layar Alat Fitur Mixed Reality

Menginstal WLT melalui Alat Fitur MR

Untuk mendapatkan fungsionalitas WLT lengkap, cukup pilih versi terbaru "Alat Penguncian Dunia" dari Alat Fitur MR. Kemudian lanjutkan untuk menambahkan WLT ke adegan, atau panduan mulai cepat.

Jika mendapatkan sampel (yang juga memerlukan MRTK), tidak perlu menginstal dependensi terlebih dahulu. Cukup pilih paket Sampel dan set minimal dependensi yang diperlukan juga akan diinstal. Tapi lihat di bawah ini.

Catatan

TL; Versi DR - Jika menginstal dari MR Feature Tool, Anda harus menginstal ke folder yang panjang jalurnya 11 karakter atau kurang, termasuk drive. Ini dijelaskan secara lebih rinci di akhir artikel ini. Jadi e:\stuff\T1 akan berhasil, tapi e:\stuff\T12 tidak akan.

Sampel dalam ALAT Fitur MR (paket bisa-tulis)

Seperti disebutkan di atas, Mr Feature Tool dan UPM menginstal paket sebagai sumber daya baca-saja. Untuk sampel, itu tidak nyaman, karena banyak nilai sampel dalam memasok aset volatil yang dapat dimodifikasi untuk eksperimen.

Untuk mengaktifkan ini, sampel yang diinstal oleh MR Feature Tool (atau UPM) mengikuti jalur yang sedikit berbeda. Menginstalnya adalah proses dua bagian.

Bagian pertama berlanjut sama seperti menginstal paket baca-saja. Namun, setelah penginstalan tersebut, sampel belum akan muncul di Aset atau Paket.

Untuk menyelesaikan impor sampel ke dalam proyek Anda:

  1. Buka Unity Package Manager

  2. Jika Manajer Paket diatur ke "Unity Registry", ubah menjadi "Dalam Proyek"

    Manajer paket Dalam Proyek

  3. Temukan Sampel yang ingin Anda selesaikan penginstalannya. Di sini kami menargetkan "Sampel Penguncian Dunia v1.2.4".

    Tombol Impor ke dalam proyek

  4. Tekan tombol "Impor ke proyek".

  5. Contoh sekarang akan muncul di bawah folder Sampel di Aset, seperti yang ditunjukkan di sini. Mereka dapat direlokasi agar sesuai dengan organisasi proyek Anda.

    Sampel yang ditunjukkan dalam proyek Unity

Perbedaan antara metode penginstalan

Ada beberapa pertimbangan halang saat memutuskan metode penginstalan mana yang akan digunakan.

Alat Fitur MR (paket UPM)

Driver utama untuk MR Feature Tool adalah dependensi paket. Paket di ALAT Fitur MR dapat menentukan paket lain yang perlu diinstal agar berfungsi dengan baik. Alat Fitur kemudian dapat memperoleh dan menginstal, bukan hanya paket yang Anda minta, tetapi juga semua dependensinya. Setelah Alat Fitur memproses penginstalan yang Anda minta, tidak ada penginstalan lain yang perlu Anda lacak.

Perbedaan terbesar antara sumber daya yang diperoleh melalui MR Feature Tool (atau UPM) versus sumber daya yang diperoleh dari file .unitypackage, adalah bahwa yang pertama diinstal hanya tulis, sedangkan yang terakhir dihilangkan seperti sumber daya Anda sendiri.

Perhatikan bahwa saat memperoleh WLT melalui Alat Fitur, DLL Mesin Dunia Beku dibawa sebagai dependensi. Tidak diperlukan penginstalan manual melalui NuGet.

Rilis WLT (file.unitypackage)

WLT menerbitkan rilis berkala, yang dianggap sebagai rekam jepret yang sangat stabil. Ini tersedia di halaman Rilis Alat Penguncian Dunia.

Seperti disebutkan di atas, hasil impor file .unitypackage ini ke dalam proyek Anda sama seperti jika Anda menyalin di sumber (lihat di bawah). Skrip dan aset dapat ditulis, dan dapat diatur ulang agar sesuai dengan struktur Anda.

Rantai dependensi sangat sederhana, tetapi merupakan tanggung jawab klien penginstalan (Anda) untuk menginstal dependensi serta paket yang Anda inginkan.

Grafik dependensi sederhana bersifat linier. Dalam daftar berikut, setiap item bergantung pada setiap item di atasnya, tetapi tidak ada item di bawahnya:

  1. DLL Mesin Dunia Beku (dari NuGet, lihat instruksi penginstalan)
  2. Mesin Inti Penguncian Dunia
  3. Alat Penguncian Dunia
  4. Sampel Penguncian Dunia (juga tergantung pada MRTK, tetapi MRTK disertakan dalam .unitypackage)

Dari kode GitHub (salin di sumber)

Opsi lain untuk memperoleh WLT adalah mendapatkan sumber langsung dari GitHub (baik melalui git atau sebagai zipfile) dan menyalinnya ke dalam proyek Anda. Ini setara dengan menginstal dari .unitypackages di atas.

Untuk mendapatkan sumber yang cocok dengan rilis, temukan cabang yang sesuai. Misalnya, sumber untuk rilis v1.2.4 berada di cabang release/v1.2.4.

Tentang batas panjang jalur penginstalan

Saat menginstal dari Alat Fitur Mixed Reality

Windows memberlakukan panjang jalur maksimum 260 karakter. Paket Frozen World Engine memiliki beberapa jalur internal yang sangat panjang. Alat Fitur Mixed Reality (atau UPM Unity, tergantung siapa yang ingin Anda salahkan), menambahkan beberapa string yang sangat panjang di tengah.

Anda akan tahu apakah Anda telah melewati batas MAX_PATH jika Anda melihat kesalahan di Konsol Unity yang mengeluh tentang tidak dapat menemukan bagian dari jalur.

Kesalahan jalur panjang

Sekali lagi, jalur e:\stuff\T1 penginstalan akan berfungsi, tetapi e:\stuff\T12 akan terlalu panjang.

Ironisnya, file pertama yang mencapai batas bahkan tidak digunakan pada Windows, itu untuk build iOS (iOS tidak memiliki batas MAX_PATH). WLT akan membangun dan berjalan dengan baik tanpanya. Namun, keberadaan file akan mengganggu berjalannya beberapa skrip MRTK penting, dan mungkin mendesstabilisasi Unity dengan cara halus lainnya.

Saat menginstal dari file .unitypackage atau dari github

Tanpa UPM/MRFeatureTool memasukkan karakter ke dalam jalur instalasi, ada sedikit lebih banyak ruang pernapasan. Namun, hierarki jalur internal dalam Mesin Dunia Beku masih cukup dalam. Saat menginstal dari file unitypackage atau dari github, folder penginstalan harus panjangnya sekitar 100 karakter atau kurang.

Ada lebih banyak penyelidikan dan diskusi dalam masalah WLT ini.