Usar exemplos para começar rapidamente o desenvolvimento do EasyAR Mega Unity

Este tutorial apresenta como configurar e executar os exemplos do EasyAR Mega Unity para começar rapidamente o desenvolvimento do EasyAR Mega.

Antes de começar

Antes de ler este artigo, certifique-se de ter concluído o seguinte:

• Ter uma biblioteca de localização em nuvem válida.
• Instalar o Unity (versão 2021.3.30 LTS ou superior). Recomenda-se usar a versão mais recente do Unity 2022.3 ou Unity 6.3.
• Importar os pacotes com.easyar.sense-**.tgz e com.easyar.mega-**.tgz conforme descrito em Habilitar o Mega.

Nota

Este tutorial é apenas aplicável ao plug-in do Unity com versão >= 4003. Se você baixou acidentalmente uma versão antiga e ainda está lendo a documentação de introdução, primeiro baixe a versão mais recente do plug-in.

Método de utilização de exemplos (seis passos)

Abaixo, apresentaremos como configurar e executar o exemplo principal MegaBlock_Basic do EasyAR Mega em seis passos.

Primeiro passo: importar amostra

Nota

Se todas as amostras foram importadas via **All Samples**, pule esta etapa.

1. Use o menu Window > Package Manager para abrir o Package Manager, selecione EasyAR Sense Unity Plugin, e no lado direito, em Samples, expanda todas as amostras.
2. Selecione a amostra (por exemplo, MegaBlock_Basic), clique em Import.

Nota

• Este tutorial não é diretamente aplicável a dispositivos headset, mas o entendimento do fluxo usando um telefone é necessário antes de desenvolver para headsets.
• Se você importou previamente amostras de uma versão antiga do SDK, após atualizar o SDK, exclua as amostras antigas e importe-as novamente.

Passo 2: Configurar o SDK e o serviço de localização em nuvem Mega

1. Na barra de menus, selecione EasyAR > Sense > Configuration;
   

2. No painel Project Settings que se abre, cole sua License Key;
   

   Dica

   A EasyAR Sense License pode ser criada no EasyAR Developer Center. Para uso inicial, você pode criar seguindo estes passos:

   

   • Crie EasyAR Sense 4.x Personal Edition
   • Para Mapa Espacial Esparso, selecione No
   • Preencha o nome do aplicativo como desejar, e para Bundle ID e Package Name, preencha com.mycompany.myproject
   • Selecione a licença recém-criada, entre nela e clique no botão de copiar à direita

   

   Nota

   O Bundle ID e o Package Name podem ser alterados posteriormente, mas o número de alterações é limitado. Se você tiver um nome de pacote de aplicativo específico, também pode preencher o seu próprio.

   Não há limite para a criação da edição pessoal. Outros tipos podem ser criados conforme necessário para uso oficial.

3. Verifique e ative a opção Mega > Mega Block/Landmark support no painel Project Settings;
   

4. Configure as informações da sua biblioteca de localização em nuvem Mega no item Mega Block do painel Project Settings;
   

   Dica

   A configuração da biblioteca de localização em nuvem Mega pode ser obtida no EasyAR Developer Center.
   
   Certifique-se de que sua API Key tenha permissões para Mega Block e SpatialMap. Se não tiver, é necessário alterar ou recriá-la.
   
   Se não conseguir encontrar a biblioteca de localização, é necessário primeiro configurar corretamente a biblioteca de localização e verificar novamente se a biblioteca de localização em nuvem está válida.

Terceiro passo: Configurar o Mega Block

1. Configure o Mega Block;

   Selecione Mega Block e preencha o ID e o Nome do Bloco.
   

   Dica

   O ID e o Nome do Bloco podem ser obtidos no centro de desenvolvimento do EasyAR na biblioteca de localização correspondente.
   
   Se não houver dados de Bloco na biblioteca de localização, é necessário adicionar os blocos necessários na biblioteca de localização e verificar novamente se a biblioteca de localização em nuvem é válida.

Quarto passo: Colocar conteúdo 3D

1. Selecione Mega Block e crie a ferramenta de edição;

   

2. Verifique as informações do serviço e conecte-se ao serviço;

   

   Dica

   Se não houver outras alterações, as informações do serviço devem ser as mesmas preenchidas nas Configurações do Projeto.

   Após a conexão bem-sucedida ao serviço, você deve ver a hora de atualização e a interface de controle dos dados do editor de Block.
   

3. Carregar dados do editor de Block;

   Clique na primeira caixa de seleção em Dados do Block. Isso iniciará o processo de carregamento dos dados do editor de Block. Após o carregamento, você poderá ver a malha do Block atual na janela Scene:
   

   Dica

   A malha do Block alternará entre níveis de detalhe (LOD) com base na posição da câmera, sendo necessário manter a conexão com a internet.

