Table of Contents

Configuração do EasyAR

A página de configuração do EasyAR pode ser acessada através do menu do Unity EasyAR > Sense > Configuration ou Edit > Project Settings > EasyAR.

alt text

Aqui estão todas as configurações globais do EasyAR Sense Unity Plugin.

alt text

Inicializar na inicialização

Inicialize o EasyAR na inicialização. Geralmente, é recomendado manter essa opção ativada.

Se essa opção for desativada, você precisará inicializar o EasyAR Sense manualmente. Para obter mais informações, consulte Inicializar o EasyAR Sense.

EasyAR Sense License

Configurações relacionadas à licença do EasyAR Sense.

LicenseKey

Chave de licença do EasyAR Sense. É obrigatório preencher uma licença válida para utilizar as funcionalidades do EasyAR.

Pode ser deixado em branco apenas quando o EasyAR Sense é inicializado manualmente via interface.

Nota

Ao utilizar em dispositivos head-mounted (Vision Pro, XREAL, Pico, Rokid, etc.), é necessária uma Licença EasyAR XR.

Nota

Ao usar produtos de avaliação (como licença pessoal, licença XR de avaliação ou serviço Mega de avaliação) em câmeras ou headsets personalizados, o EasyAR Sense parará de responder após 100 segundos (o tempo pode ser ajustado pelo EasyAR Business após aprovação para usuários Mega) após cada inicialização. Não há essa limitação ao usar a versão paga do EasyAR Sense e o serviço EasyAR Mega pago.

Verify When Build

Verifica a License Key ao construir o projeto Unity.

Quando esta opção está ativa, o processo de build do projeto Unity valida a License Key. Se a licença for inválida na plataforma de build ou não incluir o nome do pacote (bundle identifier) definido nas Player Settings do Unity, o processo de build falhará. Desative esta opção se precisar configurar a license key noutro local ou se precisar de modificar o nome do pacote após o processo de build do Unity.

Variantes da biblioteca

Configuração das variantes da biblioteca do EasyAR Sense.

EasyAR Sense License

Configurações relacionadas à licença do EasyAR Sense.

LicenseKey

Chave de licença do EasyAR Sense. É obrigatório preencher uma licença válida para utilizar as funcionalidades do EasyAR.

Pode ser deixado em branco apenas quando o EasyAR Sense é inicializado manualmente via interface.

Nota

Ao utilizar em dispositivos head-mounted (Vision Pro, XREAL, Pico, Rokid, etc.), é necessária uma Licença EasyAR XR.

Nota

Ao usar produtos de avaliação (como licença pessoal, licença XR de avaliação ou serviço Mega de avaliação) em câmeras ou headsets personalizados, o EasyAR Sense parará de responder após 100 segundos (o tempo pode ser ajustado pelo EasyAR Business após aprovação para usuários Mega) após cada inicialização. Não há essa limitação ao usar a versão paga do EasyAR Sense e o serviço EasyAR Mega pago.

Verify When Build

Verifica a License Key ao construir o projeto Unity.

Quando esta opção está ativa, o processo de build do projeto Unity valida a License Key. Se a licença for inválida na plataforma de build ou não incluir o nome do pacote (bundle identifier) definido nas Player Settings do Unity, o processo de build falhará. Desative esta opção se precisar configurar a license key noutro local ou se precisar de modificar o nome do pacote após o processo de build do Unity.

Permissões

Configuração das permissões do aplicativo. Geralmente, é recomendado manter as configurações padrão.

Além da permissão da câmera, as outras configurações de permissão não podem ser alteradas e são determinadas pelas configurações de outros recursos.

Permissão É possível alterar? Condição de ativação Descrição da permissão
Camera Sim Permissão da câmera, necessária para usar o dispositivo de câmera
AndroidMicrophone Não Variant for VideoRecording Permissão do microfone, necessária para usar o recurso de gravação de tela
Location Não Importar o pacote de suporte Mega Permissão de localização (fine), necessária para usar o EasyAR Mega

Unity XR

Configurações relacionadas ao framework Unity XR (AR Foundation etc.).

Suporte ao AR Foundation

Botão de suporte ao AR Foundation. Recomenda-se manter esse botão ativado.

Em casos muito raros, como quando for necessário usar o AR Foundation 4 ou quando houver erros de compilação devido a atualizações do AR Foundation, você pode desativar essa opção. No entanto, todos os recursos relacionados ao AR Foundation no plug-in também serão desativados.

Nota

Após alterar essa opção, os scripts serão recompilados automaticamente.

Troca automática do Unity XR

