Habilitar funções EasyAR em uma aplicação iOS

Este capítulo descreve como configurar um projeto iOS EasyAR no Xcode sem usar um motor 3D como Unity.

Preparação

Antes de começar, prepare:

• Xcode 16 ou versão posterior

• Obter uma licença EasyAR

• Selecionar uma release version do EasyAR Sense e baixá-la

Habilitar EasyAR com Objective-C

1. Adicionar Frameworks

   Adicione easyar.xcframework em Frameworks, Libraries, and Embedded Content.

   

2. Desabilitar Bitcode

   EasyAR não usa bitcode e não oferece compatibilidade com bitcode, portanto bitcode precisa ser desabilitado na configuração.

   

3. Inicializar EasyAR

   Use o método initialize: de easyar_Engine para inicializar EasyAR. Você pode adicionar o código de inicialização a seguir:

   [easyar_Engine initialize:key];
   

4. Configuração de privacidade

   Como AR precisa usar a câmera, adicione Privacy - Camera Usage Description à configuração de privacidade.

   

   Se for usar a função de gravação de tela, adicione Privacy - Microphone Usage Description à configuração de privacidade.

   

Habilitar EasyAR por meio da Swift API

A EasyAR Sense Swift API é fornecida como código-fonte, o que oferece a melhor compatibilidade (a Apple fornece compatibilidade ABI desde Swift 5).

Para usar a EasyAR Sense Swift API, primeiro crie um projeto framework e depois incorpore o framework target ao seu projeto.

Criar um projeto framework EasyARSwift

1. Crie um novo projeto do tipo Cocoa Touch Framework e nomeie-o EasyARSwift.

   Você pode escolher incorporar o projeto EasyARSwift ao seu projeto app ou criar um projeto independente.

   

2. Importar o código EasyAR Swift para o projeto EasyARSwift

   

   O arquivo EasyARSwift.h gerado automaticamente pelo XCode não é usado e pode ser excluído com segurança.

3. Configurar Objective-C Bridging Header em build settings

   

   Nota

   Esta opção não aparecerá nas opções do XCode antes da importação dos arquivos Swift, portanto importe primeiro o código Swift antes de alterar esta configuração.

4. Importar easyar.xcframework para o projeto EasyARSwift

   

5. Desativar Bitcode

   EasyAR não usa bitcode e não oferece compatibilidade com bitcode, portanto garanta que bitcode esteja desabilitado na configuração.

6. Deployment Target

   Modifique deployment target de acordo com seu projeto app e garanta que o deployment target do projeto EasyARSwift seja menor ou igual ao do projeto app.

Incorporar e usar o framework EasyARSwift

1. Incorpore o framework EasyARSwift ao projeto

   

2. No código-fonte Swift, import EasyARSwift

   

Para o estilo de escrita do código, consulte o código no exemplo HelloARSwift ou API Reference.