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, é recomendável manter esta opção ativada.

Se você desativar esta opção, precisará inicializar o EasyAR Sense manualmente. Para obter mais detalhes, 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 EasyAR Sense.

O EasyAR Sense geralmente possui várias variantes, e as funcionalidades de suas diferentes variantes são diferentes. Aqui está uma comparação das variantes da biblioteca integradas no plug - in.

Variant Nome da variante do EasyAR Sense Diferenças de funcionalidade Outras particularidades
Normal Community/Enterprise Não inclui gravação de tela e navegação inercial
Full CommunityFull/EnterpriseFull Inclui navegação inercial e algumas outras funcionalidades do Mega O tamanho do arquivo da biblioteca é grande
VideoRecording CommunityR Inclui a funcionalidade de gravação de tela (apenas no Android)
Dica

Algumas variantes que não podem ser usadas no Unity não estão listadas, como a variante CommunityR do iOS.

Valor padrão:

  • Sem importar o pacote de suporte EasyAR Mega: Normal
  • Importando o pacote de suporte EasyAR Mega: Full

Configuração recomendada:

  • Full : Usar o EasyAR Mega ou a funcionalidade de navegação inercial
  • Normal : Buscar o menor tamanho do pacote e não usar o EasyAR Mega ou o suporte à navegação inercial
  • VideoRecording : Precisa usar a funcionalidade de gravação de tela (somente no Android)

Permissões

Configuração das permissões do aplicativo. Geralmente, é recomendável 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 vídeo
Location Não Importar o pacote de suporte Mega (fine) Permissão de localização, 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 mantê-lo ativado.

Em casos muito raros, como quando você precisa usar o AR Foundation 4 ou quando uma atualização do AR Foundation causa erros de compilação, você pode desativar esta opção. No entanto, todos os recursos relacionados ao AR Foundation no plug-in também serão desativados.

Nota

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

Alternância automática do Unity XR

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

  • Editor: Opções no modo de edição
    • Disable AR Session: Quando houver ARSession, desabilite a ARSession do AR Foundation durante a edição.
  • Player: Opções no modo de execução
    • Enable: Ative o controle em tempo de execução. Observação: se você desativar esta opção, os componentes desabilitados no modo de edição não serão restaurados em tempo de execução.
    • Enable If Desktop: Ative no Windows/Mac.
    • Enable If Mobile AR On Startup: Quando o alternador for iniciado, se o loader do AR móvel (ARKit/ARCore) estiver ativo, ative o recurso. Normalmente, esta opção requer que a opção Initialize XR on Startup no XR Plug-in Management esteja marcada.
    • Disable If Non Mobile AR Post Startup: Quando o alternador for iniciado, se houver outros loaders além do AR móvel (ARKit/ARCore), mas nenhum deles estiver ativo, desabilite o recurso. Normalmente, esta opção é usada quando a opção Initialize XR on Startup no XR Plug-in Management não estiver marcada.
    • Restore AR Session When Disabled: Quando o recurso for desativado, restaure (ative) todas as ARSessions do AR Foundation que foram desativadas (independentemente de terem sido desativadas pelo EasyAR). Esta opção geralmente é usada para restaurar os componentes desativados durante a edição.

Para obter mais detalhes sobre o recurso, consulte Alternância automática do Unity XR.

Mega

Configuração do recurso EasyAR Mega.

Suporte ao Mega Block/Landmark

Ative ou desative o suporte ao Mega Block/Landmark.

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

Suporte ao InertialCameraDevice

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

Se as informações exibidas não atenderem às suas necessidades, você precisa modificar a opção Lib Variants conforme necessário.

Suporte ao ONNX

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

Se as informações exibidas não atenderem às suas necessidades, você precisa modificar as opções Lib Variants e ONNX Runtime (Bundled) 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 fará com que os gizmos correspondentes sejam exibidos no Unity Editor. Se houver muitos alvos desse tipo na cena, isso 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 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.

  • Enable: Ative os gizmos.

Bibliotecas de terceiros

Configuração de bibliotecas de terceiros

SDK do ARCore

Configuração do SDK do ARCore

