Instalar as ferramentasInstall the tools

Obtenha as ferramentas necessárias para criar aplicativos para os headsets imersivos (VR) do Microsoft HoloLens e do Windows Mixed Reality.Get the tools you need to build applications for Microsoft HoloLens and Windows Mixed Reality immersive (VR) headsets. Não há nenhum SDK separado para o desenvolvimento no Windows Mixed Reality; você usará o Visual Studio com o SDK do Windows 10.There is no separate SDK for Windows Mixed Reality development; you'll use Visual Studio with the Windows 10 SDK.

Não tem um dispositivo de realidade misturada?Don't have a mixed reality device? Você pode instalar o emulador do HoloLens para testar algumas funcionalidades de aplicativos de realidade misturada sem um HoloLens.You can install the HoloLens emulator to test some functionality of mixed reality apps without a HoloLens. Você também pode usar o simulador do Windows Mixed Reality para testar seus aplicativos de realidade misturada para headsets imersivos.You can also use the Windows Mixed Reality simulator to test your mixed reality apps for immersive headsets. Se você estiver usando o Unity, poderá usar a simulação de entrada do MRTK (Kit de Ferramentas de Realidade Misturada) para testar vários tipos de interações de entrada, como entrada por rastreamento de mão e rastreamento ocular.If you're using Unity, you can use Mixed Reality Toolkit (MRTK)'s input simulation to test various types of input interactions such as hand-tracking and eye-tracking input.

É recomendável instalar o mecanismo de jogos Unity como a maneira mais fácil de começar a criar aplicativos de realidade misturada.We recommend installing the Unity game engine as the easiest way to get started creating mixed reality apps. No entanto, você também poderá criar com base no DirectX se quiser usar um mecanismo personalizado.However, you can also build against DirectX if you'd like to use a custom engine.

Dica

Adicione esta página aos favoritos e acesse-a regularmente para se manter atualizado sobre a versão mais recente de cada ferramenta recomendada para o desenvolvimento de realidade misturada.Bookmark this page and check it regularly to keep up-to-date on the most recent version of each tool recommended for mixed reality development.


Lista de verificação da instalaçãoInstallation checklist

FerramentaTool ObservaçõesNotes
Logotipo do WindowsWindows logo

Windows 10 (link de instalação manual)Windows 10 (Manual install link)

Instale a versão mais recente do Windows 10, para que o sistema operacional do seu computador corresponda à plataforma para a qual você está compilando aplicativos de realidade misturada.Install the most recent version of Windows 10 so your PC's operating system matches the platform for which you're building mixed reality applications.
Instalação do Windows 10Installing Windows 10
Você pode instalar a versão mais recente do Windows 10 via Windows Update nas Configurações ou criando uma mídia de instalação, usando o link na coluna à esquerda.You can install the most recent version of Windows 10 via Windows Update in Settings or by creating installation media, using the link in the left column.

Veja as notas de versão atuais para obter informações sobre os recursos mais recentes de realidade misturada disponíveis em cada versão do Windows 10.See current release notes for information about the newest mixed reality features available with each release of Windows 10. Ative o modo de desenvolvedor no seu computador em Configurações > Atualização e Segurança > Para Desenvolvedores.Enable developer mode on your PC at Settings > Update & Security > For developers.

Observação para computadores empresariais e corporativosNote for enterprise and corporate-managed PCs
Se o computador for gerenciado pelo departamento de TI da sua organização, talvez seja necessário contatá-los para atualizar.If your PC is managed by an your organization's IT department, you might need to contact them in order to update.

"N" versões do Windows'N' versions of Windows
Headsets imersivos (VR) do Windows Mixed Reality não são compatíveis com as versões "N" do Windows.Windows Mixed Reality immersive (VR) headsets are not supported on 'N' versions of Windows.
Imagem do logotipo do Visual StudioVisual Studio logo image

Visual Studio 2019 (16.2 ou superior) (link de instalação)Visual Studio 2019 (16.2 or higher) (Install link)

Ambiente de desenvolvimento integrado (IDE) completo para Windows e muito mais.Fully-featured integrated development environment (IDE) for Windows and more. Você usará o Visual Studio para escrever o código, depurar, testar e implantar.You'll use Visual Studio to write code, debug, test, and deploy.
Instalação do Visual Studio 2019Installing Visual Studio 2019
Certifique-se de instalar as seguintes cargas de trabalho:Be sure you install the following workloads:

