Table of Contents

Comece rápido com o desenvolvimento EasyAR Unity usando exemplos

Este tutorial explica como configurar e executar exemplos EasyAR Unity para iniciar rapidamente o desenvolvimento de RA.

Preparar um projeto unity vazio

Certifique-se de ter instalada uma versão compatível do unity (unity 2021.3 ou superior), recomendamos usar a versão mais recente do Unity 2022.3 ou Unity 6.3.

Crie um projeto unity vazio usando o modelo 3D (Built-in Render Pipeline):

Nota

Não é recomendado usar URP na primeira utilização.

Se estiver a usar Unity 6, necessita de transferir e usar manualmente o 3D (Built-In Render Pipeline) Template, que se encontra numa posição mais abaixo na lista de modelos por predefinição.

Importante

Para usar URP, deve efetuar configurações adicionais conforme descrito em Universal Render Pipeline (URP), caso contrário, a imagem da câmara não será exibida.

Importar EasyAR Sense Unity Plugin

  • Baixar o pacote do plugin
    • Baixe a versão mais recente do EasyAR Sense Unity Plugin, que inclui exemplos (samples).
    • Após descompactar o pacote zip, você verá um arquivo readme e arquivos .tgz. Os arquivos .tgz podem ser importados diretamente no Unity; não os descompacte.
    • Coloque o arquivo .tgz na pasta Packages do seu projeto Unity.
  • Importar o pacote do plugin
    • No menu superior, clique em Window e selecione Package Manager.
    • Na janela aberta, clique no símbolo + no canto superior esquerdo e escolha Install Package from tarball ....
    • Na caixa de diálogo, selecione o arquivo .tgz mencionado anteriormente.

ImportUnityPlugin

Nota

O arquivo .tgz não pode ser excluído ou movido para outro local após a importação no Unity. Coloque-o em um local adequado antes da importação. Recomenda-se armazená-lo na pasta Packages do projeto Unity para facilitar o controle de versão.

Importar amostra

Utilize o menu Window > Package Manager para abrir o Package Manager, selecione EasyAR Sense Unity Plugin e, no lado direito, escolha **All Samples** para importar todas as amostras de uma só vez.

Importar amostra

Cuidado

**All Samples** e outras amostras não podem ser importadas simultaneamente, caso contrário ocorrerão ativos duplicados, resultando na perda de recursos de algumas cenas. Se arquivos duplicados forem importados por engano, exclua-os e importe novamente.

Lista de cenas de modificação

Abra Build Settings (ou Build Profiles),

Adicione as cenas de exemplo do projeto Unity à Scene List do Build Settings ou Build Profiles, e mova a cena do lançador de amostras (AllSamplesLauncher) para a primeira posição entre todas as cenas.

Cuidado

Não adicione estas cenas de headset, ou a compilação pode falhar:

  • Combination_BasedOn_AppleVisionPro.rst
  • Combination_BasedOn_Xreal.rst

Preencher licença (License Key)

No menu do Unity, selecione EasyAR > Sense > Configuration para abrir a interface de configuração do EasyAR Sense.

FillInKey

No campo de entrada sob EasyAR Sense License, insira a EasyAR Sense License.

FillInKey2

Dica

A EasyAR Sense License pode ser criada no Centro de Desenvolvimento EasyAR (中文, 英文). Para uso inicial, siga estas etapas:

  • Crie EasyAR Sense 4.x Personal Edition
  • Para "Mapa Esparso do Espaço", selecione Sim, e preencha o nome livremente
  • Preencha o nome do aplicativo livremente. 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

copykey

Nota

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

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

Execução no editor

Executar no editor exige que seu computador tenha uma câmera conectada.

Verificar se a câmera do sistema está funcionando

Abra o aplicativo de câmera do sistema:

Confirme que a câmera funciona normalmente:

Por fim, lembre-se de fechar o aplicativo de câmera para evitar conflitos ao executar o exemplo.

Nota

O EasyAR usa apenas as interfaces fornecidas pelo sistema para abrir a câmera. Certifique-se de que o aplicativo de câmera do sistema pode abrir a câmera e exibir a imagem normalmente.

Executar exemplo

O conteúdo a seguir usa o exemplo de rastreamento de imagem ImageTracking_Targets como referência. Outros exemplos seguem um processo similar.

Abra o cenário do lançador de amostras e clique no botão Play no topo do editor Unity.

Entre no cenário ImageTracking_Targets.

[!DICA] Você também pode abrir diretamente o cenário ImageTracking_Targets e executá-lo.

Aponte a câmera para o seguinte marcador de identificação:

namecard

Endereço de download: 🔗 namecard

O EasyAR reconhecerá e rastreará esta imagem, sobrepondo objetos virtuais.

[!NOTA] Alguns recursos não podem ser executados conectando a câmera no editor, mas funcionam em dispositivos móveis. Exemplos incompatíveis com o editor exibirão um pop-up de falha ao iniciar.

Mensagens de alerta e logs de erro também serão exibidos.

Correr no telefone

É necessário modificar a configuração do Player antes do empacotamento.

Modificar configurações do Player

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

switchtoandroid

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

    androidPackageName

    Dica

    Por exemplo, se o Package Name inserido ao criar a License Key for com.mycompany.myproject, você DEVE definir o Package Name aqui como com.mycompany.myproject, caso contrário a execução falhará.

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

    androidAPILevel

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

    androidarm64

Empacotando aplicativos

Selecione File > Build Settings, escolha a plataforma de destino (Android/iOS) e então selecione switch platform.

switchplatform

Selecione Build ou Build And Run para compilar o projeto e instalá-lo no telefone. Ao executar, conceda as permissões necessárias.

buildandrun

Exemplo de execução

O conteúdo a seguir toma o exemplo de rastreamento de imagem ImageTracking_Targets como referência. Outros exemplos seguem um método de execução semelhante.

Após a execução, o cenário inicializado deve ser o cenário de lançador de exemplos.

Dica

Se, após a abertura, você não entrar no cenário do lançador de exemplos, verifique se configurou corretamente a lista de cenários em Build Settings ou Build Profiles, movendo AllSamplesLauncher para o primeiro lugar.

Entre no cenário ImageTracking_Targets.

Aponte a câmera do seu telefone para a seguinte imagem de reconhecimento:

namecard

Endereço de download: 🔗 namecard

O EasyAR irá reconhecer e rastrear esta imagem, sobrepondo objetos virtuais.

Próximos passos

Você executou com sucesso o exemplo de AR do Unity e pode estar interessado em como a cena AR demonstrada foi criada. Você pode ler os seguintes guias introdutórios em ordem:

Para o lançador de amostras, consulte as instruções detalhadas de uso:

Se desejar entender a configuração completa do projeto, consulte:

Se desejar aprender mais sobre como usar o EasyAR, comece aqui: