Enable EasyAR-Funktionen in iOS-Apps

Dieses Kapitel beschreibt, wie Sie ein EasyAR-iOS-Projekt in Xcode konfigurieren, ohne eine 3D-Engine wie Unity zu verwenden.

Vorbereitungen

Vor Beginn benötigen Sie:

• Xcode 16 oder eine neuere Version
• Eine EasyAR-Lizenzschlüssel
• Auswahl einer EasyAR Sense-Releaseversion und Download

EasyAR mit Objective-C aktivieren

1. Frameworks hinzufügen

   Fügen Sie easyar.xcframework unter Frameworks, Libraries, and Embedded Content hinzu.

   

2. Bitcode deaktivieren

   EasyAR verwendet kein Bitcode und bietet keine Bitcode-Kompatibilität. Bitcode muss in den Einstellungen deaktiviert werden.

   

3. EasyAR initialisieren

   Verwenden Sie die Methode initialize: von easyar_Engine, um EasyAR zu initialisieren. Sie können Initialisierungscode wie folgt hinzufügen:

   [easyar_Engine initialize:key];
   

4. Datenschutzkonfiguration

   Da AR die Kamera verwendet, muss der Datenschutzkonfiguration Privacy - Camera Usage Description hinzugefügt werden.

   

   Wenn Sie die Bildschirmaufzeichnungsfunktion verwenden möchten, muss der Datenschutzkonfiguration Privacy - Microphone Usage Description hinzugefügt werden.

   

EasyAR über die Swift-API aktivieren

Die EasyAR Sense Swift API wird als Quellcode bereitgestellt, um die beste Kompatibilität zu gewährleisten (Apple bietet ABI-Kompatibilität ab Swift 5).

Um die EasyAR Sense Swift API zu verwenden, müssen Sie zunächst ein Framework-Projekt erstellen und dann das Framework-Target in Ihr Projekt einbetten.

EasyARSwift-Framework-Projekt erstellen

1. Erstellen Sie ein neues Projekt vom Typ "Cocoa Touch Framework" und nennen Sie es EasyARSwift.

   Sie können das EasyARSwift-Projekt in Ihr App-Projekt einbetten oder ein separates Projekt erstellen.

   

2. Importieren Sie den EasyAR-Swift-Code in das EasyARSwift-Projekt.

   

   Die von Xcode generierte Datei EasyARSwift.h wird nicht verwendet und kann sicher gelöscht werden.

3. Konfigurieren Sie Objective-C Bridging Header in den Buildeinstellungen.

   

   Anmerkung

   Diese Option wird in den Xcode-Optionen erst angezeigt, nachdem Sie die Swift-Dateien importiert haben. Stellen Sie daher sicher, dass Sie zuerst den Swift-Code importieren, bevor Sie diese Einstellung ändern.

4. Importieren Sie easyar.xcframework in das EasyARSwift-Projekt.

   

5. Bitcode deaktivieren

   EasyAR verwendet kein Bitcode und bietet keine Bitcode-Kompatibilität. Stellen Sie sicher, dass Bitcode in den Einstellungen deaktiviert ist.

6. Deployment Target

   Ändern Sie das deployment target entsprechend Ihrem App-Projekt. Stellen Sie sicher, dass das deployment target des EasyARSwift-Projekts kleiner oder gleich dem des App-Projekts ist.

EasyARSwift-Framework einbetten und verwenden

1. Betten Sie das EasyARSwift-Framework in Ihr Projekt ein.

   

2. Importieren Sie EasyARSwift im Swift-Quellcode.

   

Die Schreibweise des Codes kann dem Beispielcode in HelloARSwift oder der API-Referenz entnommen werden.