Habilitar o ar foundation em projetos easyar
Se você precisar habilitar o suporte ao ar foundation do easyar ou usar outros recursos do ar foundation, é necessário instalar e configurar corretamente o ar foundation. O seguinte conteúdo descreve como realizar essas operações.
Antes de começar
- Leia Suporte do easyar aos frameworks de xr da unity para entender o suporte do easyar aos frameworks de xr da unity e em quais situações você pode considerar o uso do ar foundation.
Compatibilidade de versões do ar foundation
O easyar suporta ar foundation 5 ou versões mais recentes.
Importante
O suporte ao ar foundation é implementado através de uma câmera personalizada.
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.
Instalar o ar foundation
Recomenda-se consultar a documentação oficial do ar foundation para instalar o ar foundation. Antes de ler, observe a seleção da versão correspondente do documento.
Unity 2022 e versões mais recentes
Se nenhum plug-in de xr foi instalado no projeto, é necessário ir em Project Settings > XR Plug-in Management e clicar no botão Install XR Plugin Management para instalar o gerenciamento de plug-ins de xr e aguardar a conclusão da instalação.
Se você precisar usar ar foundation na plataforma android, marque Google ARCore na aba android e aguarde a conclusão da instalação.
Se você precisar usar ar foundation na plataforma ios, marque Apple ARKit na aba ios e aguarde a conclusão da instalação.
Se você precisar usar ar foundation na plataforma visionos, é necessário ler Configuração do projeto para vision pro.
Dica
Recomenda-se manter Initialize XR On Startup marcado para garantir que o ar foundation possa ser inicializado no momento padrão.
Após a instalação, abra a janela Package Manager e você verá AR Foundation e os plug-ins das plataformas correspondentes na lista de pacotes instalados. Observe que os números de versão desses pacotes devem ser idênticos.
Importante
Ao instalar e atualizar o ar foundation, é necessário garantir que as versões do Google ARCore XR Plugin e do Apple ARKit XR Plugin sejam exatamente iguais à versão do AR Foundation. Versões incompatíveis podem causar erros de tempo de execução ou mau funcionamento.
Unity 2021
No unity 2021, é necessário editar manualmente o arquivo Packages/manifest.json para especificar a versão, conforme a documentação oficial.
Por exemplo, se você precisar instalar a versão 5.2.0 do ar foundation e usá-la nas plataformas android e ios, verifique se o arquivo Packages/manifest.json contém o seguinte:
{
"dependencies": {
...
"com.unity.xr.arcore": "5.2.0",
"com.unity.xr.arfoundation": "5.2.0",
"com.unity.xr.arkit": "5.2.0",
...
}
}
Configurar o xr plug-in
Ao usar easyar, a presença do arcore geralmente não é obrigatória. Portanto, o arcore deve ser configurado como opcional para evitar que o aplicativo não funcione corretamente em dispositivos não suportados.
Em Project Settings > XR Plug-in Management > ARCore, defina Requirement e Depth como Optional
Cuidado
Se Requirement for definido como Required, e um aplicativo empacotado for instalado em um dispositivo não suportado, o dispositivo relatará erroneamente que o arcore está disponível e executará com arcore. Isso criará a ilusão de que esses dispositivos estão executando arcore e funcionando mal (tela preta ou outras anomalias), mas isso é incorreto.
Esse fenômeno ocorre porque a google play store impede a instalação de aplicativos que marcam arcore como obrigatório em dispositivos não suportados, então esses aplicativos sempre presumem que estão sendo executados em dispositivos suportados.
Na configuração normal, esses dispositivos determinariam durante a montagem da sessão que o arcore não é suportado e usariam os recursos do easyar.
Se necessário, você também pode consultar a documentação oficial abaixo para configurar melhor arcore e arkit. Antes de ler, observe a seleção da versão correspondente do documento.
Configurar o universal render pipeline
Se o projeto atual estiver usando urp, é necessário configurar os ativos urp. Se não configurado corretamente, o plano de fundo da câmera do ar foundation pode não ser renderizado corretamente.
Primeiro, verifique se o renderer feature do urp do easyar foi configurado corretamente, consulte Configuração do universal render pipeline do easyar.
Em seguida, adicione ARBackgroundRendererFeature à lista de renderer features
Assim como na configuração do renderer feature urp do easyar, é necessário verificar a configuração de diferentes plataformas em Project Settings > Quality, garantindo que todos os ativos urp usados nas plataformas onde o ar foundation será utilizado estejam configurados corretamente com ARBackgroundRendererFeature.
Você também pode consultar a documentação oficial de configuração urp do ar foundation para configuração, observando a seleção da versão correspondente antes de ler.
Nota
A Configuração do universal render pipeline do easyar ainda é necessária para garantir que a renderização das funcionalidades relacionadas às interfaces easyar funcione normalmente em dispositivos não suportados por ar foundation.
Habilitar o suporte ao ar foundation do easyar
Em Project Settings > EasyAR > Sense, certifique-se de que a opção Unity XR > AR Foundation Support esteja habilitada. Esta opção está ativada por padrão.
Alterar esta opção acionará a recompilação de scripts, e é necessário aguardar a conclusão da compilação para que a alteração entre em vigor. Se a unity não acionar a compilação normalmente por algum motivo, você pode fechar a unity e excluir a pasta Library/ScriptAssemblies para forçar a recompilação dos scripts.
Dica
Se o easyar for incompatível com o ar foundation no projeto e não houver necessidade de usar ambos simultaneamente, você pode desativar esta opção.
Próximos passos
- Entenda Configuração de cena e uso do ar foundation em projetos easyar
- Saiba como Alternar automaticamente para ar foundation com base no suporte do dispositivo