Bem-vindo à Ferramenta de Funcionalidades do Mixed Reality
Importante
A Ferramenta de Funcionalidades Mixed Reality só está disponível para o Unity neste momento. Se estiver a desenvolver no Unreal, veja a documentação de instalação das ferramentas .
A Ferramenta de Funcionalidades do Mixed Reality é uma nova forma de os programadores descobrirem, atualizarem e adicionarem pacotes de funcionalidades Mixed Reality em projetos do Unity. Pode procurar pacotes por nome ou categoria, ver as respetivas dependências e até ver as alterações propostas ao ficheiro de manifesto dos projetos antes de importar. Se nunca trabalhou com um ficheiro de manifesto, é um ficheiro JSON que contém todos os pacotes de projetos. Depois de validar os pacotes que pretende, a ferramenta funcionalidade Mixed Reality irá transferi-los para o projeto à sua escolha.
Requisitos de sistema
Antes de poder executar a Ferramenta de Funcionalidades do Mixed Reality, terá de:
- Um PC com Windows 10 ou 11 com uma ligação à Internet ativa
Nota
Se o PC estiver numa rede gerida por uma organização, certifique-se de que o acesso aos seguintes URLs é permitido:
- https://aka.ms/*
- https://learn.microsoft.com/*
- https://pkgs.dev.azure.com/*
- https://feeds.dev.azure.com/*
- https://mixedrealitycloud.pkgs.visualstudio.com/* (apenas para utilizadores especiais de acesso antecipado)
Download
Depois de configurar o seu ambiente:
- Transfira a versão mais recente da Ferramenta de Funcionalidades do Mixed Reality a partir do Centro de Transferências da Microsoft.
- Quando a transferência for concluída, deszipe o ficheiro e guarde-o no seu ambiente de trabalho
- Recomendamos que crie um atalho para o ficheiro executável para um acesso mais rápido
Nota
Se não estiver familiarizado com a utilização do Unity Package Manager, siga as nossas instruções da UPM.
Alterações nesta versão
A versão 1.0.2209.0-Preview inclui as seguintes melhorias:
- Adição da opção "mostrar funcionalidades de pré-visualização" à vista de funcionalidades de deteção
- Atualizado para .NET 6
- Consolidou a aplicação e o runtime .NET 6 num único executável para uma distribuição mais fácil
- Foi corrigido um problema em que um pedido de redução das versões de pacotes existentes era apresentado quando desnecessário
1. Introdução
Inicie a Ferramenta de Funcionalidades do Mixed Reality a partir do ficheiro executável, que apresenta a página inicial no primeiro lançamento:
Na página inicial, pode:
- Configurar definições de ferramentas com o botão ícone de engrenagem
- Utilize o botão de ponto de interrogação para iniciar o browser predefinido e apresentar a nossa documentação
- Selecione Iniciar para começar a detetar pacotes de funcionalidades
2. Selecionar o projeto do Unity
Para garantir que todas as funcionalidades detetadas são suportadas na versão do Unity do seu projeto, o primeiro passo é apontar o Mixed Reality Ferramenta de Funcionalidades para o seu projeto com o botão de reticências (à direita do campo de caminho do projeto).
Nota
A caixa de diálogo apresentada ao navegar para a pasta do projeto unity contém "_" como o nome do ficheiro. Tem de existir um valor para o nome do ficheiro permitir que a pasta seja selecionada.
Quando tiver localizado a pasta do projeto, clique no botão Abrir para regressar à Ferramenta de Funcionalidades do Mixed Reality.
Importante
A Ferramenta de Funcionalidades Mixed Reality efetua a validação para garantir que foi direcionada para uma pasta de projeto do Unity. A pasta tem de conter Assets
Packages
pastas e Project Settings
.
Assim que o projeto estiver selecionado, pode
- Funcionalidades de Restauro: transfira os pacotes enviados da Ferramenta de Funcionalidades listados no manifesto do projeto para Pacotes/MixedReality se ainda não estiverem presentes. A funcionalidade é semelhante a
nuget restore
no conceito. Normalmente, só precisa de executar esta operação se tiver um projeto (com pacotes de Ferramentas de Funcionalidades) clonado a partir de um repositório configurado para ignorar ficheiros tarball. Pode fechar a Ferramenta de Funcionalidades depois de restaurar se não precisar de obter novos pacotes.
e/ou
- Descobrir Funcionalidades: avance para a página seguinte para selecionar os pacotes que pretende adicionar ao projeto.
3. Detetar e adquirir pacotes de funcionalidades
As funcionalidades são agrupadas por categoria para facilitar a localização das coisas. Por exemplo, a categoria Mixed Reality Toolkit tem várias funcionalidades à sua escolha:
Nota
Se estiver a utilizar a versão de pré-visualização pública do MRTK3 no seu projeto, tem de ativar Show preview releases
conforme mostrado abaixo na caixa vermelha.
Quando a Ferramenta de Funcionalidades do Mixed Reality reconhece as funcionalidades importadas anteriormente, apresenta uma mensagem de notificação por cada uma.
Depois de fazer as suas escolhas, selecione Obter funcionalidades para transferir todos os pacotes necessários a partir do catálogo. Para obter mais informações, veja detetar e adquirir funcionalidades.
4. Importar pacotes de funcionalidades
Após a aquisição, é apresentado o conjunto completo de pacotes, juntamente com uma lista das dependências necessárias. Se precisar de alterar as seleções de funcionalidades ou pacotes, esta é a hora:
Recomendamos vivamente que utilize o botão Validar para garantir que o projeto unity pode importar com êxito as funcionalidades selecionadas. Após a validação, verá uma caixa de diálogo de pop-up com uma mensagem de êxito ou uma lista de problemas identificados.
Selecione Importar para continuar.
Nota
Depois de clicar no botão Importar , será apresentada uma mensagem simples se existirem problemas. A recomendação é clicar em Não e utilizar o botão Validar para ver e resolver os problemas.
Para obter mais informações, veja importar funcionalidades.
5. Rever e aprovar alterações ao projeto
O passo final é rever e aprovar as alterações propostas aos ficheiros de manifesto e de projeto:
- As alterações propostas ao manifesto são apresentadas à esquerda
- Os ficheiros a adicionar ao projeto estão listados à direita
- O botão Comparar permite a visualização lado a lado do manifesto atual e as alterações propostas
Para obter mais informações, veja Rever e aprovar modificações de projetos.
6. Projeto atualizado
Quando as alterações propostas forem aprovadas, o projeto unity de destino é atualizado para referenciar as funcionalidades de Mixed Reality selecionadas.
A pasta Pacotes do projeto unity tem agora uma subpastaMixedReality com os ficheiros do pacote de funcionalidades e o manifesto conterá as referências adequadas.
Regresse ao Unity, aguarde que as novas funcionalidades selecionadas sejam carregadas e comece a criar!