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

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

Подготовка

Перед началом вам потребуется:

• Xcode 16 или новее
• Получить лицензионный ключ EasyAR
• Выбрать релизную версию EasyAR Sense и скачать её

Включение EasyAR с использованием Objective-C

1. Добавление Frameworks

   В разделе Frameworks, Libraries, and Embedded Content добавьте easyar.xcframework.

   

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

   EasyAR не использует 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

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

Для использования Swift API EasyAR Sense сначала создайте проект framework, затем встройте target этого framework в ваш проект.

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

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

   Вы можете выбрать встраивание проекта EasyARSwift в ваш проект приложения или создание отдельного проекта.

   

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

   

   Автоматически сгенерированный Xcode файл EasyARSwift.h не используется и может быть удален.

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

   

   Примечание

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

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

   

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

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

6. Deployment Target

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

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

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

   

2. В Swift-коде добавьте import EasyARSwift

   

Примеры написания кода можно найти в образце HelloARSwift или в API Reference.