Configurar um novo projeto OpenXR sem MRTK

  • Artigo

Embora a Microsoft e a comunidade tenham criado ferramentas de open source como o Mixed Reality Toolkit (MRTK) que irá configurar automaticamente o seu ambiente para a realidade mista, alguns programadores poderão querer criar as suas experiências de raiz.

Outras opções de configuração não OpenXR a considerar

Windows XR: a Microsoft não recomenda a utilização do plug-in do Windows XR para novos projetos no Unity 2020. Em vez disso, deve utilizar o Mixed Reality plug-in OpenXR. No entanto, se estiver a utilizar o Unity 2019 e precisar do AR Foundation 2.0 para compatibilidade com dispositivos ARCore/ARKit, este plug-in ativa esse suporte.

Importante

A utilização deste plug-in no Unity 2019 não é compatível com o Azure Spatial Anchors.

XR Legado:

Se ainda estiver no Unity 2019 ou anterior, a Microsoft recomenda a utilização do suporte XR Incorporado Legado. Embora o plug-in do Windows XR esteja funcional no Unity 2019, não o recomendamos porque não é compatível com o Azure Spatial Anchors no Unity 2019.

Se estiver a iniciar um novo projeto, recomendamos que instale o Unity 2020 e utilize o plug-in openXR Mixed Reality.

Introdução ao OpenXR: Criar um novo projeto do Unity

  1. Inicie o Hub do Unity.

  2. No separador Projetos , clique em Novo Projeto.

    Captura de ecrã do Hub do Unity no separador Projetos com o botão Novo Projeto realçado.

  3. Clique no menu pendente por baixo de Novo projeto e, em seguida, selecione a versão do Editor que pretende.

    Captura de ecrã a mostrar o Hub do Unity com a versão pendente do Editor apresentada.

  4. Certifique-se de que o modelo escolhido é 3D Core.

  5. Na caixa Nome do projeto , introduza um nome para o projeto, por exemplo, "Tutorial do MRTK".

  6. Na caixa Localização , clique no ícone de pasta e, em seguida, navegue para a pasta onde pretende guardar o projeto e selecione-o. Também pode criar uma nova pasta.

    Captura de ecrã do Hub do Unity com 3D, Nome do Projeto, Localização e Criar realçados.

  7. Clique em Create Project (Criar Projeto). Esta ação abre o seu projeto no Unity.

    Captura de ecrã a mostrar o projeto aberto no Unity.

Atenção

Ao trabalhar no Windows, existe um limite MAX_PATH de 255 carateres. O Unity é afetado por estes limites e a compilação poderá falhar se algum caminho de ficheiro tiver mais de 255 carateres. Por conseguinte, recomendamos que armazene o projeto do Unity o mais próximo possível da raiz da unidade.

Definir o destino da compilação

  1. Na barra de menus, selecioneDefinições de Compilação de Ficheiros>....

    Para criar uma aplicação para Windows Mixed Reality, tem de escolher um destino de compilação. As definições de compilação para Plataforma Universal do Windows (UWP) visam qualquer dispositivo, incluindo headsets envolventes como o HP Reverb G2. Esta é a melhor opção se estiver a criar para o HoloLens 2. No entanto, se estiver a filtrar o VR de ambiente de trabalho, recomendamos que utilize o PC, Mac & plataforma Autónoma do Linux.

  2. Faça um dos seguintes:

    Se estiver a filtrar o VR de Ambiente de Trabalho:

    • Mantenha o PC, Mac & plataforma Autónoma do Linux , que está selecionada por predefinição num novo projeto do Unity:

    Captura de ecrã da janela Definições de Compilação aberta no editor do Unity com o PC, Mac & plataforma Autónoma realçada

    Se estiver a filtrar o HoloLens 2:

    • Em Plataforma, selecione Plataforma Universal do Windows. Certifique-se de que as seguintes definições estão ativas:

    Tipo de Compilação: Projeto D3D

    Versão do SDK de Destino: Instalada mais recentemente

    Versão Mínima da Plataforma: 10.0.10240.0

    Versão do Visual Studio: instalado mais recentemente

    Captura de ecrã da janela Definições de Compilação aberta no editor do Unity com Plataforma Universal do Windows realçado.

  3. Clique no botão Mudar de Plataforma . O Unity apresenta uma barra de progresso enquanto muda de plataforma.

  4. Após a conclusão do processo de mudança da plataforma, feche a janela Definições de Compilação.

Transferir e instalar a Ferramenta de Funcionalidades do Mixed Reality

