Adicionar alvo de rastreamento Mega

Este artigo apresenta como adicionar e configurar os alvos de rastreamento do Mega.

Antes de começar

Verifique minha função de localização já pode ser usada? para confirmar que a biblioteca de localização foi criada corretamente e que o mapa foi adicionado.
Importe a versão mais recente do plugin EasyAR e ative o recurso Mega
Entenda os conceitos básicos e o modo de uso dos alvos de rastreamento do Unity AR

Nota

O conteúdo e as ferramentas a seguir se aplicam apenas ao processo de desenvolvimento de aplicativos Unity usando EasyAR Mega.

Se você estiver desenvolvendo um miniaplicativo, consulte criar e enviar anotações usando o Unity Editor (desenvolvimento de miniaplicativos).

Se você não estiver desenvolvendo um aplicativo Unity, mas quiser visualizar o resultado do mapeamento Mega, consulte visualizar malha 3D da cena real no guia de uso do Mega.

Se você não estiver desenvolvendo um aplicativo Unity, mas precisar simular a execução para ver o efeito de localização, consulte prévia do efeito de execução simulada no guia de uso do Mega.

Este conteúdo exige que os seguintes pacotes Unity já tenham sido importados no projeto:

Versão >= 4003
Versão 4.7 - 4002

com.easyar.sense

O alvo de rastreamento do Mega é um objeto vazio que contém o componente MegaBlockController. Ele representa um block no Unity.

alt text

Nota

Quando o pacote com.easyar.mega não foi importado, os recursos de editor do block não podem ser usados, mas isso não afeta o efeito de rastreamento e os recursos em runtime.

Se o recurso Mega não tiver sido ativado corretamente na configuração, ele não poderá ser usado.

alt text

Criar alvo de rastreamento

Versão >= 4003
Versão 4.7 - 4002

No espaço vazio da visualização Hierarchy, clique com o botão direito e use o menu EasyAR Sense > Mega > Target : Mega Block para criar um alvo de rastreamento Mega.

alt text

Em scripts, você pode usar ARSessionFactory.CreateController para criar.

ARSessionFactory.CreateController<MegaBlockController>();

Adicionar alvo de rastreamento no editor

Para usar este método, é necessário configurar BlockHolder.BlockRootSource como External (padrão) ou Mixed.

Primeiro, é necessário adicionar a ferramenta Block Viewer for Unity Developer.

No espaço vazio da visualização Hierarchy, clique com o botão direito e use o menu EasyAR Mega > Tool > Block Viewer for Unity Developer (Edit Mode) para adicionar a ferramenta Block Viewer usada no desenvolvimento Unity.

Importante

Ao desenvolver aplicativos Mega com Unity, é obrigatório usar a ferramenta Block Viewer for Unity Developer. Outras ferramentas no menu EasyAR Mega > Tool não são adequadas para desenvolvimento de aplicativos Unity.

Embora Annotation Tool também tenha funções semelhantes, parte de suas funções será removida em versões futuras, por isso seu uso não é recomendado.

A função de anotação do Annotation Tool (apenas a anotação em si) será migrada em breve para a página web do Centro de Desenvolvimento EasyAR. O carregamento da block mesh e o posicionamento de modelos não serão afetados.

Depois que a ferramenta for adicionada com sucesso, a hierarquia da cena terá um nó EasyAR.Mega.BlockViewer (Dev) e um nó MegaBlocks adicionais.

Em seguida, use a ferramenta para gerar o alvo de rastreamento.

Selecione o nó EasyAR.Mega.BlockViewer (Dev) e, no painel Inspector, preencha as informações da conta EasyAR e faça login;

Clique no botão à direita de Mega Cloud Service;

Selecione o serviço de localização Mega que precisa ser usado e clique em OK.

Depois de selecionar o serviço, a lista de blocks da biblioteca atual será exibida sob o nó MegaBlocks e também no painel da ferramenta.

Dica

