Включение функций EasyAR в iOS-приложении

В этой главе описано, как настроить iOS-проект EasyAR в Xcode без использования 3D-движка, такого как Unity.

Подготовка

Перед началом подготовьте:

• Xcode 16 или новее

• Получите лицензию EasyAR

• Выберите release version EasyAR Sense и загрузите ее

Включение EasyAR с Objective-C

1. Добавьте Frameworks

   Добавьте easyar.xcframework в Frameworks, Libraries, and Embedded Content.

   

2. Отключите Bitcode

   EasyAR не использует bitcode и не предоставляет совместимость с bitcode, поэтому bitcode нужно отключить в конфигурации.

   

3. Инициализируйте EasyAR

   Используйте метод initialize: у easyar_Engine для инициализации EasyAR. Можно добавить следующий код инициализации:

   [easyar_Engine initialize:key];
   

4. Настройка конфиденциальности

   Поскольку AR должен использовать камеру, добавьте Privacy - Camera Usage Description в настройки конфиденциальности.

   

   Если используется запись экрана, добавьте Privacy - Microphone Usage Description в настройки конфиденциальности.

   

Включение EasyAR через Swift API

EasyAR Sense Swift API предоставляется в виде исходного кода, что обеспечивает наилучшую совместимость (Apple предоставляет ABI-совместимость начиная со Swift 5).

Чтобы использовать EasyAR Sense Swift API, сначала создайте framework-проект, затем встроите framework target в свой проект.

Создание framework-проекта EasyARSwift

1. Создайте новый проект типа Cocoa Touch Framework и назовите его EasyARSwift.

   Вы можете встроить проект EasyARSwift в свой app-проект или создать независимый проект.

   

2. Импортируйте код EasyAR Swift в проект EasyARSwift

   

   Файл EasyARSwift.h, автоматически созданный XCode, не используется и может быть безопасно удален.

3. Настройте Objective-C Bridging Header в build settings

   

   Примечание

   Этот параметр не появится в настройках XCode до импорта Swift-файлов, поэтому обязательно сначала импортируйте Swift-код, а затем изменяйте эту конфигурацию.

4. Импортируйте easyar.xcframework в проект EasyARSwift

   

5. Отключите Bitcode

   EasyAR не использует bitcode и не предоставляет совместимость с bitcode, поэтому убедитесь, что bitcode отключен в конфигурации.

6. Deployment Target

   Измените deployment target согласно вашему app-проекту и убедитесь, что deployment target проекта EasyARSwift меньше или равен app-проекту.

Встроить и использовать framework EasyARSwift

1. Встройте framework EasyARSwift в проект

   

2. В исходном коде Swift выполните import EasyARSwift

   

По стилю написания кода можно ориентироваться на код в примере HelloARSwift или API Reference.