Tutorial do Mesh 201 Capítulo 1: Visão geral, configuração e introdução

Artigo
08/21/2024

Se você concluiu o tutorial do Mesh 101, começou a criar uma experiência de Mesh e ganhou uma sólida compreensão de Interactables, Física, Visual Scripting e muito mais. Neste tutorial "Mesh 201", você aproveita esse conhecimento. Você visitará várias estações e aprenderá o seguinte:

Como usar WebSlates para exibir conteúdo da Web em sua experiência.
Adicione um globo interativo. Quando um participante da sua experiência clica no globo, a latitude e a longitude do local clicado são capturadas e essas coordenadas são incorporadas a uma URL do Bing Maps como parâmetros. Uma solicitação HTTP é executada usando essa URL; O Bing Maps fornece um mapa da área escolhida e o envia para um WebSlate próximo, que é uma tela que pode exibir imagens, vídeos, conteúdo interativo e muito mais.

No final de maio de 2024, o tutorial do Mesh 201 foi atualizado para incluir duas estações adicionais que apresentam o Mesh Cloud Scripting, que você pode usar para chamar qualquer API .NET e trazer dados de nuvem em tempo real para seu ambiente. O tutorial do Mesh 101 foi projetado para ensinar aos participantes sua experiência sobre parques eólicos, e as duas novas estações continuam com esse tema, fornecendo aos participantes informações que podem ajudá-los a decidir onde construir um novo parque eólico. Nessas estações, você aprenderá a implementar o seguinte:

