Table of Contents

Migrasi aplikasi Unity dari EasyAR Sense Unity plugin versi 4.2 dan lebih lama

Mulai dari versi 4.3, plugin Unity didistribusikan dan dikelola melalui Unity Package Manager, dengan struktur paket plugin yang mengalami penyesuaian signifikan. Oleh karena itu, saat meningkatkan dari versi 4.2 atau lebih rendah ke versi 4.3 dan lebih tinggi, diperlukan langkah-langkah tambahan.

Langkah migrasi

Saat meningkatkan dari versi 4.2 atau lebih rendah, Anda perlu:

  1. Hapus semua file plugin versi lama, yang mungkin terdapat dalam folder Assets/EasyAR, Assets/Plugins, Assets/Samples, dan Assets/StreamingAssets.
  2. Kemudian impor versi baru melalui Package Manager window Unity.
  3. Perbarui scene dan kode berdasarkan panduan migrasi untuk setiap versi di bawah ini.

Migrasi ke versi 4000 dan yang lebih baru

Migrasi ke versi 4000 dan yang lebih baru memerlukan modifikasi berikut.

Lihat Membuat dan mengkonfigurasi AR session untuk membuat ulang struktur scene.

Perubahan terkait:

  • prefab telah dihapus.
  • VIOCameraDeviceUnion telah dihapus.

Penggunaan AR Foundation memerlukan referensi Mengaktifkan AR Foundation di proyek EasyAR untuk menggunakan AR Foundation.

Perubahan terkait:

  • Dukungan AR Foundation telah diimplementasikan ulang.

Anda tidak dapat menggunakan EasyAR di perangkat XREAL X dan XREAL Light, disarankan untuk beralih ke XREAL Air2 Ultra.

Perubahan terkait:

  • Nreal/XREAL X dan Nreal/XREAL Light tidak lagi didukung.
  • Dukungan XREAL telah dibangun ke dalam EasyAR Sense, mendukung XREAL Air2 Ultra.

Lihat Migrasi ke 4000 untuk melanjutkan pekerjaan migrasi.

Versi 4000 memiliki lebih banyak perubahan dibandingkan versi 4.x.

Migrasi ke versi 4.6

Peringatan

Versi 4.6 tidak lagi dipelihara, disarankan untuk langsung upgrade ke 4000 atau versi lebih baru. Dokumentasi pengembangan Unity lengkap di situs web EasyAR disiapkan untuk versi 4000 dan lebih tinggi.

Migrasi ke versi 4.6 memerlukan modifikasi berikut.

Disarankan merujuk ke sampel versi 4.6 untuk memahami struktur scene baru, dan membuat ulang komponen terkait.

Perubahan terkait:

  • prefab telah dihapus.
  • VIOCameraDeviceUnion telah dihapus.
  • Dukungan AR Foundation telah dipisahkan menjadi paket independen.

Jika tidak perlu menggunakan AR Foundation, hapus node AR Foundation di bawah AR Session dalam scene dan penggunaan ARFoundationFrameSource dalam kode.

Perubahan terkait:

  • Dukungan AR Foundation telah dipisahkan menjadi paket independen.

Jika tidak perlu menggunakan Nreal, hapus node Nreal di bawah AR Session dalam scene dan penggunaan NrealFrameSource dalam kode. Penggunaan Nreal tidak lagi memerlukan pembuatan paket virtual.

Perubahan terkait:

  • Dukungan Nreal telah dipisahkan menjadi paket independen.

Disarankan merujuk ke dokumentasi antarmuka dalam skrip dan sampel versi 4.6 untuk memahami perubahan dan cara penggunaan antarmuka, serta melakukan penyesuaian yang sesuai.

Perubahan terkait:

  • Beberapa antarmuka skrip lainnya juga berubah.
  • Beberapa metode publik ditandai sebagai internal dalam komentar XML, hindari menggunakan antarmuka ini karena telah dihapus dalam versi 4000.

Migrasi ke versi 4.4

Peringatan

Versi 4.4 tidak lagi dipelihara, disarankan untuk langsung upgrade ke 4000 atau versi lebih baru. Dokumentasi pengembangan Unity lengkap di situs web EasyAR disiapkan untuk versi 4000 dan lebih tinggi.

Migrasi ke versi 4.4 memerlukan perhatian pada modifikasi berikut.

Perlu menghapus referensi ke prefab dalam paket plugin sebanyak mungkin. Jika terus menggunakan prefab ini, Anda akan melihat log peringatan yang berisi panduan singkat tentang alternatifnya di plugin baru. Disarankan merujuk ke sampel versi 4.4 untuk memahami struktur scene baru.

Perubahan terkait:

  • prefab telah ditandai sebagai usang dan dihapus dalam versi 4.6.

Hentikan penggunaan VIOCameraDeviceUnion. Jika terus menggunakan komponen ini, akan muncul log peringatan yang berisi panduan singkat tentang alternatifnya di plugin baru. Disarankan merujuk ke sampel versi 4.4 untuk memahami struktur scene baru.

Perubahan terkait:

  • VIOCameraDeviceUnion telah ditandai sebagai usang dan dihapus dalam versi 4.6.

Disarankan merujuk ke dokumentasi antarmuka dalam skrip dan sampel versi 4.4 untuk memahami perubahan dan cara penggunaan antarmuka, serta melakukan penyesuaian yang sesuai.

Perubahan terkait:

  • Beberapa antarmuka skrip lainnya juga berubah.
  • Beberapa metode publik ditandai sebagai internal dalam komentar XML, hindari menggunakan antarmuka ini karena telah dihapus dalam versi 4000.