O Mixed Reality Plug-in OpenXR é fornecido sob a forma de um pacote para o Unity. A melhor forma de detetar, atualizar e importar pacotes de funcionalidades é com a Ferramenta de Funcionalidades Mixed Reality. Pode procurar pacotes por nome ou categoria, ver as respetivas dependências e ver as alterações propostas ao ficheiro de manifesto do projeto antes de importar.

  1. Transfira a versão mais recente da Ferramenta de Funcionalidades do Mixed Reality a partir do Centro de Transferências da Microsoft.

  2. Após a conclusão da transferência, navegue para o ficheiro executável MixedRealityFeatureTool.exe e, em seguida, utilize-o para iniciar a Ferramenta de Funcionalidades do Mixed Reality.

    Captura de ecrã a mostrar a Abertura de MixedRealityFeatureTool.

Importar o Plug-in OpenXR do Mixed Reality

  1. Na Ferramenta de Funcionalidades do Mixed Reality, selecione Iniciar.

    Captura de ecrã a mostrar o ecrã de abertura da Ferramenta de Funcionalidades do Mixed Reality.

  2. Selecione o botão Procurar (é o botão "três pontos" na imagem abaixo) e, em seguida, navegue para a pasta que contém o projeto do Unity e, em seguida, abra-o.

    Abrir o projeto

    Nota

    A caixa Caminho do Projeto na Ferramenta tem de conter algum valor, pelo que insere uma barra invertida ("_") por predefinição.

    Depois de selecionar uma pasta, a Ferramenta verifica se é uma pasta de projeto do Unity válida.

    Captura de ecrã do ecrã Caminho do Projeto da Ferramenta de funcionalidade Mixed Reality.

  3. Selecione Descobrir Funcionalidades.

    Nota: poderá ter de aguardar alguns segundos enquanto a Ferramenta atualiza os pacotes a partir dos feeds.

  4. Na página Descobrir Funcionalidades , tenha em atenção que existe uma lista de seis grupos de pacotes.

    Os principais grupos de pacotes na Ferramenta de Funcionalidades do Mixed Reality

  5. Clique no botão "+" à esquerda do Suporte da Plataforma (0 de 5) e, em seguida, selecione a versão mais recente do Mixed Reality Plug-in OpenXR.

    Captura de ecrã a mostrar as seleções de pacotes na Ferramenta de Funcionalidades do Mixed Reality.

  6. Depois de efetuar as suas seleções, clique em Obter Funcionalidades.

  7. Selecione Validar para validar os pacotes que selecionou. Deverá ver uma caixa de diálogo a indicar Não foram detetados problemas de validação. Quando o fizer, clique em OK.

  8. Na página Importar Funcionalidades , a coluna do lado esquerdo, Funcionalidades, apresenta os pacotes que acabou de selecionar. A coluna do lado direito, Dependências necessárias, apresenta quaisquer dependências. Pode clicar na ligação Detalhes de qualquer um destes itens para saber mais sobre os mesmos.

  9. Quando estiver pronto para seguir em frente, selecione Importar. Na página Rever e Aprovar , pode rever as informações sobre os pacotes.

  10. Selecione Aprovar.

  11. Regresse ao Editor do Unity e clique numa área em branco na IU. Verá uma barra de progresso a mostrar que o pacote está a ser importado.

Configurar definições de Back-end de Entrada

  1. Depois de o Unity ter importado o pacote, é apresentado um aviso a perguntar se pretende ativar os back-ends ao reiniciar o editor. Selecione Yes (Sim).

    Captura de ecrã a mostrar a opção Reiniciar do Unity.

Configurar o projeto para o HoloLens 2 através da Validação do Projeto (MR OpenXR 1.6+)

Se estiver a desenvolver para vr de ambiente de trabalho, ignore esta secção e aceda a Configurar o projeto para VR de ambiente de trabalho.

  1. Na barra de menus, clique em Mixed Reality > Definições > de Validação do Projeto HoloLens 2 Aplicação (UWP) para ativar as regras de validação para HoloLens 2. Para plug-ins MR OpenXR antes da versão 1.9, o item de menu disponível é Mixed Reality > definições de projeto recomendadas do Project > Apply para HoloLens 2.
  2. Na janela de validação do projeto apresentada, certifique-se de que está no separador plataforma UWP (indicado pelo logótipo do Windows) e clique em Corrigir tudo para resolver os problemas de validação. Tenha em atenção que podem existir problemas que permanecem depois de clicar em Corrigir tudo. Nesse caso, experimente clicar em Corrigir tudo novamente, ignorar quaisquer problemas marcados como "específicos da cena" (se existirem) e percorrer os restantes problemas (se existirem) para ver se existem alterações sugeridas que pretenda fazer.
  3. Neste momento, o projeto está quase pronto para HoloLens 2 implementação. Avance para Configurar as definições do Leitor para o passo seguinte.

