Mengaktifkan fitur EasyAR di aplikasi iOS

Bab ini menjelaskan cara mengkonfigurasi proyek iOS EasyAR di Xcode, tanpa menggunakan mesin 3D seperti Unity.

Persiapan

Sebelum memulai, Anda perlu menyiapkan:

• Xcode 16 atau versi lebih baru
• Mendapatkan lisensi EasyAR
• Memilih rilis EasyAR Sense dan mengunduhnya

Mengaktifkan EasyAR menggunakan Objective-C

1. Menambahkan Frameworks

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

   

2. Menonaktifkan Bitcode

   EasyAR tidak menggunakan bitcode dan tidak menyediakan kompatibilitas bitcode, perlu menonaktifkan bitcode di konfigurasi.

   

3. Menginisialisasi 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 menggunakan kamera, konfigurasi privasi perlu menambahkan Privacy - Camera Usage Description,

   

   Jika ingin menggunakan fitur perekaman layar, konfigurasi privasi perlu menambahkan Privacy - Microphone Usage Description,

   

Mengaktifkan EasyAR melalui Swift API

EasyAR Sense Swift API disediakan dalam bentuk kode sumber, memberikan kompatibilitas terbaik (Apple menyediakan kompatibilitas ABI sejak Swift 5).

Menggunakan EasyAR Sense Swift API memerlukan pembuatan proyek framework terlebih dahulu, kemudian menanamkan framework target ke dalam proyek Anda.

Membuat proyek framework EasyARSwift

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

   Anda dapat memilih untuk menanamkan proyek EasyARSwift ke dalam proyek aplikasi Anda atau membuat proyek terpisah.

   

2. Impor kode Swift EasyAR ke proyek EasyARSwift

   

   File EasyARSwift.h yang dihasilkan otomatis oleh XCode tidak digunakan, dapat dihapus dengan aman.

3. Konfigurasikan Objective-C Bridging Header di build settings

   

   [!CATATAN] Opsi ini tidak akan ditampilkan di opsi XCode sebelum file swift diimpor, jadi pastikan mengimpor kode Swift terlebih dahulu sebelum mengubah konfigurasi.

4. Impor easyar.xcframework ke proyek EasyARSwift

   

5. Matikan Bitcode

   EasyAR tidak menggunakan bitcode dan tidak menyediakan kompatibilitas bitcode, pastikan untuk menonaktifkan bitcode di konfigurasi.

6. Deployment Target

   Sesuaikan deployment target berdasarkan proyek aplikasi Anda, pastikan deployment target proyek EasyARSwift lebih kecil atau sama dengan proyek aplikasi.

Menanamkan dan menggunakan framework EasyARSwift

1. Tanamkan framework EasyARSwift di proyek

   

2. import EasyARSwift di kode sumber Swift

   

Cara penulisan kode dapat merujuk pada contoh kode di sampel HelloARSwift atau API Reference.