● Desenvolvimento para desktop com C++● Desktop development with C++
● Desenvolvimento da UWP (Plataforma Universal do Windows)● Universal Windows Platform (UWP) development

Na carga de trabalho da UWP, certifique-se de verificar o seguinte componente opcional caso você esteja desenvolvendo para o HoloLens:Within the UWP workload, be sure to check the following optional component if you'll be developing for HoloLens:

● Conectividade do dispositivo USB● USB Device Connectivity

Observação sobre o UnityNote about Unity
A menos que você esteja tentando instalar intencionalmente uma versão (não LTS) mais recente do Unity para uma finalidade específica, recomendamos não instalar a carga de trabalho do Unity como parte da instalação do Visual Studio. Em vez disso, instale o fluxo 2019 LTS do Unity, conforme indicado abaixo.Unless you're intentionally trying to install a newer (non-LTS) version of Unity for a specific purpose, we recommend not installing the Unity workload as part of Visual Studio installation, and instead install the Unity 2019 LTS stream as noted below.

Problemas conhecidosKnown issues
há alguns problemas conhecidos com a depuração de aplicativos de realidade misturada no Visual Studio 2019 versão 16.0.There are some known issues with debugging mixed reality apps in Visual Studio 2019 version 16.0. Verifique se você atualizou o Visual Studio 2019 para a versão 16.2 ou superior.Please ensure that you update to Visual Studio 2019 version 16.2 or higher.
Logotipo do WindowsWindows logo

SDK do Windows 10 (10.0.18362.0) (link de instalação manual)Windows 10 SDK (10.0.18362.0) (Manual install link)

Fornece os cabeçalhos, bibliotecas, metadados e ferramentas mais recentes para a compilação de aplicativos do Windows 10 no HoloLens 2.Provides the latest headers, libraries, metadata, and tools for building Windows 10 apps on HoloLens 2.
Para criar aplicativos do HoloLens 2, você precisará instalar o SDK do Windows, build 18362 ou posterior.To build HoloLens 2 apps, you must install the Windows SDK, build 18362 or later.

Se você estiver desenvolvendo aplicativos somente para headsets do Windows Mixed Reality de área de trabalho ou HoloLens (1ª geração), poderá usar o SDK do Windows instalado pelo Visual Studio 2017.If you are only developing applications for desktop Windows Mixed Reality headsets or HoloLens (1st gen), you can use the Windows SDK installed by Visual Studio 2017.
Logotipo do Visual StudioVisual Studio logo

Emulador do HoloLens 2 (Windows Holographic, versão 2004, atualização de outubro de 2020) (Link de instalação: 10.0.19041.1124)HoloLens 2 Emulator (Windows Holographic, version 2004 October 2020 Update) (Install link: 10.0.19041.1124)

Emulador do HoloLens (1ª geração) (link de instalação: 10.0.17763.134)HoloLens (1st gen) Emulator (Install link: 10.0.17763.134)

O emulador permite executar aplicativos em uma imagem de máquina virtual do HoloLens sem um HoloLens físico.The emulator lets you run applications on a HoloLens virtual machine image without a physical HoloLens.

Veja Usando o emulador do HoloLens para obter mais informações sobre como começar a usar o emulador.See Using the HoloLens emulator for more information on getting started with the emulator.

O sistema deve ser compatível com Hyper-V para a instalação do emulador ser bem-sucedida.Your system must support Hyper-V for the emulator installation to succeed. Consulte a seção de Requisitos de sistema abaixo para obter detalhes.Reference the System Requirements section below for details.

Observação sobre o Emulador do HoloLens (1ª geração)Note on HoloLens (1st gen) Emulator
O Visual Studio 2017 é necessário para concluir a instalação com êxito.Visual Studio 2017 is required to successfully complete the installation. Se você está instalando o emulador do HoloLens (1ª geração) com o Visual Studio 2019, é necessário desmarcar os modelos do VS e adicioná-los manualmente mais tarde.If you're installing the HoloLens (1st gen) emulator with Visual Studio 2019 you need to deselect the VS templates and manually add them later on.

Escolha seu mecanismoChoose your engine

Agora que você tem o Windows 10, o Visual Studio e o SDK do Windows 10 prontos para uso, vamos escolher um mecanismo para a criação.Now that you have your Windows 10, Visual Studio, and Windows 10 SDK ready to go, let's choose an engine to build on.

Unity logo banner

