Table of Contents

Comece rapidamente a usar o desenvolvimento do EasyAR Mega Unity com exemplos

Este tutorial explica como configurar e executar os exemplos do EasyAR Mega Unity para iniciar rapidamente o desenvolvimento com o EasyAR Mega.

Antes de começar

Antes de ler este artigo, certifique-se de que você concluiu:

  • Possuir uma biblioteca de localização na nuvem válida.
  • Instalar o Unity (2021.3.30 LTS ou versão superior), sendo recomendado 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 seguindo o método descrito em ativar o Mega.

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.

Importar amostra

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: Preencher a License Key e configurar o serviço de localização em nuvem Mega

  1. Na barra de menus, selecione EasyAR > Sense > Configuration;
    Guia de Licença
  2. Na janela Project Settings aberta, cole sua License Key;
    Preencher Licença
Dica

A EasyAR Sense License pode ser criada no EasyAR Developer Center. Para uso inicial, siga estas etapas:

  • Crie EasyAR Sense 4.x Personal Edition
  • Selecione Não para Mapa Esparso de Espaço
  • Preencha o nome do aplicativo livremente, e para Bundle ID e Package Name, insira com.mycompany.myproject
  • Selecione a licença recém-criada e clique no botão de cópia à direita

copiar chave

Nota

Bundle ID e Package Name podem ser alterados posteriormente, mas com limitação de vezes. Se você tiver um nome de pacote de aplicativo definido, também pode inserir o seu próprio.

A criação da versão pessoal não tem limite de quantidade. Outros tipos podem ser criados conforme necessário durante o uso formal.

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

A configuração da biblioteca de localização em nuvem Mega pode ser obtida no EasyAR Developer Center.
Detalhe da Configuração Mega
Certifique-se de que sua API Key tenha permissão para Mega Block. Se não tiver, é necessário alterar ou recriar.
Autorização da API Key

Passo três: Colocar conteúdo 3D

  1. Clique com o botão direito em uma área vazia no painel Hierarchy e adicione a ferramenta de visualização de Block (desenvolvimento Unity);
    Add Block Viewer

  2. Acesse o serviço de localização Mega;

    1. Selecione o nó EasyAR.Mega.BlockViewer (Dev), preencha suas informações de conta EasyAR no painel Inspector e faça login;
      login
    2. Clique no botão à direita de Mega Cloud Service;
      Click Mega CLS
    3. Selecione o Serviço de localização Mega que deseja usar e clique em OK.
      Select Mega CLS

  3. Carregar Block

    Após selecionar o serviço, a lista de Blocks no repositório atual será exibida sob o nó MegaBlocks e aparecerá no painel de ferramentas. Clique em Carregar para selecionar o Block:
    Load Block

    Após o carregamento, o Block será exibido na janela Scene. Você pode operar na janela Scene para ajustar o ângulo de visualização e a posição. Verifique também se o arquivo Block está utilizável (por exemplo, se o sistema de coordenadas do Block está normal, se há camadas, se está muito desfocado, danificado ou se impossibilita encontrar uma posição para colocar recursos AR, etc.).
    Display Block

  4. Colocar conteúdo 3D

    Agora, você pode posicionar objetos 3D com referência ao Block.
    Place 3D Object

    Nota
    • Os objetos 3D devem ser colocados sob o nó MegaBlocks > Block_* gerado automaticamente pela ferramenta, para garantir que a posição de renderização do conteúdo virtual esteja correta durante a execução.
    • Não modifique o nome do nó Block_* nem o transform local, pois ele é gerenciado automaticamente pela ferramenta.

Quarto passo: Configuração do MegaTracker

  1. Configurar Block Root;

    Expanda AR Session, selecione Mega Block Tracker e defina Block Root como o nó MegaBlocks gerado pela ferramenta.
    Set Block Root

Quinto passo: modificar a configuração do Player

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

switchtoandroid

  • Modifique Package Name para o Package Name exibido na página da License Key

    androidPackageName

    Dica

    Por exemplo, se o Package Name que inseriu ao criar a License Key foi com.mycompany.myproject, deve preencher aqui Package Name como com.mycompany.myproject, caso contrário irá falhar ao executar.

  • Modifique Minimum API Level para API Level 21 ou superior

    androidAPILevel

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

    androidarm64

Passo seis: construir e executar

  1. Adicione a cena atual em 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) e a License Key coincidem;
    Alternar plataforma
  3. Clique em Compilar e executar.
    Compilar e executar

O efeito de execução filmado no local é 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:

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

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

Controle refinado de recursos mega

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

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

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:

Se deseja utilizar o AR Foundation, comece aqui: