Configuração e utilização de cenas AR Foundation em projetos EasyAR
Ao usar AR Foundation em Unity, muitas vezes é necessário confiar no EasyAR para superar as limitações de dispositivo do AR Foundation. O conteúdo abaixo explica como configurar e usar corretamente o AR Foundation em cenas EasyAR, bem como como ativar dinamicamente o AR Foundation de acordo com o suporte de dispositivo.
Antes de começar
- Leia Suporte do EasyAR para a estrutura Unity XR para entender o suporte do EasyAR para a estrutura Unity XR e quando considerar o uso do AR Foundation.
- Leia Ativar AR Foundation em projetos EasyAR para entender como instalar e configurar o AR Foundation em projetos EasyAR.
Adicionar componentes AR Foundation
Adicione AR Session e XR Origin do AR Foundation à cena EasyAR.
Adicionar AR Session
No painel Hierarchy, clique com o botão direito em um local vazio e adicione ARSession do Unity através do menu XR > AR Session.
Nota
Esta AR Session é diferente da AR Session do EasyAR; ambas precisam coexistir na cena.
Adicionar XR Origin
No painel Hierarchy, clique com o botão direito em um local vazio e adicione XROrigin do Unity através do menu XR > XR Origin (Mobile AR).
Nota
Esta XR Origin sobrepõe-se à funcionalidade da XR Origin do EasyAR, sendo necessário usar a XR Origin do Unity em vez da XR Origin do EasyAR.
Se a cena já contiver a XR Origin do EasyAR, geralmente chamada XR Origin (EasyAR), mova seus objetos filhos para a nova XR Origin e exclua o XR Origin (EasyAR).
Se a nova XR Origin não tiver um XR Origin Child, adicione manualmente.
No painel Hierarchy, selecione XR Origin, clique com o botão direito e adicione XR Origin Child através do menu EasyAR Sense > Origin > Origin : XR Origin Child.
Configurar Camera
Se a cena já contiver uma Camera para RA, você notará câmeras principais adicionais; exclua a câmera original.
Selecione Main Camera sob XR Origin e configure-a de acordo com as instruções em Configurações de câmera.
A estrutura final de uma cena EasyAR com AR Foundation adicionado deve ser semelhante a:
Cuidado
Ao modificar configurações do AR Foundation via ARCameraManager.currentConfiguration, note que alguns dispositivos (ex: Xiaomi 10) apresentam problemas onde, após alterações, falham em capturar imagens, tornando o EasyAR inoperável (aplicativo exibe fundo mas sem funcionalidades). Assim, não é recomendado alterar essas configurações; se necessário, implemente um plano de downgrade para quando o EasyAR não funcionar.
Compatibilidade de dispositivos e ativação dinâmica do AR Foundation
O EasyAR suporta muito mais dispositivos que o AR Foundation, portanto é essencial configurar para ativar o AR Foundation apenas quando necessário, desativando-o completamente em outros casos.
Verificar componentes frame source
Sessões criadas via menu do EasyAR geralmente adicionam automaticamente ARCoreARFoundationFrameSource e ARKitARFoundationFrameSource (exceto em casos como tracking de imagem que não requerem SLAM).
Importante
ARCoreARFoundationFrameSource e ARKitARFoundationFrameSource são frame sources fornecidos pelo EasyAR para habilitar recursos do AR Foundation em dispositivos compatíveis. Se a sessão não contiver esses frame sources, os recursos do AR Foundation não serão habilitados.
Se faltarem esses frame sources na sessão, adicione-os manualmente via menu.
Para funcionar em dispositivos sem suporte a AR Foundation, certifique-se que a sessão inclua frame sources além dos do AR Foundation. Uma ARSession típica deve ser semelhante a:
Dica
Os frame sources podem ser ordenados conforme necessário; durante a execução, a sessão selecionará o primeiro frame source disponível com base na ordem dos componentes.
Habilitar AR Foundation apenas quando necessário
Como a implementação subjacente do AR Foundation em dispositivos móveis é ARCore/ARKit, funcional apenas em dispositivos limitados (especialmente em muitos Android chineses), recomenda-se habilitar scripts relacionados ao AR Foundation apenas em dispositivos suportados.
O EasyAR pode automatizar esse processo através da opção Unity XR Auto Switch em Project Settings > EasyAR > Sense > Unity XR. Detalhes em Objetos Unity XR com auto-switch.
Cenas com compatibilidade preservada para AR Foundation
Cenas com componentes AR Foundation corretamente adicionados funcionarão tanto com quanto sem a instalação do pacote AR Foundation.
Sem o pacote, os recursos do AR Foundation e seus frame sources serão inacessíveis, e alguns scripts aparecerão faltando - isso é normal.
Dica
Muitos exemplos funcionam com ou sem o pacote AR Foundation. Para habilitar suporte ao AR Foundation nesses exemplos, basta Ativar AR Foundation em projetos EasyAR.
Próximos passos
- Aprenda a alternar automaticamente para AR Foundation conforme o suporte do dispositivo.
Tópicos relacionados
- Componentes AR mencionados:
- O AR Foundation fornece rastreamento de movimento em alguns dispositivos; para entender sua relação com recursos do EasyAR:
- Mais informações sobre configuração de cenas AR Foundation na documentação oficial (selecione a versão correspondente):