Configuração do recurso de troca automática de objetos do Unity XR (por exemplo, AR Foundation).

  • Editor: Opções no modo de edição
    • Desativar a sessão AR: Quando houver ARSession, desative a sessão AR do AR Foundation durante a edição.
  • Player: Opções no modo de execução
    • Ativar: Ative o controle em tempo de execução. Observe que, se essa opção for desativada, os componentes desativados no modo de edição não serão restaurados em tempo de execução.
    • Ativar se for desktop: Ative no Windows/Mac.
    • Ativar se o AR móvel estiver ativado na inicialização: Quando o alternador for iniciado, se o carregador do AR móvel (ARKit/ARCore) estiver ativo, ative-o. Normalmente, essa opção requer que a opção Inicializar o XR na inicialização no gerenciador de plug-ins do XR esteja selecionada.
    • Desativar se não houver AR móvel após a inicialização: Quando o alternador for iniciado, se houver outros carregadores além do AR móvel (ARKit/ARCore), mas nenhum deles estiver ativo, desative-os. Normalmente, essa opção é usada quando a opção Inicializar o XR na inicialização no gerenciador de plug-ins do XR não estiver selecionada.
    • Restaurar a sessão AR quando desativada: Quando o recurso for desativado, restaure (ative) todas as sessões AR do AR Foundation que foram desativadas (independentemente de terem sido desativadas pelo EasyAR). Essa opção geralmente é usada para restaurar os componentes desativados durante a edição.

Para obter mais informações sobre o recurso, consulte Troca automática do Unity XR.

Mega

Configuração do recurso EasyAR Mega.

Suporte ao Mega Block/Landmark

Determina se o suporte ao Mega Block/Landmark está ativado.

Essa opção é ativada por padrão depois de importar com.easyar.mega e desativada por padrão se não for importada.

Suporte ao InertialCameraDevice

Opção somente leitura que indica se o recurso de navegação inercial está disponível na configuração atual.

Se as informações exibidas não corresponderem às suas necessidades, você pode modificar a opção Variantes da biblioteca conforme necessário.

Suporte ao ONNX

Opção somente leitura que exibe as informações do tempo de execução do ONNX na configuração atual.

Se as informações exibidas não corresponderem às suas necessidades, você pode modificar as opções Variantes da biblioteca e Tempo de execução do ONNX (embutido) conforme necessário.

Mega Block > Acesso ao serviço de localização [Global]

Configuração do servidor de localização do Mega Block global.

Mega Landmark > Acesso ao serviço de localização [Global]

Configuração do servidor de localização do Mega Landmark global.

Mapa espacial

Configuração do recurso de mapa espacial do EasyAR.

Acesso ao serviço [Global]

Configuração do servidor de mapa esparso global.

Rastreamento de imagem

Configuração do recurso de rastreamento de imagem do EasyAR.

Gizmo do alvo

Configuração dos gizmos do ImageTarget no editor.

Ativar essas opções exibirá os gizmos correspondentes no Unity Editor. Se houver muitos alvos desse tipo na cena, isso pode afetar o desempenho da inicialização no editor. O desempenho durante a execução no dispositivo não será afetado.

Reconhecimento em nuvem (CRS) > Acesso ao serviço [Global]

Configuração do servidor de reconhecimento em nuvem global.

Rastreamento de objeto

Configuração do recurso de rastreamento de objeto do EasyAR.

Gizmo do alvo

Configuração dos gizmos do ObjectTarget no editor.

  • Ativar: Ative os gizmos.

Bibliotecas de terceiros

Configuração de biblioteca de terceiros.

Arcore sdk

Configuração do ARCore SDK.

O ARCore fornece capacidade de rastreamento de movimento em alguns dispositivos Android. Consulte Rastreamento de movimento e funcionalidade EasyAR para entender a relação entre a funcionalidade EasyAR e o rastreamento de movimento e se e quando você precisa usar o ARCore.

  • AR Foundation Or Optional: O ARCore SDK distribuído com o EasyAR ou AR Foundation será incluído no aplicativo, determinado pela configuração do ARCore XR Plugin. Geralmente recomendamos esta opção, que lida automaticamente com o caso do AR Foundation.
  • Optional: A funcionalidade ARCore pode ser usada em dispositivos compatíveis com ARCore e que tenham o Google Play Services for AR instalado.
  • Required: O aplicativo só funcionará em dispositivos compatíveis com ARCore e que tenham o Google Play Services for AR instalado.
  • External: Se estiver usando a distribuição do AR Foundation ou de outro ARCore SDK, você pode usar esta opção. Assim, o ARCore SDK distribuído com o EasyAR não será usado. Você também pode usar esta opção para excluir completamente o uso do ARCore SDK no aplicativo.
Cuidado

Se você definir ARCore SDK como Required, ou definir Requirement como Required na configuração ARCore do AR Foundation, e instalar o aplicativo empacotado em um dispositivo não compatível com ARCore, o dispositivo relatará erroneamente que o ARCore está disponível e executará com o ARCore. Isso criará a ilusão de que esses dispositivos estão executando o ARCore e funcionando mal (tela preta ou outros comportamentos anormais), mas isso está errado.

