Table of Contents

Configuração easyar

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

alt text

Contém todas as configurações globais para o EasyAR Sense Unity Plugin

alt text

Inicializar no início

Inicializa o EasyAR na inicialização. Geralmente recomenda-se manter esta opção ativada.

Se desativar esta opção, é necessário inicializar manualmente o EasyAR Sense, métodos específicos podem ser encontrados em Inicializando 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 de variantes da biblioteca 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 de permissões do aplicativo. Geralmente recomenda-se manter os padrões.

Exceto permissão de câmera, outras permissões não podem ser alteradas, sendo determinadas por outras configurações de funcionalidade.

Permissão Alterável Condição de ativação Descrição da permissão
Camera Sim Permissão de câmera, necessária para usar dispositivos de câmera
AndroidMicrophone Não Variant é VideoRecording Permissão de microfone, necessária para gravação de tela
Location Não Pacote de suporte Mega importado Permissão de localização (fine), necessária para EasyAR Mega

Unity XR

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

Suporte a AR Foundation

Interruptor de suporte a AR Foundation, recomenda-se mantê-lo ativado.

Em casos muito específicos, como necessidade de usar AR Foundation 4 ou erros de compilação causados por atualizações do AR Foundation, esta opção pode ser desativada, mas todas as funcionalidades relacionadas ao AR Foundation no plugin serão desativadas simultaneamente.

Nota

Após modificar esta opção, os scripts serão recompilados automaticamente.

Troca automática de Unity XR

Configuração de funcionalidade para alternar automaticamente objetos Unity XR (como AR Foundation).

  • Editor: opções de modo de edição
    • Disable AR Session: quando existe ARSession, desativa o ARSession do AR Foundation durante a edição.
  • Player: opções de modo de execução
    • Enable: ativa o controle em tempo de execução. Nota: ao desativar esta opção, componentes desativados no modo de edição não serão restaurados durante a execução.
    • Enable If Desktop: ativa em Windows/Mac.
    • Enable If Mobile AR On Startup: ativa quando o inicializador de AR móvel (ARKit/ARCore) está ativo durante a inicialização do alternador. Normalmente esta opção requer que Initialize XR on Startup no XR Plug-in Management esteja selecionado.
    • Disable If Non Mobile AR Post Startup: desativa quando existe algum inicializador que não seja AR móvel (ARKit/ARCore) durante a inicialização do alternador, mas nenhum inicializador está ativo. Normalmente esta opção é usada quando Initialize XR on Startup no XR Plug-in Management não está selecionado.
    • Restore AR Session When Disabled: quando a funcionalidade está desativada, restaura (ativa) todas as sessões AR do AR Foundation que foram desativadas (independentemente de terem sido desativadas pelo EasyAR). Esta opção normalmente é usada para restaurar componentes desativados durante a edição.

Explicação detalhada da funcionalidade pode ser encontrada em Troca automática de Unity XR.

Mega

Configuração de funcionalidade EasyAR Mega.

Suporte a InertialCameraDevice

Opção somente leitura, mostra se a funcionalidade de navegação inercial está disponível e informações do tempo de execução ONNX.

Se as informações exibidas não atenderem às necessidades, modifique as opções Lib Variants e ONNX Runtime (Bundled) conforme necessário.

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

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

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

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

Mapa espacial

Configuração de funcionalidade de mapa espacial EasyAR.

Acesso ao serviço [Global]

Configuração global do servidor de mapa esparso.

Rastreamento de imagem

Configuração de funcionalidade de rastreamento de imagem EasyAR.

Gizmo de destino

Configuração de Gizmos do ImageTarget no editor.

Ativar estas opções exibirá o gizmo correspondente no Unity Editor. Se houver muitos targets deste tipo na cena, pode afetar o desempenho de 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 global do servidor de reconhecimento em nuvem.

Rastreamento de objeto

Configuração de funcionalidade de rastreamento de objeto EasyAR.

Gizmo de destino

Configuração de Gizmos do ObjectTarget no editor.

  • Enable: ativa 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 Unity

Contramedidas 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.