도구 설치Install the tools

Microsoft HoloLens 및 Windows Mixed Reality 몰입형(VR) 헤드셋을 위한 애플리케이션을 빌드하는 데 필요한 도구를 다운로드하세요.Get the tools you need to build applications for Microsoft HoloLens and Windows Mixed Reality immersive (VR) headsets. Windows Mixed Reality 개발을 위한 별도 SDK는 없으므로 Windows 10 SDK에서 Visual Studio를 사용합니다.There is no separate SDK for Windows Mixed Reality development; you'll use Visual Studio with the Windows 10 SDK.

혼합 현실 디바이스가 없나요?Don't have a mixed reality device? HoloLens 에뮬레이터를 설치하면 HoloLens 없이도 혼합 현실 앱의 일부 기능을 테스트할 수 있습니다.You can install the HoloLens emulator to test some functionality of mixed reality apps without a HoloLens. Windows Mixed Reality 시뮬레이터를 사용하여 몰입형 헤드셋을 위한 혼합 현실 앱을 테스트할 수도 있습니다.You can also use the Windows Mixed Reality simulator to test your mixed reality apps for immersive headsets. Unity를 사용하는 경우 MRTK(Mixed Reality Toolkit)의 입력 시뮬레이션을 사용하여 손 인식 및 시선 추적 입력과 같은 다양한 유형의 입력 상호 작용을 테스트할 수 있습니다.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.

혼합 현실 앱 만들기를 시작하는 가장 쉬운 방법은 Unity 게임 엔진을 설치하는 것입니다.We recommend installing the Unity game engine as the easiest way to get started creating mixed reality apps. 그러나 사용자 지정 엔진을 사용하려는 경우에는 DirectX에 대해 빌드할 수도 있습니다.However, you can also build against DirectX if you'd like to use a custom engine.

이 페이지에 책갈피를 지정하고 정기적으로 확인하면서 혼합 현실 개발에 권장되는 각 도구를 최신 상태로 유지하세요.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.


설치 검사 목록Installation checklist

도구Tool 참고Notes
Windows 로고Windows logo

Windows 10(수동 설치 링크)Windows 10 (Manual install link)

PC의 운영 체제가 혼합 현실 애플리케이션을 빌드하는 플랫폼과 일치하도록 최신 버전의 Windows 10을 설치합니다.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.
Windows 10 설치Installing Windows 10
설정의 Windows 업데이트를 통해 또는 설치 미디어를 만들어(왼쪽 열의 링크 사용) 최신 버전의 Windows 10을 설치할 수 있습니다.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.

각 릴리스의 Windows 10에서 사용할 수 있는 최신 혼합 현실 기능에 대한 내용은 현재 릴리스 정보를 참조하세요.See current release notes for information about the newest mixed reality features available with each release of Windows 10. 설정 > 업데이트 및 보안 > 개발자용에서 PC의 개발자 모드를 사용하도록 설정합니다.Enable developer mode on your PC at Settings > Update & Security > For developers.

엔터프라이즈 및 회사 관리용 PC에 대한 참고 사항Note for enterprise and corporate-managed PCs
조직의 IT 부서에서 PC를 관리하는 경우 업데이트하려면 해당 부서에 문의해야 할 수도 있습니다.If your PC is managed by an your organization's IT department, you might need to contact them in order to update.

Windows용 'N' 버전'N' versions of Windows
Windows Mixed Reality 몰입형(VR) 헤드셋은 'N' 버전의 Windows에서 지원되지 않습니다.Windows Mixed Reality immersive (VR) headsets are not supported on 'N' versions of Windows.
Visual Studio 로고 이미지Visual Studio logo image

Visual Studio 2019(16.2 이상) (설치 링크)Visual Studio 2019 (16.2 or higher) (Install link)

Windows 등을 위한 전기능 IDE(통합 개발 환경)입니다.Fully-featured integrated development environment (IDE) for Windows and more. Visual Studio를 사용하여 코드를 작성하고, 디버그하고, 테스트하고, 배포합니다.You'll use Visual Studio to write code, debug, test, and deploy.
Visual Studio 2019 설치Installing Visual Studio 2019
다음 워크로드를 설치합니다.Be sure you install the following workloads:

