Table of Contents

Inicializar EasyAR Sense com chave de licença

No Unity com EasyAR, é necessário inicializar o EasyAR Sense com uma chave de licença para ativar as funcionalidades. Existem duas formas de inicialização: automática e manual.

Após inicialização bem-sucedida, informações como versão e plataforma do EasyAR Sense podem ser vistas no console do Unity ou nos logs do sistema operacional, por exemplo:

EasyAR Sense (Android-arm64) Version 4.7.0.11800-cf8e24e30

Antes de começar

  • Licença do EasyAR Sense descreve como obter uma licença (chave de licença). Antes de inicializar o EasyAR Sense, é necessário preparar uma licença adequada conforme os dispositivos utilizados e a fase de desenvolvimento.

Inicialização automática

A inicialização automática é adequada para a maioria dos cenários.

Abra Configurações globais do EasyAR, marque a opção Initialize On Startup e preencha EasyAR Sense License > LicenseKey

alt text

A inicialização automática ocorre automaticamente no ponto de tempo BeforeSceneLoad do Unity.

Nota

A licença usada no editor não valida o nome do pacote da aplicação, portanto, uma licença que funciona no editor pode falhar quando empacotada na plataforma ou app. Atenção a dois casos:

  1. O nome do pacote na licença deve corresponder ao bundle id/package name configurado nas Player Settings do Unity.
  2. Se o nome do pacote for modificado no projeto gradle ou XCode após empacotamento pelo Unity, utilize o nome do pacote definido no gradle ou XCode dentro do Unity.

[Opcional] Inicialização manual

A inicialização manual é usada principalmente para fluxos personalizados, como exibir termos de privacidade antes de chamar APIs do EasyAR (consulte Guia de conformidade).

Abra Configurações globais do EasyAR e desmarque a opção Initialize On Startup.

alt text

Em seguida, use a interface EasyARController.Initialize() para inicialização manual.

É possível passar a licença por parâmetro:

EasyARController.Initialize("my-license");

Ou usar a licença preenchida nas Configurações globais do EasyAR:

EasyARController.Initialize();
Importante

EasyARController.Initialize() deve ser chamado antes de iniciar o ARSession.

Em casos especiais onde EasyARController.Initialize() é chamado múltiplas vezes, é necessário chamar EasyARController.Deinitialize() após cada inicialização para desinicializar.

Resolução de falhas na inicialização

Se, após executar uma cena contendo ARSession, logs semelhantes não forem exibidos, a inicialização falhou.

EasyAR Sense (Android-arm64) Version 4.7.0.11800-cf8e24e30

No editor do Unity, pode aparecer um pop-up como:

alt text

Nota

Leia atentamente a mensagem no pop-up, pois nem todos indicam falha na inicialização.

Mensagens de erro comuns e causas:

  • EasyARSettings is not found
    • Arquivo de recurso Configurações globais do EasyAR não encontrado (comum quando a licença não foi preenchida)
  • License Key is empty
    • Licença não preenchida nas Configurações globais do EasyAR, ou múltiplos arquivos de recurso existentes no projeto
  • EasyARController.Initialize is not called (InitializeOnStartup = false)
    • Inicialização manual não chamada no momento correto
  • EasyAR stops after script change in play mode
    • Scripts modificados durante execução no editor. Reinicie a execução

Tópicos relacionados