Extraia dados de fontes internas ou públicas para a sua cena. Um participante do evento poderá clicar em um globo interativo para visualizar dados meteorológicos ao vivo de três cidades que estão considerando para a localização de seu novo parque eólico.
Configure interações alimentadas por IA usando um assistente virtual baseado em OpenAI ou "chatbot". Um participante pode clicar em um botão "Info" e fazer perguntas sobre os melhores locais para parques eólicos. Você, o desenvolvedor, adicionará código que fornecerá o OpenAI LLM (Large Language Model com algum contexto para as perguntas relacionadas ao parque eólico que os participantes provavelmente estarão fazendo.

O projeto tutorial é chamado Mesh201 e está incluído quando você baixa os exemplos e tutoriais do Mesh do GitHub.

Importante

O projeto tutorial é regido pela licença MIT, conforme mostrado no arquivo LICENSE.txt no repositório Mesh-Toolkit-Unity . No entanto, a funcionalidade de amostras depende do kit de ferramentas Mesh, que é regido por uma licença separada e contém software de terceiros 3rd. Uma licença Teams Premium é necessária para usar o aplicativo Mesh para espaços imersivos personalizados no Mesh no PC e Quest. Não é necessária uma licença para desenvolver com o kit de ferramentas Mesh, mas você será impedido de criar e publicar Ambientes no Mesh e organizar ou participar de eventos no Mesh se você e seus usuários não tiverem licenças do Teams Premium. Para obter mais informações, consulte Configurar o M365 para Microsoft Mesh.

O tutorial está estruturado da seguinte forma:

Capítulo 1: Visão geral, configuração e introdução. (este artigo)
Capítulo 2: Carregue um arquivo HTML local não compartilhado em um WebSlate.
Capítulo 3: Carregue um arquivo HTML compartilhado local em um WebSlate.
Capítulo 4: Carregar um URL de um ativo 3D.
Capítulo 5: Clique em um globo interativo para obter dados meteorológicos ao vivo
Capítulo 6: Obter respostas a perguntas usando o Azure OpenAI

Pré-requisitos

Familiaridade com clonagem do GitHub e Git LFS

Experiência anterior em Unity

Este tutorial pressupõe que você tenha as habilidades Unity intermediárias a avançadas necessárias para editar um ambiente. Também recomendamos que você tenha alguma familiaridade com o Unity Visual Scripting. Um bom lugar para aprender noções básicas de Visual Scripting é através do tutorial Visual Scripting do Unity. Isso ensina a maioria, se não todos, os conceitos necessários para começar a usar o Mesh Visual Scripting.

Desenvolvimento anterior do Mesh com Visual Scripting ou conclusão do tutorial do Mesh 101

Se você vem desenvolvendo experiências de Mesh há algum tempo e está familiarizado não apenas com o Unity Visual Scripting em geral, mas também com alguns dos nós de Visual Scripting específicos de Malha mais comuns, você provavelmente pode concluir este tutorial com sucesso sem primeiro ter passado pelo tutorial do Mesh 101. Se você tiver alguma dúvida, é altamente recomendável que você conclua o tutorial do Mesh 101. Os recursos a seguir foram abordados na documentação do tutorial do Mesh 101 e também estão incluídos no projeto Mesh 201 Unity, mas não serão abordados novamente na documentação do Mesh 201. Se você sentir necessidade de entender melhor esses conceitos, clique nos links.

Desativar ícones de objetos para uma visão mais clara

Modo de jogo com emulação de malha

Câmera miniatura de malha

Requisitos de Hardware

Requisitos mínimos do PC: 4 núcleos de CPU, 8GB de RAM

Unity versão 2022.3.34

A versão Unity 2022.3.34 é necessária para este tutorial.

Revisar os requisitos do sistema para Unity

Obtenha ajuda para instalar o Unity

Sua instalação deve incluir módulos para Android e Windows. O aplicativo Mesh funciona para PC e Meta Quest, e Android é o sistema operacional para o Quest.

Configuração do Mesh Cloud Scripting

No final deste tutorial, você tem a opção de criar e publicar o projeto concluído no Mesh na Web e, em seguida, criar um evento a partir dele que você pode executar no aplicativo Mesh. Graças ao Emulador Mesh, você ainda pode ver como o projeto concluído ficará no aplicativo Mesh sem criar e publicar. Se você quiser passar pelo processo de compilação e publicação, precisará de alguma preparação extra para que o Mesh Cloud Scripting funcione. Para saber mais, consulte o artigo chamado Prepare-se para seu primeiro projeto de script de nuvem de malha e certifique-se de ter abordado os pré-requisitos listados lá.

Uma assinatura do M365 Office e familiaridade com o portal do Azure.

Você precisará usar o Portal do Azure para configurar o OpenAI no Capítulo 6.

Importante: o OpenAI só está disponível para clientes e parceiros empresariais aprovados. Se ainda não faz parte deste grupo, deve enviar um formulário de inscrição. Saiba mais sobre o processo de registo.

Configurar coisas para o Mesh

Baixe o aplicativo de desktop Mesh

Baixar Microsoft Mesh para PC

Microsoft Mesh - Aplicativos da Microsoft Store

______

Faça o download dos exemplos e tutoriais do Mesh

Para obter o tutorial do Mesh 201, você deve ir para o repositório Mesh-Toolkit-Unity e, em seguida, clonar o repositório.

______

NOTAS:

O GitHub também oferece a opção de baixar as amostras em um arquivo Zip. Recomendamos que você clone o repositório, pois é mais conveniente obter atualizações futuras simplesmente atualizando o repositório em vez de baixar um novo arquivo Zip toda vez.
No momento, não estamos aceitando contribuições de código para nossos exemplos. Se você tiver algum feedback ou se tiver algum problema com os exemplos ou o kit de ferramentas Mesh, faça o seguinte: em um projeto Unity que tenha o pacote do kit de ferramentas Mesh instalado, selecione Mesh Toolkit>Dê feedback à Microsoft e use o link de comentários no kit de ferramentas Mesh para nos informar.

Importante: Se você estiver clonando, deverá ter o Git LFS instalado.

Selecione o botão Código e, em seguida, clique no botão "Copiar url para a área de transferência".
Recomendamos que você crie uma pasta na unidade C: chamada "Mesh Samples" e, em seguida, clone o repositório para essa pasta. Este é um bom nome por dois motivos: é curto, por isso evita ter um problema com o limite de comprimento do caminho do Windows, que é de 256 caracteres. Além disso, existem outras amostras de Mesh, além do tutorial do Mesh 201, para que todas as suas amostras estejam localizadas em um só lugar.
Na pasta recém-criada, crie um repositório Git e, em seguida, clone o repositório colando o URL copiado após o comando git clone no Git Bash e pressionando a tecla Enter.

Pacote do kit de ferramentas Mesh

Para este tutorial, o único pacote que você precisa é o pacote do kit de ferramentas Mesh, e ele já está pré-carregado no projeto do tutorial. Se você estivesse criando seu próprio projeto do zero, precisaria importar o pacote do kit de ferramentas Mesh.

Cenas do projeto

Abra o projeto Mesh201 no Unity. Se você tiver mais de uma versão do Unity instalada, certifique-se de abrir o projeto com Unity 2022.3.34 o qual é necessário para este tutorial.

AVISO: O projeto pode levar 15 minutos ou um pouco mais para ser carregado devido ao grande tamanho dos ativos. Se precisar, altere a configuração do modo de suspensão para que o computador não entre em repouso enquanto o projeto está sendo carregado. Se isso acontecer, isso pode fazer com que o projeto não carregue corretamente.
Na pasta Ativos, observe que há duas cenas disponíveis: Ponto de Início e Projeto Concluído.

StartingPoint: Esta é a cena em que você fará o tutorial. Ele contém uma configuração pré-criada que inclui os WebSlates e o globo interativo que você visitará e adicionará recursos de Mesh.

FinishedProject: Como o título indica, esta cena contém uma versão completa precisa do tutorial. Você pode consultar isso a qualquer momento para confirmar que concluiu as etapas do tutorial na cena do StartingPoint corretamente. Guarde sempre o seu trabalho na cena StartingPoint antes de mudar de cena.

Experimentando o projeto concluído

Recomendamos que você abra a cena FinishedProject , execute-a e visite algumas das estações que ela contém para experimentar alguns dos recursos do Mesh que você implementará no tutorial. As estações estão localizadas em um GameObject chamado Sphere Terrace.

Uma captura de tela de um computador Descrição

Clique no botão Unity Editor Play.
As estações 1, 2 e 3 estão localizadas em um lado do Sphere Terrace. Navegue até esta área e, em seguida, posicione-se de modo a estar virado para as estações.
Aproxime-se das Estações 1 e 2 e clique nos botões Carregar . Observe que essa ação carrega páginas HTML no WebSlates.
Mova-se na frente da Estação 3 e, em seguida, clique em vários pontos diferentes no objeto Terra - você pode girá-lo clicando com o botão esquerdo sobre ele e, em seguida, arrastando. Observe como cada vez que você clica, um mapa dessa área aparece no WebSlate próximo.
Clique no botão Unity Editor Play para sair do modo Play.

Verifique a configuração "Escala" da janela Cena

Se as coisas parecerem um pouco desfocadas na janela Jogo quando você estiver no modo Jogar, dê uma olhada no controle deslizante Escala localizado logo acima da janela. Para a melhor fidelidade visual, o controle deslizante deve ser movido para a esquerda para que a escala seja igual a "1x".