Utilizar a ferramenta de validação de sessão

Este artigo introduz como utilizar a ferramenta de validação de sessão para validar rapidamente o fluxo de trabalho da sessão no editor e realizar simulações usando arquivos EIF.

Antes de começar

A simulação usa arquivos EIF como entrada, portanto, é necessário gravar um arquivo EIF antes de começar:

• Consulte Gravar arquivo EIF para gravar um arquivo EIF

Também é necessário compreender:

• Os conceitos básicos de Gravar arquivo EIF e usá-lo para simulação
• Os conceitos básicos, componentes e fluxo de trabalho de uma Sessão AR

Ferramenta de validação de sessão

A ferramenta de validação de sessão ajuda os desenvolvedores a validar rapidamente o fluxo de trabalho da sessão no editor do Unity e realizar simulações usando arquivos EIF.

Por padrão, a ferramenta pode ser vista na janela Inspector do objeto AR Session (EasyAR), sendo parte do editor DiagnosticsController:

Clique no botão ↗ no canto superior direito da ferramenta para abri-la em uma janela independente, facilitando a visualização e operação. Quando a janela for fechada ou o botão ↘ for pressionado, a ferramenta voltará a ser exibida na janela Inspector.

O efeito da ferramenta em execução é mostrado no vídeo abaixo:

Este vídeo demonstra o uso da ferramenta de validação de sessão, gravado no modo play do Unity. A parte superior esquerda mostra a visualização Hierarchy, o centro mostra a visualização Scene e a direita mostra a visualização Game. A parte inferior mostra a ferramenta de validação de sessão. O conteúdo da visualização Game é o mesmo que o usuário veria no mundo real em um dispositivo móvel.

No lado esquerdo superior da ferramenta, é exibida uma barra de progresso da reprodução do EIF, que muda conforme o progresso. No lado esquerdo inferior, mostra o estado atual da sessão. O lado direito mostra os componentes da sessão e os modos de centro disponíveis.

Na cena, podem ser vistos três recursos AR funcionando simultaneamente:

• Rastreamento de movimento: fornecido pelo frame player. A esfera azul é a XR Origin e o cone azul representa a posição do usuário.
• Mapeamento espacial denso: à medida que a perspectiva se move, malhas translúcidas são geradas continuamente.
• Rastreamento espacial esparso: no vídeo, uma árvore de Natal é rastreada, com objetos virtuais sobrepostos representados por uma nuvem de pontos azul-claro.

Iniciar a ferramenta

Clique no botão ▶ no topo da ferramenta para iniciá-la. Pressionar este botão tem o mesmo efeito que pressionar o botão ▶ na barra de ferramentas do Unity.

Se a ferramenta já estiver em execução, o botão se tornará ■. Clique nele para interromper a ferramenta.

Quando a ferramenta é exibida em uma janela independente, uma caixa de seleção à direita do botão ▶ permite escolher o objeto de sessão usado pela ferramenta. Se a janela for redefinida e a sessão for perdida, você pode selecioná-la novamente aqui.

Controlar a reprodução do EIF

Para usar a funcionalidade de reprodução de EIF da ferramenta, marque a opção Frame Player da ferramenta antes de executar. Isso fará com que a ferramenta gerencie a seleção da fonte de quadros durante a montagem da sessão. Independentemente do valor definido em AssembleOptions.FrameSource, o componente frame player será ativado.

Portanto, durante a execução, uma mensagem aparecerá informando que a fonte de quadros atual da sessão está sendo gerenciada pela ferramenta:

Nota

A ferramenta só gerencia a seleção da fonte de quadros durante a montagem no editor do Unity. Essa opção não tem efeito quando o aplicativo é compilado e executado.

Durante a execução normal, o controle de reprodução do EIF é exibido na parte superior da ferramenta, conforme destacado:

É possível controlar a reprodução do arquivo EIF com estes botões:

• ▶: Reproduzir, retomar a reprodução de um estado pausado ou parado
• ▮▮: Pausar
• ■: Parar
• ▮◀: Retroceder 5 segundos (quando suportado pelo arquivo)
• ◀◀: Reduzir a velocidade de reprodução (quando suportado pelo arquivo)
• ▶▶: Aumentar a velocidade de reprodução (quando suportado pelo arquivo)
• ▶▮: Avançar 5 segundos (quando suportado pelo arquivo)
• ▲: Abrir arquivo
• Barra de progresso: Clique para pular para uma posição (quando suportado pelo arquivo)

