Table of Contents

Usar exemplos do EasyAR em óculos ou headsets XR

O EasyAR fornece exemplos unificados para todos os headsets, que não possuem nenhum código, sendo totalmente implementados por configurações de cena. O uso das funcionalidades em si pode ser referenciado através da implementação de exemplos correspondentes em dispositivos Android/iOS.

Os exemplos de headsets são nomeados como Combination_BasedOn_*, por exemplo, o exemplo para Pico é Combination_BasedOn_Pico. Este exemplo demonstra a maioria das funcionalidades do EasyAR em uma única cena, que podem ser ativadas/desativadas dinamicamente, usadas individualmente ou simultaneamente.

Preparação

  • Confirme se seu headset ou óculos está na lista de suporte atual do EasyAR
  • Baixe e importe o pacote do plugin Unity do EasyAR
  • Baixe e importe o pacote de extensão para dispositivos XR do EasyAR
  • Obtenha uma licença do EasyAR adequada para headsets ou óculos XR. Os tipos de licença disponíveis incluem:
    • XR License de avaliação do EasyAR Sense 4.x (avaliação, ativada autonomamente no site do EasyAR)
    • XR License comercial do EasyAR Sense 4.x (paga, entre em contato com vendas para aquisição)
    • XR License empresarial do EasyAR Sense 4.x (para uso com SDK empresarial)
Cuidado

Em headsets e óculos, somente é permitido usar XR License. Licenças comuns não habilitam as funcionalidades do EasyAR.

Importar exemplos oficiais

  1. Exemplos para dispositivos com suporte nativo estão localizados no pacote do plugin Unity do EasyAR. Importe o exemplo necessário de acordo com o dispositivo. xr-samples-location

  2. Exemplos para dispositivos com suporte via extensão são distribuídos com a extensão do headset correspondente. Use o Unity para importar o exemplo no projeto. Exemplo para Pico: xr-pico-extension

Empacotar e executar o exemplo

Conclua separadamente a configuração do projeto do headset e as instruções de uso do exemplo.

Instruções de uso

O exemplo possui vários botões internos, com funcionalidades descritas abaixo. xr-sample-usage-7

  • Botão 1 HUD: alterna o modo de exibição da UI. No estado inicial, a UI fica fixa no mundo real; ao ativar o HUD, a UI permanece visível diante dos olhos.
  • Botão 2 Record: ativa/desativa a gravação EIF. Após ativar, é necessário desligar para gerar um arquivo EIF normal, caso contrário o arquivo será inutilizável.
  • Botão 3 Image: ativa/desativa o rastreamento de imagem.
  • Botão 4 Image Fusion: ativa/desativa o modo de rastreamento de imagem + fusão de movimento.
  • Botão 5 Dense: ativa/desativa o mapeamento espacial denso.
  • Botão 6 Sparse: ativa/desativa o mapeamento espacial esparso.
  • Botão 7 Mega: ativa/desativa o Mega.

Detalhamento de funcionalidades

  • Ativação padrão de funcionalidades

    Todas as funcionalidades iniciam desativadas por padrão, implementado pela desabilitação dos scripts correspondentes no editor. Os botões habilitam/desabilitam esses scripts. É possível configurar funcionalidades ativadas por padrão conforme o exemplo a ser executado.

    hmd-default-disable

  • Referência de origem do sistema de coordenadas

    No exemplo, um modelo estático de panda é colocado na origem do sistema de coordenadas do rastreamento de movimento para verificar seu estado. Este modelo ajuda a diagnosticar problemas, por exemplo, durante o uso do Mega, desvios rápidos podem ser causados por falhas no rastreamento do dispositivo (defeito intrínseco), fazendo o modelo acompanhar o desvio. O modelo de panda pode ser ajustado ou removido conforme necessário.

  • Usar imagem embutida para rastreamento

    • O exemplo pré-configura o tamanho da imagem usada no rastreamento de imagem plana. É necessário imprimir namecard.jpg em papel A4, mantendo a proporção original sem distorção ou corte, preenchendo a folha maximamente (imagem abaixo). namecard

    • Meça o comprimento físico do padrão impresso no papel. Com base nessa medida, defina a Scale de Image Target na cena do Unity como idêntica ao tamanho físico real (unidade em metros). set-the-actual-size

    • Com EasyAR fusão de movimento ativado, só é possível rastrear imagens em posição fixa (não móvel). Se a fusão de movimento estiver desligada, a imagem não será rastreada ao sair do campo de visão.

    • Às vezes, a perspectiva dos óculos não reflete bem o tamanho da imagem da câmera. Se o reconhecimento falhar, tente aproximar a câmera dos óculos da imagem. Para uso real, recomenda-se rastrear imagens maiores, como 5m x 5m.

Nota

Em headsets, independentemente do estado de ativação da funcionalidade de fusão de movimento do EasyAR, o parâmetro Scale do image target deve ser definido como o tamanho físico real, caso contrário a posição de exibição será incorreta.