Por que meu MegaBlocks está vazio?

Recomenda-se verificar minha função de localização já pode ser usada? para confirmar que a biblioteca de localização foi criada corretamente e que o mapa foi adicionado.

Neste ponto, o block de alvo de rastreamento já foi gerado. Cada nó filho sob MegaBlocks cujo nome começa com Block_ representa um alvo de rastreamento block.
Adicionar automaticamente o alvo de rastreamento quando a localização for bem-sucedida

Para usar este método, é necessário configurar BlockHolder.BlockRootSource como Internal ou Mixed.

Nesses dois modos, se um novo block for localizado e esse block não existir sob o nó BlockHolder.BlockRoot, ele será adicionado automaticamente sob o nó BlockHolder.BlockRoot. Se BlockHolder.BlockRoot não existir, ele será criado automaticamente.

Dica

Ao adicionar automaticamente o alvo de rastreamento quando a localização é bem-sucedida, não é possível carregar o modelo do block; apenas o alvo de rastreamento block pode ser adicionado.
Adicionar alvo de rastreamento em scripts

Para usar este método, é necessário configurar BlockHolder.BlockRootSource como Internal ou Mixed. Nesse caso, se BlockHolder.BlockRoot não existir, ele será criado automaticamente. Como alternativa, quando BlockHolder.BlockRootSource for External, também é possível especificar previamente o objeto BlockHolder.BlockRoot no editor.

Nota

Se o block não estiver na biblioteca de localização, mesmo que seja adicionado à cena por script, ele não poderá ser localizado.

Você pode usar o método BlockHolder.Hold para adicionar um novo block sob o nó BlockHolder.BlockRoot. Esse método geralmente é usado ao utilizar arquivos de anotação ema: depois que o script lê as informações de anotação, ele adiciona o block.

Por exemplo, o trecho de código abaixo mostra como usar informações do arquivo de anotação para adicionar um block:
```
foreach (var item in ema.blocks)
{
    var info = new BlockController.BlockInfo { ID = item.id.ToString(), Timestamp = item.timestamp };
    if (!item.keepTransform && item.location.OnSome)
    {
        blockHolder.Hold(info, item.location.Value);
    }
    else
    {
        blockHolder.Hold(info, item.transform.ToUnity());
    }
}
```
Dica

Ao usar script para adicionar alvo de rastreamento em runtime, não é possível carregar o modelo do block; apenas o alvo de rastreamento block pode ser adicionado.

Configurar alvo de rastreamento

Configurar a origem dos dados do target

Versão >= 4003
Versão 4.7 - 4002

O alvo de rastreamento só pode ser reconhecido e rastreado depois que sua origem é configurada corretamente.

Na visualização Hierarchy, selecione o nó do block e preencha o ID e o Name do block.

Em scripts, você pode modificar, antes de MonoBehaviour.Start() do componente, Source para configurar a origem do block.

block.Source = new MegaBlockController.BlockInfoSourceData(id, name);

Onde:

block id é o identificador único do block e deve ser preenchido.
block name é o nome do block. Pode ser preenchido livremente conforme a necessidade; em geral, recomenda-se preencher o nome real do block para facilitar a identificação.

Dica

block id e name podem ser obtidos na biblioteca de localização correspondente no Centro de Desenvolvimento EasyAR.

Se não houver dados de block na biblioteca de localização, será necessário adicionar o Block necessário à biblioteca de localização e verificar novamente se a biblioteca de localização em nuvem é válida.

Em MegaTrackerFrameFilter, especifique o target a ser usado, isto é, o block.

Na maioria dos casos, recomenda-se manter a configuração padrão, ou seja, usar o Mega Studio no editor para importar blocks.

Selecione o objeto Mega Tracker sob a session. A opção Block Root Source deve permanecer como External (padrão).

Ao mesmo tempo, é necessário especificar Block Root como o objeto MegaBlocks na cena.