Você pode ajustar o conteúdo e a lógica de interação na cena durante a reprodução, permitindo realizar a maior parte do trabalho de desenvolvimento no computador e ver os resultados visualmente.

Nota

Ao reproduzir novos dados ou pular posições, os dados existentes na cena não são limpos. O estado dos componentes AR também não é redefinido. Eles se comportarão como se os dados da câmera tivessem saltado repentinamente do quadro anterior para os novos dados.

Embora isso não afete muito algumas funcionalidades, para recursos que dependem do rastreamento de movimento (como mapeamento espacial denso, Mega, etc.), pode causar estados anormais que afetam o desempenho.

Controlar o fluxo de trabalho da sessão

Para usar a funcionalidade de controle do fluxo de trabalho da sessão, marque a opção Session Workflow da ferramenta antes de executar. Esta opção está marcada por padrão.

Durante a execução normal, o controle do fluxo de trabalho da sessão é exibido abaixo do controle de reprodução, conforme destacado:

Na parte superior desta área, são exibidas as informações de estado de EasyARController.IsReady e ARSession.State.

Na parte inferior desta área, são fornecidos botões para controlar o fluxo de trabalho da sessão:

• Initialize: Inicializa a sessão. É possível escolher usar a chave de licença configurada em Project Settings ou inserir manualmente uma chave de licença
• Assemble: Monta, mas não inicia a sessão
• StartSession (Assembled): Inicia a sessão montada
• StartSession: Monta e inicia a sessão
• StopSession: Para a sessão
• StopSession (keep image): Para a sessão, mas mantém o plano de fundo da imagem
• Deinitialize: Desinicializa a sessão

Nota

Como esses controles chamam diretamente os métodos relevantes de ARSession e EasyARController, é possível usar esses botões para verificar o impacto das mudanças de estado da sessão no conteúdo. No entanto, é importante notar que, se métodos semelhantes também forem chamados nos scripts do aplicativo, o fluxo de execução pode sair do esperado pelo próprio aplicativo.

Controlar componentes da sessão

Para usar a funcionalidade de controle de componentes da sessão, marque a opção Session Workflow da ferramenta antes de executar. Esta opção está marcada por padrão.

Durante a execução normal, o controle de componentes da sessão é exibido na parte inferior ou direita da ferramenta, conforme destacado, dependendo da largura da janela:

O conteúdo desta área varia de acordo com a sessão específica. Por exemplo, a sessão usada na imagem acima inclui três componentes funcionais AR: rastreamento de imagem, mapeamento espacial denso e rastreamento espacial esparso. Portanto, a ferramenta exibe caixas de seleção para controlar essas três funcionalidades.

Geralmente, esta área exibe todos os componentes funcionais AR disponíveis na sessão e fornece controles para ativar/desativar (enabled) cada componente, incluindo:

• AR Session: Controla a ativação/desativação da própria sessão
• Image Renderer: Controla a ativação/desativação da renderização da imagem da câmera física
• Camera: Controla a ativação/desativação da câmera virtual
• Frame Source: Controla a ativação/desativação da fonte de quadros. Só pode ser controlado quando o frame player não está ativado. Quando o frame player está ativado, o controle é substituído pela seção de controle de reprodução do EIF
• Frame Filter: Controla a ativação/desativação de funcionalidades AR específicas
• Frame Recorder: Controla a ativação/desativação do componente de gravação de EIF. Só é visível quando o frame player não está ativado. Quando o frame player está ativado, este componente não é montado na sessão

A área também exibe os modos de centro disponíveis para a sessão e o relatório da sessão.

Nota

Os modos de centro disponíveis e o relatório da sessão exibidos na ferramenta são resultados da execução no editor. Eles podem ser diferentes quando executados em um dispositivo real.

Tópicos relacionados

• Experimente Simular usando arquivos EIF para controlar a reprodução de arquivos EIF via script
• Experimente controlar a execução da sessão via script em Controlar a execução da sessão
• Experimente acessar componentes funcionais AR via script em Acessar componentes da sessão
• Experimente obter resultados de execução da sessão via script em Obter saída da sessão
• Experimente a inicialização via script em Inicialização
• Experimente obter o relatório da sessão e determinar o suporte do dispositivo via script em Montar a sessão e obter relatório