Table of Contents

Usar AllSamplesLauncher para experimentar rapidamente amostras do EasyAR

O AllSamplesLauncher é um lançador de amostras integrado que pode ajudá-lo a familiarizar-se rapidamente com os vários recursos do EasyAR SDK. Através deste lançador, você pode alternar e executar todas as cenas de amostra oficiais com um único clique em um único projeto Unity, sem a necessidade de configurar manualmente vários projetos independentes.

Preparação

Antes de começar, certifique-se de ter concluído os seguintes preparativos:

  1. Instalou o Unity Hub e o Editor Unity
  2. Criou um novo projeto Unity
  3. Importou o EasyAR Sense Unity Plugin e importou todas as Amostras

Consulte a introdução em Início rápido para realizar as etapas.

Etapas detalhadas

  1. Abra todas as cenas em Amostras.
    Todas as cenas de amostra
  2. Clique na barra de menus File > Build Settings ou Build Profiles > Scene List.
  3. Arraste todas as cenas para a Scene List.
  4. Certifique-se de que o AllSamplesLauncher está em primeiro lugar em todas as cenas. Caso contrário, você pode arrastá-lo dentro da janela.
    Ordem da lista de cenas
  5. Clique na barra de menus File > Build And Run para empacotar e executar.
Nota

Ao empacotar para executar no telefone, não adicione cenas do tipo headset:

  • Combination_BasedOn_AppleVisionPro
  • Combination_BasedOn_Xreal
    Não carregar headset

Problemas encontrados durante o empacotamento

Durante a compilação e empacotamento, você pode encontrar alguns erros. Problemas comuns incluem:

Informação de erro Causa Solução
FileNotFoundException:EasyAR Settings Asset License não preenchida Clique na barra de menus EasyAR > Sense > Configuration, em EasyAR Sense License, insira sua License Key
Missing Prefab Asset: 'XR Interaction Setup' Arquivos relacionados a headset ausentes Exclua as cenas relacionadas a headset da lista de cenas de empacotamento. Se você precisar empacotar o headset, siga as etapas em Usar amostras de headset

Uso do lançador

Após a execução, você verá uma interface de lançador simples.

Página inicial do lançador

Clique no botão Samples no meio da parte inferior da interface para acessar amostras de todos os recursos.

Página de amostras do lançador

No lado esquerdo da interface estão as categorias de recursos e, no lado direito, a lista de amostras de cenas para cada recurso. Clique em diferentes amostras de cenas para experimentar todos os diferentes recursos oferecidos pelo EasyAR.

Além disso, na parte inferior da interface, são fornecidos vídeos de demonstração dos recursos EasyAR Sense e EasyAR Mega, que podem ajudá-lo a entender melhor os recursos e efeitos que o EasyAR pode oferecer.

Leitura obrigatória antes de executar amostras

Antes de executar amostras específicas, você deve concluir as seguintes configurações essenciais, caso contrário, as amostras não funcionarão corretamente:

  1. Defina sua API Key

    • Algumas amostras (especialmente aquelas envolvendo reconhecimento em nuvem, localização em nuvem Mega, etc.) requerem uma API Key válida.
    • Na barra de menus EasyAR > Sense > Configuration, encontre o lugar onde a amostra correspondente precisa ser preenchida.
    • Insira o App ID, API Key, API Secret que você solicitou no EasyAR Developer Center.
      Configuração de chave
    • Importante: Se você ainda não tiver uma API Key, algumas amostras de recursos locais (como rastreamento de imagem) ainda podem ser executadas, mas os recursos baseados em nuvem falharão. Certifique-se de acessar o EasyAR Developer Center para criar um aplicativo e obter a chave.

  2. Configurar suporte de plataforma/XR:

    • Se você estiver executando amostras relacionadas a headsets, consulte Usar amostras de headset.
    • Certifique-se de que seu dispositivo (como telefone ou headset) esteja conectado corretamente e no modo de desenvolvedor.

Explorando amostras em profundidade

O lançador de amostras é o melhor ponto de partida para aprender. Nós recomendamos enfaticamente que você:

  • Primeiro execute, depois estude: Através do lançador, experimente rapidamente o efeito de cada amostra para obter uma impressão intuitiva das capacidades do EasyAR.
  • Abra os arquivos de origem da cena: Cada amostra é um arquivo de cena Unity independente, localizado no diretório Assets/Samples/EasyAR Sense Unity Plugin/[versão]/__All Samples__/[nome do recurso]/[nome da amostra]/Scenes.
  • Estude e leia o código do script: Nas cenas de amostra, você pode abrir os scripts *.cs fornecidos com a amostra para ver como chamamos a API EasyAR para implementar recursos específicos. Esta é a melhor maneira de aprender como usar a API.

Através do lançador de amostras, você pode estabelecer rapidamente o conhecimento das funcionalidades do EasyAR SDK. Boa exploração!