Table of Contents

Memigrasikan aplikasi Unity dari EasyAR Sense Unity Plugin 4.2 dan versi yang lebih lama

Mulai versi 4.3, plugin Unity didistribusikan dan dikelola melalui Unity Package Manager, dan struktur paket plugin mengalami penyesuaian besar. Oleh karena itu, saat meningkatkan dari 4.2 atau versi yang lebih lama ke 4.3 atau versi yang lebih baru, diperlukan beberapa langkah tambahan.

Langkah migrasi

Saat meningkatkan dari versi 4.2 atau yang lebih lama, Anda perlu:

  1. Menghapus semua file plugin versi lama. File ini mungkin berada di 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 sesuai panduan migrasi tiap versi di bawah ini.

Migrasi ke 4000 dan versi yang lebih baru

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

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

Perubahan terkait:

  • prefab telah dihapus.
  • VIOCameraDeviceUnion telah dihapus.

Untuk menggunakan AR Foundation, lihat Mengaktifkan AR Foundation dalam proyek EasyAR.

Perubahan terkait:

  • Dukungan AR Foundation telah diimplementasikan ulang.

Anda tidak dapat menggunakan EasyAR pada perangkat XREAL X dan XREAL Light. Disarankan beralih ke XREAL Air2 Ultra.

Perubahan terkait:

  • Nreal/XREAL X dan Nreal/XREAL Light tidak lagi didukung.
  • Dukungan XREAL sudah terintegrasi dalam EasyAR Sense dan mendukung XREAL Air2 Ultra.

Lihat Migrasi ke 4000 untuk pekerjaan migrasi berikutnya.

Versi 4000 memiliki lebih banyak perubahan dibandingkan 4.x.

Migrasi ke versi 4.6

Peringatan

Versi 4.6 tidak lagi dipelihara. Disarankan langsung meningkatkan ke 4000 atau versi yang lebih baru. Dokumentasi pengembangan Unity yang rinci di situs web EasyAR disiapkan untuk versi 4000 dan yang lebih baru.

Migrasi ke versi 4.6 memerlukan perubahan 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 package independen.

Jika AR Foundation tidak diperlukan, Anda dapat menghapus node AR Foundation di bawah AR Session dalam scene serta penggunaan ARFoundationFrameSource dalam kode.

Perubahan terkait:

  • Dukungan AR Foundation telah dipisahkan menjadi package independen.

Jika Nreal tidak diperlukan, Anda dapat menghapus node Nreal di bawah AR Session dalam scene serta penggunaan NrealFrameSource dalam kode. Saat menggunakan Nreal, Anda tidak lagi perlu membuat package virtual.

Perubahan terkait:

  • Dukungan Nreal telah dipisahkan menjadi package independen.

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

Perubahan terkait:

  • Beberapa API skrip lainnya juga berubah.
  • Beberapa metode publik ditandai sebagai internal dalam komentar XML. Hindari menggunakan API ini. API tersebut telah dihapus pada versi 4000.

Migrasi ke versi 4.4

Peringatan

Versi 4.4 tidak lagi dipelihara. Disarankan langsung meningkatkan ke 4000 atau versi yang lebih baru. Dokumentasi pengembangan Unity yang rinci di situs web EasyAR disiapkan untuk versi 4000 dan yang lebih baru.

Saat migrasi ke versi 4.4, perhatikan perubahan berikut.

Sebisa mungkin hapus referensi ke prefab di dalam paket plugin. Jika tetap menggunakan prefab tersebut, log peringatan akan ditampilkan, dan log tersebut berisi panduan singkat tentang cara menggantinya di plugin baru. Disarankan merujuk ke sampel versi 4.4 untuk memahami struktur scene baru.

Perubahan terkait:

  • prefab telah ditandai usang dan dihapus pada versi 4.6.

Hapus penggunaan VIOCameraDeviceUnion. Jika tetap menggunakan komponen ini, log peringatan akan ditampilkan, dan log tersebut berisi panduan singkat tentang cara menggantinya di plugin baru. Disarankan merujuk ke sampel versi 4.4 untuk memahami struktur scene baru.

Perubahan terkait:

  • VIOCameraDeviceUnion telah ditandai usang dan dihapus pada versi 4.6.

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

Perubahan terkait:

  • Beberapa API skrip lainnya juga berubah.
  • Beberapa metode publik ditandai sebagai internal dalam komentar XML. Hindari menggunakan API ini. API tersebut telah dihapus pada versi 4000.