Este fenômeno ocorre porque a Google Play Store impede a instalação de aplicativos que marcam o ARCore como obrigatório em dispositivos não suportados, então esses aplicativos sempre presumem que estão sendo executados em dispositivos compatíveis.

Em uma configuração normal, esses dispositivos determinariam durante a montagem da sessão que o ARCore não é suportado e usariam a funcionalidade do EasyAR.

Para explicações detalhadas sobre Optional e Required e outras configurações necessárias para publicar aplicativos na Google Play Store, consulte a documentação do Google (China continental, Internacional).

Nota

No EasyAR Sense Unity Plugin, os arquivos de biblioteca e configurações necessários para o suporte ao ARCore já estão incluídos no pacote do plugin. No entanto, para executar em um telefone, ainda é necessário instalar o Google Play Services for AR no dispositivo.

Existem três fontes diferentes de ARCore SDK que podem ser usadas:

  • Usar o ARCore SDK distribuído com o plugin

    O plugin inclui uma versão do ARCore SDK. Para detalhes, consulte Compatibilidade de versão do ARCore, AR Engine. Ao usar o wrapper ARCore do EasyAR, você não precisa importar o AR Foundation separadamente.

  • Usar o ARCore SDK do AR Foundation

    Se você precisar usar o ARCore SDK do AR Foundation, consulte a documentação do Google (China continental, Internacional) para configuração. Neste caso, a opção ARCore SDK precisa ser definida como AR Foundation Or Optional ou External.

  • Usar outro ARCore SDK

    Se houver outro plugin de terceiros ou distribuição de ARCore SDK dentro do projeto, você também pode usar esses ARCore SDKs. Neste caso, a opção ARCore SDK precisa ser definida como External, e a configuração deve ser feita de acordo com os requisitos do plugin ou projeto específico.

Warn 32-bit-only ARCore-enabled build

De acordo com a documentação do Google, executar um aplicativo com apenas bibliotecas armv7 em um dispositivo arm64 fará com que o ARCore não funcione corretamente. Um aviso será exibido durante a construção se o ARM64 não for selecionado:

alt text

Neste caso, é necessário modificar a configuração do projeto, usar a compilação IL2CPP e selecionar o suporte ARM64.

alt text

Cuidado

Se realmente necessário, você pode selecionar Continue and don't warn me again ou desativar a opção. Isso desativará a verificação durante a construção. Desativar a verificação apenas suprime o aviso durante a construção, mas em tempo de execução, podem ocorrer anomalias em alguns dispositivos, incluindo, mas não se limitando a, travamentos, tela preta, etc.

Ar engine sdk

Configuração do AR Engine SDK.

O AR Engine fornece capacidade de rastreamento de movimento em alguns dispositivos Android. Consulte Rastreamento de movimento e funcionalidade EasyAR para entender a relação entre a funcionalidade EasyAR e o rastreamento de movimento e se e quando você precisa usar o AR Engine.

  • AREngineInterop: AREngineInterop disponível. O AR Engine SDK distribuído com o EasyAR será incluído no aplicativo.
  • External: AREngineInterop disponível. O AR Engine SDK distribuído com o EasyAR não será usado.
  • Disabled: AREngineInterop não disponível. O AR Engine SDK distribuído com o EasyAR não será usado. Todas as funcionalidades relacionadas ao AR Engine serão desativadas.

Onnx runtime (bundled)

Se deve usar o tempo de execução ONNX empacotado. Válido apenas quando Lib Variant é Full.

Se precisar usar uma versão diferente do ONNX, obtenha uma versão atualizada oficialmente do ONNX e desative esta opção. Usar binários ONNX auto-compilados e incompatíveis causará erros desconhecidos.

Solução alternativa para o Unity

Soluções para bugs ou comportamentos inadequados do Unity.

GenerateXMLDoc

Gera o documento XML ao recarregar o script para que o IntelliSense da documentação da API funcione.

Solução alternativa URP17RG_DX11_RuinedScene

Solução alternativa para a renderização de cenas danificadas no URP 17 Render Graph DX11. Esta opção está desativada no Unity 6.2 e versões posteriores.

Solução parcial URP17RG_IOS_Glitches_Partial

Solução parcial para o Problema do Unity UUM-87787.

Descrição do problema: Ao obter a textura da câmera do EasyAR (como usado em exemplos como ImageTracking_Coloring3D e Fluxo de trabalho ARSession (CameraDevice)), artefatos visuais e falhas são observados em dispositivos iOS/Mac. Reprodusimos este problema em um pacote Unity puro e reportamos à Unity: Falhas no iOS com renderização de imagem da câmera AR (Render Graph URP 17). O progresso do problema pode ser acompanhado nas atualizações do Problema do Unity UUM-87787 e nos logs de lançamento de versões futuras do Unity.