Habilitando recursos EasyAR em aplicativos iOS

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

Preparativos

Antes de começar, você precisa preparar:

• Xcode 16 ou versão mais recente
• Obter uma licença EasyAR
• Escolher uma versão de lançamento do EasyAR Sense e fazer o download

Habilitando EasyAR usando Objective-C

1. Adicionar Frameworks

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

   

2. Desabilitar Bitcode

   O EasyAR não usa bitcode nem fornece compatibilidade com bitcode, portanto, é necessário desativar o bitcode nas configurações.

   

3. Inicializar EasyAR

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

   [easyar_Engine initialize:key];
   

4. Configurações de privacidade

   Como a AR requer o uso da câmera, a configuração de privacidade precisa incluir Privacy - Camera Usage Description,

   

   Se for usar gravação de tela, a configuração de privacidade precisa incluir Privacy - Microphone Usage Description,

   

Habilitando EasyAR via Swift API

A Swift API do EasyAR Sense é fornecida na forma de código-fonte, o que oferece a melhor compatibilidade (a Apple fornece compatibilidade ABI a partir do Swift 5).

Para usar a Swift API do EasyAR Sense, você primeiro precisa criar um projeto de framework e, em seguida, incorporar o framework target ao seu projeto.

Criando projeto de framework EasyARSwift

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

   Você pode optar por incorporar o projeto EasyARSwift no seu projeto de aplicativo ou criar um projeto separado.

   

2. Importe o código Swift do EasyAR para o projeto EasyARSwift

   

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

3. Configure Objective-C Bridging Header nas definições de build

   

   Nota

   Esta opção não aparece nas opções do XCode até que os arquivos swift sejam importados, portanto, certifique-se de primeiro importar o código Swift antes de alterar a configuração.

4. Importe easyar.xcframework para o projeto EasyARSwift

   

5. Desative Bitcode

   O EasyAR não usa bitcode nem fornece compatibilidade com bitcode, portanto, é necessário desativar o bitcode nas configurações.

6. Deployment Target

   Modifique o deployment target de acordo com o seu projeto de aplicativo, garantindo que o deployment target do projeto EasyARSwift seja menor ou igual ao do projeto de aplicativo.

Incorporando e usando o framework EasyARSwift

1. Incorporar o framework EasyARSwift no projeto

   

2. Faça import EasyARSwift no código Swift

   

A forma de escrever o código pode ser consultada no exemplo HelloARSwift ou na API Reference.