Configurar o projeto para o HoloLens 2 manualmente

Se estiver a desenvolver para vr de ambiente de trabalho, ignore esta secção e aceda a Configurar o projeto para VR de ambiente de trabalho.

  1. Certifique-se de que a janela Definições do Projeto está aberta. Caso contrário, na barra de menus, selecione Editar>Definições do Projeto.

  2. Na janela Definições do Projeto, certifique-se de que está na página Gestão do Plug-in XR e no separadorPlataforma Universal do Windows.

    Captura de ecrã da Janela Definições do Projeto aberta na Página de Gestão de Plug-ins XR e no separador Plataforma Universal do Windows.

  3. Certifique-se de que a opção Inicializar XR no Arranque está selecionada e, em seguida, em Fornecedores de Plug-in, clique em OpenXR.

    Captura de ecrã da Janela Definições do Projeto, no Plataforma Universal do Windows, com a opção Inicializar XR no Arranque selecionada e o Plug-in OpenXR realçado.

  4. O Plug-in OpenXR é carregado e, em seguida, são apresentados vários itens por baixo de OpenXR. Selecione Microsoft HoloLens grupo de funcionalidades.

    Captura de ecrã da Janela Definições do Projeto com o plug-in OpenXR e o Grupo de Funcionalidades do Microsoft HoloLens realçado.

Tenha em atenção que existe um triângulo de aviso amarelo junto a OpenXR. Isto indica que tem definições incompatíveis que precisam de ser resolvidas. Para saber como resolver este problema, ignore a secção seguinte sobre como configurar o VR e continue com a secção seguinte , Resolver definições incompatíveis.

Configurar o projeto para VR de ambiente de trabalho através da Validação do Projeto (MR OpenXR 1.9+)

  1. Na barra de menus, clique em Mixed Reality > Definições > de Validação do Projeto Da Aplicação Win32 (Autónoma) para ativar as regras de validação para uma aplicação XR de ambiente de trabalho.
  2. Na janela de validação do projeto apresentada, certifique-se de que está no separador Plataforma autónoma e clique em Corrigir tudo para resolver os problemas de validação. Tenha em atenção que podem existir problemas que permanecem depois de clicar em Corrigir tudo. Nesse caso, experimente clicar em Corrigir tudo novamente, ignorar quaisquer problemas marcados como "específicos da cena" (se existirem) e percorrer os restantes problemas (se existirem) para ver se existem alterações sugeridas que pretenda fazer.

Configurar manualmente o projeto para VR de ambiente de trabalho

  1. Certifique-se de que a janela Definições do Projeto está aberta. Caso contrário, aceda à barra de menus e selecione Editar>Definições do Projeto.

  2. Na janela Definições do Projeto , certifique-se de que está na página Gestão de Plug-ins XR e, no PC, Mac & separador Autónomo do Linux .

    Captura de ecrã da Janela Definições do Projeto aberta para a Página de Gestão de Plug-ins XR e PC, Mac & separador Autónomo do Linux.

  3. Certifique-se de que a opção Inicializar XR no Arranque está selecionada e, em seguida, em Fornecedores de Plug-in, clique em OpenXR.

    Captura de ecrã da Janela Definições do Projeto, no PC, mac & separador Autónomo do Linux, com a opção Inicializar XR no Arranque selecionada e o Plug-in OpenXR realçado.

  4. O Plug-in OpenXR é carregado e, em seguida, são apresentados dois itens por baixo de OpenXR. Selecione o primeiro, Windows Mixed Reality grupo de funcionalidades.

    Captura de ecrã a mostrar a Janela Definições do Projeto, o Plug-in OpenXR e Windows Mixed Reality grupo de funcionalidades realçado.

Tenha em atenção que existe agora um triângulo de aviso amarelo junto a OpenXR. Isto indica que tem definições incompatíveis que precisam de ser resolvidas. Para saber como resolver este problema, avance para a secção seguinte, Resolver definições incompatíveis.

Resolver definições incompatíveis

Importante