4. Colocar conteúdo 3D

   Neste momento, você pode referenciar a malha do Block para posicionar objetos 3D.
   

   Nota

   • Os objetos 3D devem ser posicionados sob o nó Block para garantir que a posição de renderização do conteúdo virtual esteja correta durante a execução.
   • Os objetos 3D não devem ser posicionados sob o nó EasyAR.Mega.EditorTool. Este nó é usado apenas pela ferramenta de edição e pode ser excluído ou recriado automaticamente em algumas situações.

Passo 5: Modificar a configuração do player

• Android
• iOS

No menu do Unity, vá para File > Build Settings > Player Settings, clique no ícone do Android para abrir as configurações correspondentes à plataforma Android.

• Modifique o Package Name para o Package Name exibido na página da chave de licença

  

  Dica

  Por exemplo, se o Package Name que preencheu ao criar a chave de licença foi com.mycompany.myproject, deve preencher o Package Name aqui como com.mycompany.myproject, caso contrário, a execução falhará.

• Modifique o Minimum API Level para API Level 24 ou superior

  

• Modifique o Scripting Backend para IL2CPP e marque ARM64 em Target Architecture

  

第六步：构建并运行

1. Adicione a cena atual a File > Build Settings ou Build Profiles > Scene List;
   
2. Mude para a plataforma de destino (por exemplo, Android / iOS) e verifique se o nome do pacote (Bundle ID) é consistente com a License Key;
   
3. Clique em Build And Run.
   

O efeito de execução em gravação ao vivo é o seguinte:

Sobre o texto amarelo na tela

Durante a execução, você pode ver dois textos amarelos exibidos na tela.

1. Aviso de simulação

   Localiza-se na parte inferior da tela:

   

   Este aviso aparece porque, na configuração padrão, o aplicativo pode ser executado fora do local. Ele tem um leve impacto no desempenho do aplicativo. Se você estiver usando no local, pode modificar a configuração do MegaTracker antes de empacotar.

2. Informações de diagnóstico

   Localiza-se na parte superior da tela, usado para entender o status de funcionamento e problemas da session. Recomenda-se mantê-lo visível durante as fases de desenvolvimento e teste:

   

   Consulte Informações de diagnóstico na cena para entender rapidamente como configurar e usar essas informações de diagnóstico.

Próximos passos: do básico ao avançado

Parabéns! Seguindo os passos acima, você executou com sucesso o exemplo principal do EasyAR Mega em 10 minutos, experimentando pessoalmente o fascínio da localização espacial e da sobreposição de conteúdo em RA.

Agora, você domina o básico. Se deseja:

• Construir aplicativos RA mais estáveis e eficientes
• Implementar efeitos complexos como oclusão real-virtual, alinhamento de conteúdo, entre outros
• Depurar quando não tiver o dispositivo ou não puder ir até o local

Consulte os guias aprofundados abaixo. Eles o ajudarão a resolver problemas práticos durante o desenvolvimento.

Desenvolvimento avançado

Se deseja entender a configuração completa do projeto, pode consultar o seguinte conteúdo:

• Uso do Universal Render Pipeline (URP)
• Configuração do player
• Configuração do EasyAR

Se deseja compreender melhor o uso do EasyAR, pode começar por aqui:

• Fundamentos de aplicações Unity AR-driven

Simultaneamente, recomenda-se a leitura do seguinte conteúdo para auxiliar no desenvolvimento e depuração:

• Diagnóstico e relatório de problemas no desenvolvimento Unity
• Simulação do Unity AR

Controle refinado de recursos mega

Os conteúdos abaixo ajudarão você a utilizar melhor o mega em seu aplicativo:

• Uso local e simulação
• Melhores práticas de ARSession
• Adicionando alvos de rastreamento
• Criando conteúdo 3D alinhado ao mundo real
• Oclusão ambiental
• Controlando o processo de rastreamento

Os conteúdos abaixo ajudarão você a verificar os recursos mega sem precisar ir ao local:

• Verificação rápida usando câmera de PC
• Simulação usando ferramenta de verificação de sessão

Tópicos avançados

Os conteúdos abaixo são mais adequados para leitura após adquirir alguma experiência com o EasyAR.

Se deseja executar o EasyAR Mega em headsets, consulte:

• Suporte a headsets no Unity
• Usando amostras do EasyAR em headsets ou óculos XR

Se deseja utilizar o AR Foundation, comece aqui:

• Suporte do EasyAR ao framework XR do Unity