Bem-vindo(a) à Ferramenta de Recursos de Realidade Misturada

Imagem da faixa da Ferramenta de Recursos de Realidade Misturada

Importante

No momento, a Ferramenta de Recursos de Realidade Misturada só está disponível para o Unity. Se você estiver realizando o desenvolvimento no Unreal, veja a documentação de instalação das ferramentas.

A Ferramenta de Recursos de Realidade Misturada é uma nova maneira para os desenvolvedores descobrirem, atualizarem e adicionarem pacotes de recursos de Realidade Misturada em projetos do Unity. Você pode pesquisar pacotes por nome ou categoria, ver as respectivas dependências e, até mesmo, ver as alterações propostas no arquivo de manifesto dos seus projetos antes da importação. Se você nunca trabalhou com um arquivo de manifesto antes, é um arquivo JSON que contém todos os seus pacotes de projetos. Depois de validar os pacotes desejados, a ferramenta Recurso de Realidade Misturada os baixará no projeto de sua escolha.

Requisitos do sistema

Para executar a Ferramenta de Recursos de Realidade Misturada, você precisará do seguinte:

  • Um computador executando o Windows 10 ou 11 com uma conexão de Internet ativa

Observação

Se o PC estiver em uma rede gerenciada por uma organização, verifique se o acesso às seguintes URLs é permitido: https://aka.ms/https://feeds.dev.azure.com/https://video2.skills-academy.com/https://pkgs.dev.azure.com/https://mixedrealitycloud.pkgs.visualstudio.com/ (somente para usuários especiais de acesso antecipado)

Download

Depois de configurar seu ambiente:

Observação

Se não estiver usando o Gerenciador de Pacotes do Unity, siga nossas instruções do UPM.

Alterações nessa versão

A versão 1.0.2209.0-Preview inclui as seguintes melhorias:

  • A opção "mostrar versão prévia do recurso" foi adicionada à exibição de recursos de descoberta
  • Atualizado para .NET 6
  • Consolidou o aplicativo e o runtime do .NET 6 em um executável para facilitar a distribuição
  • Foi consertado um problema em que um prompt para downgrade de versões de pacote existentes aparece sem necessidade

1. Primeiros passos

Inicie a Ferramenta de Recursos de Realidade Misturada por meio do arquivo executável, que exibe a página inicial na primeira inicialização:

Introdução

Na página inicial, você poderá:

  • Definir as configurações da ferramenta usando o botão de ícone de engrenagem
  • Usar o botão de ponto de interrogação para iniciar o navegador da Web padrão e ver nossa documentação
  • Selecione Iniciar para começar a descobrir os pacotes de recursos

2. Como selecionar o projeto do Unity

Para garantir que todos os recursos descobertos são compatíveis com a versão do Unity do seu projeto, o primeiro passo é apontar a Ferramenta de Recursos de Realidade Misturada para seu projeto usando o botão de elipse (à direita do campo de caminho do projeto).

Selecionar o projeto do Unity

Observação

A caixa de diálogo exibida durante a navegação para a pasta de projeto do Unity contém '_' como o nome do arquivo. É necessário colocar um valor para o nome do arquivo a fim de permitir que a pasta seja selecionada.

Depois de localizar a pasta do projeto, clique em Abrir para retornar à Ferramenta de Recursos de Realidade Misturada.

Importante

A Ferramenta de Recursos de Realidade Misturada executa a validação para garantir que ela tenha sido direcionada para uma pasta de projeto do Unity. A pasta deve conter as pastas Assets, Packages e Project Settings.

Depois que o projeto for selecionado, você poderá

  • Restaurar recursos: baixe os pacotes enviados pela ferramenta de recursos listados no manifesto do projeto para Packages/MixedReality se eles ainda não estiverem presentes. O recurso é semelhante a nuget restore em termos de conceito. Normalmente, você só precisa executar essa operação se tiver um projeto (com pacotes da ferramenta de recursos) clonado de um repositório configurado para ignorar arquivos tarball. Você pode fechar a ferramenta de recursos após a restauração se não precisar obter novos pacotes.

e/ou

  • Descobrir recursos: prossiga para a próxima página para selecionar os pacotes que você deseja adicionar ao seu projeto.

3. Como descobrir e adquirir pacotes de recursos

Os recursos são agrupados por categoria para facilitar a localização dos itens. Por exemplo, a categoria Kit de Ferramentas de Realidade Misturada traz vários recursos para sua escolha:

Descoberta e aquisição

Observação

Se você usar a versão de visualização pública do MRTK3 em seu projeto, precisará habilitar Show preview releases conforme mostrado abaixo na caixa vermelha.

Configurações de recurso recomendadas para MRTK3

Quando a Ferramenta de Recursos de Realidade Misturada reconhece os recursos importados anteriormente, ela exibe uma mensagem de notificação para cada um.

Notificação do recurso importado

Depois de fazer suas escolhas, selecione Obter recursos para baixar todos os pacotes necessários do catálogo. Para obter mais informações, confira Como descobrir e adquirir recursos.

4. Como importar pacotes de recursos

Após a aquisição, o conjunto completo de pacotes é apresentado, juntamente com uma lista de dependências necessárias. Caso você precise alterar qualquer seleção de recurso ou pacote, esta é a hora:

Importando pacotes

Recomendamos expressamente usar o botão Validar para garantir que o projeto do Unity possa importar os recursos selecionados com êxito. Após a validação, você verá uma caixa de diálogo pop-up com uma mensagem de êxito ou uma lista dos problemas identificados.

Escolha Importar para continuar.

Observação

Depois que você clicar no botão Importar, se algum problema persistir, uma mensagem simples será exibida. A recomendação é clicar em Não e usar o botão Validar para ver e resolver os problemas.

Para obter mais informações, confira Como importar recursos.

5. Como examinar e aprovar as alterações do projeto

A etapa final é examinar e aprovar as alterações propostas para os arquivos de manifesto e de projeto:

  • As alterações propostas no manifesto são exibidas à esquerda
  • Os arquivos a serem adicionados ao projeto são listados à direita
  • O botão Comparar permite a exibição lado a lado do manifesto atual e das alterações propostas

Autorização

Para obter mais informações, confira Como examinar e aprovar as modificações do projeto.

6. Projeto atualizado

Quando as alterações propostas forem aprovadas, o projeto de destino do Unity será atualizado para referenciar os recursos de Realidade Misturada selecionados.

Projeto atualizado

A pasta Pacotes do projeto do Unity agora tem uma subpasta MixedReality com os arquivos do pacote de recursos e o manifesto conterá as referências apropriadas.

Volte ao Unity, aguarde até que os novos recursos selecionados sejam carregados e comece a criar!

Confira também