● C++를 사용한 데스크톱 개발● Desktop development with C++
● UWP(유니버설 Windows 플랫폼) 개발● Universal Windows Platform (UWP) development

HoloLens 앱을 개발하려는 경우 UWP 워크로드 내에서 다음과 같은 선택적 구성 요소를 확인해야 합니다.Within the UWP workload, be sure to check the following optional component if you'll be developing for HoloLens:

● USB 디바이스 연결● USB Device Connectivity

● Unity에 대한 참고 사항:Note about Unity
특정 목적을 위해 최신 버전의 Unity(비 LTS)를 설치하려는 경우가 아니면 Unity 워크로드를 Visual Studio 설치의 일부로 설치하지 말고, 대신 아래 설명된 것처럼 Unity 2019 LTS 스트림을 설치하는 것이 좋습니다.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.

알려진 문제Known issues
Visual Studio 2019 버전 16.0의 혼합 현실 앱 디버깅에는 몇 가지 알려진 이슈가 있습니다.There are some known issues with debugging mixed reality apps in Visual Studio 2019 version 16.0. Visual Studio 2019 버전 16.2 이상으로 업데이트하세요.Please ensure that you update to Visual Studio 2019 version 16.2 or higher.
Windows 로고Windows logo

Windows 10 SDK(10.0.18362.0) (수동 설치 링크)Windows 10 SDK (10.0.18362.0) (Manual install link)

HoloLens 2에서 Windows 10 앱을 빌드하기 위한 최신 헤더와 라이브러리, 메타데이터, 도구를 제공합니다.Provides the latest headers, libraries, metadata, and tools for building Windows 10 apps on HoloLens 2.
HoloLens 2 앱을 빌드하려면 Windows SDK 빌드 18362 이상을 설치해야 합니다.To build HoloLens 2 apps, you must install the Windows SDK, build 18362 or later.

데스크톱 Windows Mixed Reality 헤드셋 또는 HoloLens(1세대)용 애플리케이션만 개발하는 경우에는 Visual Studio 2017에서 설치된 Windows SDK를 사용할 수 있습니다.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.
Visual Studio 로고Visual Studio logo

HoloLens 2 에뮬레이터(Windows Holographic 버전 2004, 2020년 10월 업데이트) (설치 링크: 10.0.19041.1124)HoloLens 2 Emulator (Windows Holographic, version 2004 October 2020 Update) (Install link: 10.0.19041.1124)

HoloLens(1세대) 에뮬레이터(설치 링크: 10.0.17763.134)HoloLens (1st gen) Emulator (Install link: 10.0.17763.134)

이 에뮬레이터를 사용하면 실제 HoloLens 없이도 HoloLens 가상 머신 이미지에서 애플리케이션을 실행할 수 있습니다.The emulator lets you run applications on a HoloLens virtual machine image without a physical HoloLens.

에뮬레이터 시작 방법에 대한 자세한 내용은 HoloLens 에뮬레이터 사용을 참조하세요.See Using the HoloLens emulator for more information on getting started with the emulator.

에뮬레이터 설치를 성공적으로 수행하려면 시스템에서 Hyper-V를 지원해야 합니다.Your system must support Hyper-V for the emulator installation to succeed. 자세한 내용은 아래 시스템 요구 사항 섹션을 참조하세요.Reference the System Requirements section below for details.

HoloLens(1세대) 에뮬레이터에 대한 참고 사항Note on HoloLens (1st gen) Emulator
설치를 성공적으로 완료하려면 Visual Studio 2017이 필요합니다.Visual Studio 2017 is required to successfully complete the installation. Visual Studio 2019를 사용하여 HoloLens(1세대) 에뮬레이터를 설치하는 경우 VS 템플릿을 선택 취소하고 나중에 수동으로 추가해야 합니다.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.

엔진 선택Choose your engine

Windows 10, Visual Studio, Windows 10 SDK가 준비되었으면 빌드할 엔진을 선택하겠습니다.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.

중요

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.

참고

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.

참고

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

참고

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

경고

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.