Mengaktifkan fitur EasyAR dalam aplikasi iOS

Bab ini menjelaskan cara mengonfigurasi project iOS EasyAR di Xcode tanpa menggunakan 3D engine seperti Unity.

Persiapan

Sebelum memulai, Anda perlu menyiapkan:

• Xcode 16 atau versi lebih baru

• Mendapatkan lisensi EasyAR

• Memilih release version EasyAR Sense dan mengunduhnya

Mengaktifkan EasyAR dengan Objective-C

1. Tambahkan Frameworks

   Tambahkan easyar.xcframework di Frameworks, Libraries, and Embedded Content.

   

2. Nonaktifkan Bitcode

   EasyAR tidak menggunakan bitcode dan tidak menyediakan kompatibilitas bitcode, sehingga bitcode perlu dinonaktifkan dalam konfigurasi.

   

3. Inisialisasi EasyAR

   Gunakan metode initialize: dari easyar_Engine untuk menginisialisasi EasyAR. Anda dapat menambahkan kode inisialisasi sebagai berikut:

   [easyar_Engine initialize:key];
   

4. Konfigurasi privasi

   Karena AR perlu menggunakan kamera, tambahkan Privacy - Camera Usage Description ke konfigurasi privasi.

   

   Jika ingin menggunakan fungsi screen recording, tambahkan Privacy - Microphone Usage Description ke konfigurasi privasi.

   

Mengaktifkan EasyAR melalui Swift API

EasyAR Sense Swift API disediakan dalam bentuk source code, sehingga dapat memberikan kompatibilitas terbaik (Apple menyediakan kompatibilitas ABI sejak Swift 5).

Untuk menggunakan EasyAR Sense Swift API, pertama buat project framework, lalu embed framework target ke dalam project Anda.

Membuat project framework EasyARSwift

1. Buat project baru bertipe Cocoa Touch Framework dan beri nama EasyARSwift.

   Anda dapat memilih untuk menanamkan project EasyARSwift ke dalam project app Anda atau membuat project independen.

   

2. Impor kode EasyAR Swift ke project EasyARSwift

   

   File EasyARSwift.h yang otomatis dibuat oleh XCode tidak digunakan dan dapat dihapus dengan aman.

3. Konfigurasikan Objective-C Bridging Header di build settings

   

   Catatan

   Opsi ini tidak akan muncul dalam opsi XCode sebelum file Swift diimpor, jadi pastikan untuk mengimpor kode Swift terlebih dahulu sebelum mengubah konfigurasi ini.

4. Impor easyar.xcframework ke project EasyARSwift

   

5. Nonaktifkan Bitcode

   EasyAR tidak menggunakan bitcode dan tidak menyediakan kompatibilitas bitcode, jadi pastikan bitcode dinonaktifkan dalam konfigurasi.

6. Deployment Target

   Ubah deployment target sesuai project app Anda, dan pastikan deployment target project EasyARSwift lebih kecil atau sama dengan project app.

Embed dan menggunakan framework EasyARSwift

1. Embed framework EasyARSwift di project

   

2. import EasyARSwift dalam source code Swift

   

Untuk cara penulisan kode, lihat kode dalam sampel HelloARSwift atau API Reference.