Modificar a opção Block Root Source permite especificar outras formas de origem de block. Por exemplo, ao importar dados com ema, normalmente se escolhe a opção Internal ou Mixed.

Em scripts, você pode modificar BlockHolder.BlockRootSource para obter o mesmo efeito.

Configurar o rastreador usado pelo target

Versão >= 4003
Versão 4.7 - 4002

O alvo de rastreamento será carregado pelo rastreador configurado e rastreado depois que for localizado corretamente.

Na visualização Hierarchy, selecione o nó do block e depois selecione o Mega Tracker na session.

Em scripts, você pode modificar Tracker para configurar o rastreador do block.

block.Tracker = megaTracker;

Tracker pode ser modificado a qualquer momento em runtime, e o carregamento/descarregamento ocorrerá durante a execução da session. Se Tracker for definido como null, esse target será descarregado do rastreador configurado anteriormente. O carregamento de block é um processo virtual e não falhará.

Nota

Para que o target seja rastreado, há algumas condições essenciais:

O id de MegaBlockController.Source deve ser configurado corretamente antes de MonoBehaviour.Start().
O block correspondente ao id desse Source deve existir na biblioteca de localização.
MegaBlockController.Tracker deve estar configurado para usar a biblioteca de localização correta.

Normalmente não é necessária configuração adicional, mas se for preciso controlar rastreamento de múltiplos alvos, é possível configurar os itens correspondentes.

Na maioria dos cenários de uso do Mega, não há necessidade de usar múltiplos alvos. Antes de dominar como evitar que vários blocks interfiram entre si, recomenda-se colocar apenas um block em uma biblioteca de localização.

Dica

Em princípio, o Mega calcula a posição do dispositivo em todos os blocks, em vez de selecionar na biblioteca de localização o block que o dispositivo está vendo. Um uso mal considerado pode degradar o efeito por motivos como confusão de dados.

Selecione o objeto Mega Tracker sob a session e modifique a opção Multi Block para ativar ou desativar o rastreamento de múltiplos alvos.

Em scripts, você pode modificar BlockHolder.MultiBlock para obter o mesmo efeito.

Aviso

Em geral, uma biblioteca de localização só pode conter um block ao mesmo tempo.

Modificar a configuração de múltiplos alvos afetará o efeito de rastreamento e, em geral, não é recomendado. Use sob orientação do suporte técnico da EasyAR.

Se essa configuração tiver sido modificada durante a execução do aplicativo, informe isso ao relatar problemas à EasyAR.

Ciclo de vida do alvo de rastreamento

Versão >= 4003
Versão 4.7 - 4002

Um ciclo de vida comum de alvo de rastreamento é o seguinte:

flowchart LR
  sstart((session iniciada))
  sstop([session parada])
  
  start("Target.Start")
  load("Carregar")
  tracking[["Rastreamento contínuo"]]

  sstart --> load --> tracking --> sstop
  start -. "Target.Tracker = tracker" .-> load

O processo é dividido aproximadamente em várias etapas:

Carregamento: o alvo de rastreamento é carregado pelo rastreador configurado. Isso ocorre após Start() do próprio target e após a inicialização da session.
Processo de rastreamento: depois que o alvo de rastreamento é localizado, o rastreador continua rastreando a posição e o estado do alvo até que outro alvo seja localizado.
Descarregamento: o alvo de rastreamento é descarregado do rastreador, e o rastreador deixa de rastreá-lo. Isso ocorre quando a session para ou quando o target é configurado para não usar rastreador.

Table of Contents

Adicionar alvo de rastreamento Mega

Antes de começar

Nota

Alvos de rastreamento do Mega

Nota

Criar alvo de rastreamento

Importante

Dica

Dica

Nota

Dica

Configurar alvo de rastreamento

Configurar a origem dos dados do target

Dica

Configurar o rastreador usado pelo target

Nota

Dica

Aviso

Ciclo de vida do alvo de rastreamento

Próximos passos

Tópicos relacionados