Início Rápido: Renderizar um modelo com o Unity
Este início rápido aborda como executar um exemplo do Unity que renderiza um modelo interno remotamente usando o serviço do ARR (Azure Remote Rendering).
Não entraremos em detalhes sobre a própria API do ARR ou como configurar um novo projeto do Unity. Esses tópicos são abordados no Tutorial: Como exibir modelos renderizados remotamente.
Neste início rápido, você aprenderá a:
- Configurar seu ambiente de desenvolvimento
- Obter e criar o aplicativo de exemplo do Início Rápido do ARR para o Unity
- Renderizar um modelo no aplicativo de exemplo do Início Rápido do ARR
Pré-requisitos
Para obter acesso ao serviço do Azure Remote Rendering, primeiro você precisa criar uma conta.
O seguinte software deve ser instalado:
- SDK do Windows 10.0.18362.0 (baixar)
- A versão mais recente do Visual Studio 2022 (baixar)
- Ferramentas do Visual Studio para Realidade Misturada. Especificamente, as seguintes instalações de carga de trabalho são obrigatórias:
- Desenvolvimento para desktop com C++
- Desenvolvimento da UWP (Plataforma Universal do Windows)
- Git (baixar)
- Plug-in do Git LFS (baixar)
- Unity (confira requisitos do sistema para obter as versões compatíveis)
Clonar o aplicativo de exemplo
Abra um prompt de comando (digite cmd
no menu iniciar do Windows) e mude para um diretório no qual é interessante armazenar o projeto de exemplo do ARR.
Execute os seguintes comandos:
mkdir ARR
cd ARR
git clone https://github.com/Azure/azure-remote-rendering
powershell -ExecutionPolicy RemoteSigned -File azure-remote-rendering\Scripts\DownloadUnityPackages.ps1
O último comando cria um subdiretório no diretório do ARR que contém os vários projetos de exemplo para o Azure Remote Rendering.
O aplicativo de exemplo de início rápido para Unity é encontrado no subdiretório Unity/Quickstart.
Renderizar um modelo com o projeto de exemplo do Unity
Abra o Hub do Unity e adicione o projeto de exemplo, que é a pasta ARR\azure-remote-rendering\Unity\Quickstart. Abra o projeto. Se necessário, permita que o Unity atualize o projeto para a versão instalada.
O modelo padrão que renderizamos é um modelo de exemplo interno. Mostraremos como converter um modelo personalizado usando o serviço de conversão do ARR no próximo início rápido.
Inserir suas informações de conta
- No navegador de ativos do Unity, navegue até a pasta Cenas e abra a cena Início Rápido.
- Na Hierarquia, selecione o objeto de jogo RemoteRendering.
- No Inspetor, insira suas credenciais de conta. Se ainda não tiver uma conta, crie uma.
Importante
Defina RemoteRenderingDomain como <region>.mixedreality.azure.com
, em que <region>
é uma das regiões disponíveis perto de você.
Defina AccountDomain como domínio de contas, conforme exibido no portal do Azure.
Posteriormente, convém implantar esse projeto em um HoloLens e conectar-ao serviço do Remote Rendering nesse dispositivo. Como não temos uma forma fácil de inserir as credenciais no dispositivo, o exemplo de início rápido salvará as credenciais na cena do Unity.
Aviso
Não verifique o projeto com suas credenciais salvas em algum repositório no qual poderia haver vazamento de informações de logon secretas!
Criar uma sessão e ver o modelo padrão
Pressione o botão Reproduzir do Unity para iniciar a sessão. Você deve ver uma sobreposição com texto de status na parte inferior do visor no painel Jogo. A sessão passará por uma série de transições de estado. No estado Inicial, o servidor é criado, o que leva vários minutos. Após o êxito, ela faz a transição para o estado Pronto. Agora, a sessão entra no estado Conectando, em que ela tenta atingir o runtime de renderização nesse servidor. Quando bem-sucedido, o exemplo faz a transição para o estado Conectado. Neste ponto, ele começará a baixar o modelo para renderização. Devido ao tamanho do modelo, o download pode levar alguns minutos. Em seguida, o modelo renderizado remotamente será exibido.
Parabéns! Agora você está exibindo um modelo processado remotamente!
Inspecionar a cena
Após a execução da conexão da renderização remota, o painel Inspetor será atualizado com informações de status adicionais:
Agora você pode explorar o grafo de cena selecionando o novo nó e clicando em Mostrar filhos no Inspetor.
Há um objeto de plano de curte na cena. Tente habilitá-lo marcando a caixa na frente de CutPlane no painel Inspetor e mova-o:
Para sincronizar as transformações, clique em Sincronizar agora ou marque a opção Sincronizar todos os quadros. Para as propriedades do componente, alterá-las é o suficiente.
Próximas etapas
No próximo início rápido, implantaremos o exemplo em um HoloLens para ver o modelo renderizado remotamente no tamanho original.
Como alternativa, o exemplo também pode ser implantado em um PC desktop.