Criar e carregar anotações usando o editor unity
Este artigo explica como criar e carregar anotações usando o Mega Studio no editor Unity.
Antes de começar
- Capacidade de usar o Mega Studio no Unity
- Preparar o modelo: usar o modelo do projeto de exemplo (um panda fofo), ou o modelo de robô pequeno do Demo oficial do xr-frame, ou preparar um arquivo de modelo que atenda aos requisitos do xr-frame referenciando o formato GLTF carregável do XRFrame e extensões suportadas.
- Importar os arquivos do modelo para o Unity.
Dica
O plug-in Mega já adicionou dependência de com.unity.cloud.gltfast, então você pode arrastar diretamente os arquivos do modelo para os Assets do Unity.
Por que precisamos de anotações
O EasyAR Mega Annotation (EMA) pode ser usado para sincronizar posições espaciais entre plataformas (com diferentes definições de sistemas de coordenadas).
Sistema de coordenadas local para anotações no ambiente Unity: direção positiva de X para trás, direção positiva de Y para cima, direção positiva de Z para a direita.
Sistema de coordenadas local para anotações no ambiente xr-frame: direção positiva de X para trás, direção positiva de Y para cima, direção positiva de Z para a esquerda.
Essas diferenças de direção originam-se das definições de sistema de coordenadas (destro/canhoto) diferentes usadas pelo Unity e pelo xr-frame.
Usar o EMA para sincronizar posições espaciais oferece estas vantagens significativas:
- Simplifica o fluxo de desenvolvimento: processa automaticamente a conversão de coordenadas entre plataformas, evitando a lógica complicada e propensa a erros dos cálculos manuais.
- Melhora a eficiência de depuração: permite carregar diretamente na MegaToolbox, facilitando testes rápidos em dispositivos reais e validação de dados.
Etapas de operação
Criar ferramenta de anotação
Clique com o botão direito no painel Hierarchy do Unity e selecione: EasyAR Mega > Tool > Annotation Tool (Edit-Mode).
Após a criação, dois nós serão gerados na cena: EasyAR.Mega.Annotation e MegaBlocks.
Selecione o nó EasyAR.Mega.Annotation. No painel Inspector, aparecerão campos para inserir nome de usuário/e-mail e senha.
Fazer login na conta
Insira a conta e senha do EasyAR. Após clicar em login, se for bem-sucedido, as ferramentas do Studio aparecerão no painel Inspector.
Selecionar biblioteca de localização Mega Cloud
Clique no ícone à direita de Mega Cloud Service.
Selecione a biblioteca que deseja usar.
Após o carregamento bem-sucedido da biblioteca de localização e das informações do Mega Blocks, o painel de ferramentas do Studio será exibido conforme mostrado.
Carregar modelo denso do Block
Clique em Carregar à direita do nome do Block para carregar dinamicamente o modelo denso desse Block.
Após o carregamento, o modelo aparecerá na aba Scene. Observe que quando o indicador mostrado abaixo aparecer no canto inferior esquerdo, significa que o modelo no campo de visão atual ainda não foi totalmente carregado. Aguarde até que este indicador desapareça para confirmar o carregamento completo.
Criar anotação
Segure a tecla Ctrl (Windows) / Command (Mac) na cena e clique com o botão esquerdo do mouse no local desejado.
Usar modelo
Arraste o modelo importado para o nó da cena, tornando-o um nó filho da anotação.
No painel Inspector do modelo, altere Position e Rotation para 0. Scale pode ser ajustado conforme necessário.
Nota
O EMA gerencia toda a lógica de conversão de coordenadas. Definir Position e Rotation do modelo como 0 garante que seu centro geométrico coincida perfeitamente com o ponto de anotação. Todos os ajustes de posição e rotação devem ser feitos através do nó pai (nó de anotação).
[Opcional] Ajuste preciso da posição do modelo
Para ajustes precisos de posição e orientação do modelo, consulte Como usar o editor do Unity para alinhar conteúdo 3D com o mundo real.
Criar novo pacote de dados de anotação
Clique no ícone à direita do pacote de dados de anotação no painel Inspector.
Preencha o nome dos dados de anotação no campo e clique no símbolo de confirmação à direita.
Após a criação bem-sucedida, o resultado deve ser conforme mostrado. Clique em Confirmar abaixo.
Clique no ícone de upload para enviar.
Após o upload bem-sucedido, uma notificação será exibida.
Registrar ID da anotação
Você precisa registrar o nome ou ID dos dados de anotação para carregar os dados correspondentes no xr-frame.
Após o upload bem-sucedido, as informações correspondentes também estarão visíveis na biblioteca de localização em nuvem.
Aqui também é possível verificar o nome e o ID dos dados de anotação enviados.
Próximos passos
- Criar conteúdo 3D alinhado ao mundo real usando o editor Unity
- Experimente simular a execução no editor Unity
- Executar completamente o projeto de exemplo