As imagens nesta secção mostram as opções no separador Plataforma Universal do Windows. No entanto, as instruções são as mesmas para o separador VR do Ambiente de Trabalho, exceto quando indicado.

  1. Paire o cursor sobre o triângulo de aviso amarelo junto a OpenXR, leia a mensagem no pop-up e, em seguida, selecione o triângulo.

    Captura de ecrã a mostrar um aviso sobre definições incompatíveis.

  2. Na janela Validação do Projeto OpenXR , existem vários problemas listados. Selecione o botão Corrigir Tudo . NOTA: esta lista pode ter um aspeto diferente consoante o separador em que se encontra.

    Captura de ecrã a mostrar o botão Corrigir Tudo na janela Validação do Projeto OpenXR.

  3. Um problema permanece e indica-lhe que tem de adicionar, pelo menos, um perfil de interação. Para tal, clique em Editar. Isto direciona-o para as definições do plug-in OpenXR na janela Definições do Projeto .

    Captura de ecrã da janela Definições do Projeto com as definições de OpenXR apresentadas.

  4. Por baixo de Perfis de Interação, anote o botão de sinal de adição (+).

    Captura de ecrã a mostrar o botão Adicionar Perfil de Interação.

  5. Clique no botão três vezes, sempre que escolher um perfil diferente:

    Perfil de Interação olhar para os olhos

    Perfil de Interação da Mão da Microsoft

    Perfil do Controlador de Movimento da Microsoft

    Captura de ecrã a mostrar os perfis de interação que devem ser adicionados.

    Se o Perfil de Interação olhar para o olho, ou qualquer outro perfil, aparecer com um triângulo amarelo junto ao mesmo, selecione o triângulo e, em seguida, na janela Validação do Projeto OpenXR , clique no botão Corrigir . Quando tiver terminado, feche a janela Validação do Projeto OpenXR .

    Captura de ecrã a mostrar o botão Corrigir do perfil de interação Olhar para o Olho.

  6. Na janela Definições do Projeto , em Grupos de Funcionalidades OpenXR, certifique-se de que estão selecionados os seguintes:

    Se estiver no separador VR do Ambiente de Trabalho:

    Windows Mixed Reality

    Controlo manual

    Modelo de Controlador de Movimento

    Captura de ecrã a mostrar os Grupos de Funcionalidades OpenXR para o separador VR de Ambiente de Trabalho.

    Se estiver no separador Plataforma Universal do Windows:

    Microsoft HoloLens

    Controlo manual

    Modelo de Controlador de Movimento

    Captura de ecrã a mostrar as funcionalidades selecionadas para OpenXR.

  7. Clique no menu pendente Modo de Submissão de Profundidade e, em seguida, selecione Profundidade 16 Bits.

    Captura de ecrã a mostrar a Profundidade de 16 Bits selecionada para Modo de Submissão de Profundidade.

    Dica

    Reduzir o Formato de Profundidade para 16 bits é opcional, mas pode melhorar o desempenho gráfico no seu projeto. Para saber mais, veja Partilha de memória intermédia de profundidade (HoloLens).

    Nota

    A definição Modo de Composição , localizada imediatamente acima do Modo de Submissão de Profundidade, está predefinida como Instância de Passagem Única. Nas aplicações de realidade mista, a cena é composta duas vezes: uma para cada olho. O resultado é "visão estereoscópica". Isto duplica a quantidade de computação necessária, pelo que é importante selecionar o caminho de composição mais eficiente no Unity para poupar no tempo da CPU e da GPU. A composição de instâncias de passe único é a melhor opção aqui – recomendamos que a ative por predefinição para cada projeto. Para saber mais sobre isto, veja a documentação do Unity.

Configurar as definições do Leitor

  1. Na coluna do lado esquerdo da janela Definições do Projeto , selecione Leitor.

  2. Tenha em atenção que, na janela Leitor , a caixa Nome do Produto já está preenchida. Isto é retirado do nome do projeto e será o nome apresentado no menu Iniciar do HoloLens.

    Captura de ecrã das Definições de Publicação do Unity com a caixa Nome do Projeto preenchida.

    Dica

    Para facilitar a localização da aplicação durante o desenvolvimento, adicione um caráter de sublinhado à frente do nome para o ordenar no topo de qualquer lista.

  3. Clique no menu pendente Definições de Publicação e, em seguida, no campo Nome do pacote, introduza um nome adequado.

    Captura de ecrã das Definições de Publicação do Unity com a caixa nome do pacote preenchida.

    Nota

    O nome do pacote é o identificador exclusivo da aplicação. Se quiser evitar substituir as versões instaladas anteriormente da aplicação com o mesmo nome, deve alterar este identificador antes de implementar a aplicação.

  4. Feche a janela Definições do Projeto .

Está pronto para começar a desenvolver com o OpenXR no Unity!

Projetos de exemplo do Unity

Veja o repositório de exemplos openXR Mixed Reality para projetos do Unity de exemplo que mostram como criar aplicações do Unity para HoloLens 2 ou headsets Mixed Reality com o plug-in OpenXR Mixed Reality.

Ver também