1. Download the latest version

We recommend the Unity LTS (Long Term Support) stream as the best version to use when starting new projects, updating to its latest revision to pick up the latest stable fixes.

  • The current recommendation is to use Unity 2019, which is the LTS build required for MRTK v2 below.
  • If you need to use a different version of Unity for specific reasons, Unity supports side-by-side installs of different versions.

2. Import Mixed Reality Toolkit (MRTK)

MRTK

Mixed Reality Toolkit (MRTK) is an open-source, cross-platform development kit for mixed reality applications. MRTK provides a cross-platform input system, foundational components, and common building blocks for spatial interactions. The toolkit is intended to accelerate the development of applications targeting Microsoft HoloLens, Windows Mixed Reality immersive (VR) headsets, and the OpenVR platform.

For installation, we recommend completing the Getting Started section of our curated Unity development journey. If you're already following the Unity development journey, finish up the rest of the setup steps listed below and continue on to the HoloLens 2 Getting Started tutorials.

Importante

Note that installation instructions are targeted for the latest stable combination of MRTK and Unity releases, which are MRTK 2.4.0 and Unity 2019.3.15.

Observação

If you don't want to use MRTK for Unity, you'll need to script all interactions and behaviors yourself.

Other tools [optional]

3. Set up your PC for Mixed Reality development

The Windows 10 SDK works best on the Windows 10 operating system. This SDK is also supported on Windows 8.1, Windows 8, Windows 7, Windows Server 2012, Windows Server 2008 R2. Note that not all tools are supported on older operating systems.

Observação

You can develop and deploy your apps for HoloLens, VR immersive headsets, or both. Make sure you fulfill the requirements below depending on your needs.

For HoloLens development

When setting up your development PC for HoloLens development, please make sure it meets the system requirements for both Unity and Visual Studio. If you plan on using the HoloLens emulator, you'll want to make sure your PC meets the HoloLens emulator system requirements as well.

To get started with the HoloLens emulator, see Using the HoloLens emulator.

If you plan to develop for both HoloLens and Windows Mixed Reality immersive (VR) headsets, use the system recommendations and requirements in the section below.

Immersive (VR) headset requirements

Observação

The following guidelines are the current minimum and recommended specs for your immersive (VR) headset development PC, and are updated regularly.

Aviso

Do not confuse this with the minimum PC hardware compatibility guidelines, which outlines the consumer PC specs to which you should target your immersive (VR) headset app or game.

If your immersive headset development PC does not have full-sized HDMI and/or USB 3.0 ports, you'll need adapters to connect your headset.

There are currently known issues with some hardware configurations, particularly notebooks that have hybrid graphics.

Minimum Recommended
Processor Notebook: Intel Mobile Core i5 7th generation CPU, Dual-Core with Hyper Threading Desktop: Intel Desktop i5 6th generation CPU, Dual-Core with Hyper Threading OR AMD FX4350 4.2Ghz Quad-Core equivalent Desktop: Intel Desktop i7 6th generation (6 Core) OR AMD Ryzen 5 1600 (6 Core, 12 threads)
GPU Notebook: NVIDIA GTX 965M, AMD RX 460M (2GB) equivalent or greater DX12 capable GPU Desktop: NVIDIA GTX 960/1050, AMD Radeon RX 460 (2GB) equivalent or greater DX12 capable GPUDesktop: NVIDIA GTX 980/1060, AMD Radeon RX 480 (2GB) equivalent or greater DX12 capable GPU
GPU driver WDDM version WDDM 2.2 driver
Thermal Design Power 15W or greater
Graphics display ports 1x available graphics display port for headset (HDMI 1.4 or DisplayPort 1.2 for 60Hz headsets, HDMI 2.0 or DisplayPort 1.2 for 90Hz headsets)
Display resolution Resolution: SVGA (800x600) or greater Bit depth: 32 bits of color per pixel
Memory 8 GB of RAM or greater 16 GB of RAM or greater
Storage >10 GB additional free space
USB Ports 1x available USB port for headset (USB 3.0 Type-A) Note: USB must supply a minimum of 900mA
Bluetooth Bluetooth 4.0 (for accessory connectivity)

If you're new to MRTK development with Unity, we recommend following our curated Unity development journey:

Next Development Checkpoint

If you're following the Unity development checkpoint journey we've laid out, your next task is to work through our HoloLens 2 tutorial series.

You can always go back to the Unity development checkpoints at any time.