EasyAR-Funktionen in einer iOS-App aktivieren

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

Vorbereitung

Bereiten Sie vor dem Start Folgendes vor:

• Xcode 16 oder neuer

• Eine EasyAR-Lizenz erhalten

• Eine EasyAR Sense-release version auswählen und herunterladen

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, daher muss bitcode in der Konfiguration deaktiviert werden.

   

3. EasyAR initialisieren

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

   [easyar_Engine initialize:key];
   

4. Datenschutzkonfiguration

   Da AR die Kamera verwenden muss, fügen Sie Privacy - Camera Usage Description zur Datenschutzkonfiguration hinzu.

   

   Wenn Bildschirmaufnahme verwendet werden soll, fügen Sie Privacy - Microphone Usage Description zur Datenschutzkonfiguration hinzu.

   

EasyAR über die Swift API aktivieren

Die EasyAR Sense Swift API wird als Quellcode bereitgestellt, wodurch die beste Kompatibilität erreicht wird (Apple bietet seit Swift 5 ABI-Kompatibilität).

Um die EasyAR Sense Swift API zu verwenden, erstellen Sie zuerst ein framework-Projekt und betten dann das framework target in Ihr Projekt ein.

Ein EasyARSwift-framework-Projekt erstellen

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

   Sie können wählen, ob Sie das EasyARSwift-Projekt in Ihr app-Projekt einbetten oder ein eigenständiges Projekt erstellen.

   

2. EasyAR Swift-Code in das EasyARSwift-Projekt importieren

   

   Die automatisch von XCode erzeugte Datei EasyARSwift.h wird nicht verwendet und kann sicher gelöscht werden.

3. Objective-C Bridging Header in den build settings konfigurieren

   

   Anmerkung

   Diese Option erscheint nicht in den XCode-Optionen, bevor Swift-Dateien importiert wurden. Importieren Sie daher unbedingt zuerst den Swift-Code, bevor Sie diese Konfiguration ändern.

4. easyar.xcframework in das EasyARSwift-Projekt importieren

   

5. Bitcode deaktivieren

   EasyAR verwendet kein bitcode und bietet keine bitcode-Kompatibilität. Stellen Sie daher sicher, dass bitcode in der Konfiguration deaktiviert ist.

6. Deployment Target

   Ändern Sie deployment target entsprechend Ihrem app-Projekt und 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 das Projekt ein

   

2. In Swift-Quellcode import EasyARSwift

   

Zur Schreibweise des Codes können Sie den Code im Beispiel HelloARSwift oder die API Reference heranziehen.