O ARCore fornece a capacidade de rastreamento de movimento em alguns dispositivos Android. Consulte Rastreamento de movimento e recursos do EasyAR para entender a relação entre os recursos do EasyAR e o rastreamento de movimento, e se e quando é necessário usar o ARCore.

  • AR Foundation Ou Opcional: O SDK do ARCore distribuído com o EasyAR ou o AR Foundation será incluído no aplicativo, conforme definido na configuração do Plug-in do ARCore XR. Geralmente, é recomendado usar essa opção, que trata automaticamente o caso do AR Foundation.
  • Opcional: As funcionalidades do ARCore são disponíveis em dispositivos que suportam o ARCore e têm o Google Play Services for AR instalado.
  • Obrigatório: O aplicativo só poderá ser executado em dispositivos que suportam o ARCore e têm o Google Play Services for AR instalado.
  • Externo: Use essa opção se estiver usando o AR Foundation ou outra distribuição do SDK do ARCore. Nesse caso, o SDK do ARCore distribuído com o EasyAR não será usado. Também é possível usar essa opção para excluir completamente o uso do SDK do ARCore no aplicativo.
Cuidado

Se o SDK do ARCore for configurado como Obrigatório, ou se a Requisito na configuração do ARCore do AR Foundation for definida como Obrigatório, e se o aplicativo compactado for instalado em um dispositivo que não suporta o 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 não estão funcionando corretamente (tela preta ou outros problemas), mas isso é errado.

O motivo disso é que a loja Google Play impede a instalação de aplicativos marcados como obrigatórios para o ARCore em dispositivos não suportados, portanto, esses aplicativos sempre assumem que estão sendo executados em dispositivos suportados.

Em configurações normais, esses dispositivos determinarão que o ARCore não é suportado durante a montagem da sessão e usarão as funcionalidades do EasyAR.

Para obter explicações detalhadas sobre Opcional e Obrigatório e outras configurações necessárias para publicar aplicativos no Google Play Store, consulte as instruções do Google (China Mainland, Internacional).

Nota

No Plug-in do EasyAR Sense Unity, os arquivos de biblioteca e as configurações necessárias para o suporte ao ARCore já estão no pacote do plug-in, mas para executar no celular, ainda é necessário instalar o Google Play Services for AR no celular.

Há três diferentes origens de SDK do ARCore que podem ser usadas:

  • Usar o SDK do ARCore distribuído com o plug-in

    Um versão do SDK do ARCore está integrada no plug-in. Para obter detalhes, consulte Compatibilidade de versões do ARCore e do AR Engine. Quando usar o encapsulamento do ARCore do EasyAR, não é necessário importar o AR Foundation separadamente.

  • Usar o SDK do ARCore do AR Foundation

    Se for necessário usar o SDK do ARCore do AR Foundation, consulte as instruções do Google (China Mainland, Internacional) para fazer a configuração. Nesse caso, a opção SDK do ARCore deve ser selecionada como AR Foundation Ou Opcional ou Externo.

  • Usar outros SDKs do ARCore

    Se houver outros plug-ins de terceiros ou se houver uma distribuição do SDK do ARCore em um projeto, também é possível usar esses SDKs do ARCore. Nesse caso, a opção SDK do ARCore deve ser selecionada como Externo, e a configuração deve ser feita de acordo com os requisitos do plug-in ou projeto específico.

Aviso: Build habilitado para o ARCore apenas 32 bits

De acordo com as instruções do Google, o ARCore não funcionará corretamente em dispositivos arm64 que executam um programa com apenas arquivos de biblioteca armv7. Se a seleção de ARM64 não for feita durante o compactamento, um aviso será exibido:

alt text

Nesse caso, é necessário modificar a configuração do projeto, compilar usando o IL2CPP e selecionar o suporte ao ARM64.

alt text

Cuidado

Se for realmente necessário, é possível selecionar Continue and don't warn me again, ou desativar essa opção, o que desativará a verificação durante o compactamento. Desativar a verificação apenas evitará a exibição da mensagem durante o compactamento, mas durante a execução, em alguns dispositivos, podem ocorrer problemas, incluindo, mas não se limitando a, travamentos ou telas pretas.

SDK do AR Engine

Configuração do SDK do AR Engine

O AR Engine fornece a capacidade de rastreamento de movimento em alguns dispositivos Android. Consulte Rastreamento de movimento e recursos do EasyAR para entender a relação entre os recursos do EasyAR e o rastreamento de movimento, e se e quando é necessário usar o AR Engine.

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

ONNX Runtime (Embutido)

Se usar o ONNX Runtime embutido. Somente é válido quando o Lib Variant for Full.

Se for necessário usar uma versão diferente do ONNX, é possível obter uma versão atualizada do site oficial do ONNX e desativar essa opção. Usar binários compilados pelo próprio que não são compatíveis com o ONNX resultará em erros desconhecidos.

Soluções 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.