도구 설치

Microsoft HoloLens 및 Windows Mixed Reality 몰입형(VR) 헤드셋을 위한 애플리케이션을 빌드하는 데 필요한 도구를 다운로드하세요. Windows Mixed Reality 개발을 위한 별도 SDK는 없으므로 Windows 10 또는 Windows 11 SDK에서 Visual Studio를 사용합니다.

혼합 현실 디바이스가 없나요? HoloLens 에뮬레이터를 설치하면 HoloLens 없이도 혼합 현실 앱의 일부 기능을 테스트할 수 있습니다. Windows Mixed Reality 시뮬레이터를 사용하여 몰입형 헤드셋을 위한 혼합 현실 앱을 테스트할 수도 있습니다.

혼합 현실 앱 만들기를 시작하는 가장 쉬운 방법은 Unity 또는 Unreal 게임 엔진을 설치하는 것입니다. 그러나 사용자 지정 엔진을 사용하려는 경우에는 DirectX에 대해 빌드할 수도 있습니다.

Unity를 사용하는 경우 Mixed Reality Toolkit for Unity의 입력 시뮬레이션을 사용하여 손 인식 및 시선 추적 입력과 같은 다양한 유형의 입력 상호 작용을 테스트할 수 있습니다. Unreal 프로젝트의 경우 UX Tools 플러그 인을 사용하여 공통 입력 상호 작용 및 사용자 환경 기능을 테스트합니다.

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


설치 검사 목록

도구 참고
Windows 로고

Windows 10(수동 설치 링크) 또는 Windows 11(수동 설치 링크)

최신 버전의 Windows 10 또는 11을 설치합니다.
Windows 10 설치
설정의 Windows 업데이트를 통해 또는 왼쪽 열에 있는 링크를 사용해 설치 미디어를 만들어 최신 버전의 Windows 10 또는 11을 설치할 수 있습니다.

각 릴리스의 Windows 10 또는 11에서 사용할 수 있는 최신 혼합 현실 기능에 대한 내용은 현재 릴리스 정보를 참조하세요. 개발자를 위한 설정 > 업데이트 & 보안 > 에서 PC에서 개발자 모드를 사용하도록 설정합니다.

엔터프라이즈 및 회사 관리용 PC에 대한 참고 사항
조직의 IT 부서에서 PC를 관리하는 경우 업데이트하려면 해당 부서에 문의해야 할 수도 있습니다.

Windows용 'N' 버전
Windows Mixed Reality 몰입형(VR) 헤드셋은 'N' 버전의 Windows에서 지원되지 않습니다.
Visual Studio 로고 이미지

Visual Studio 2022(설치 링크)

Windows 등을 위한 전기능 IDE(통합 개발 환경)입니다. Visual Studio를 사용하여 코드를 작성하고, 디버그하고, 테스트하고, 배포합니다.
Visual Studio 2022 설치
다음 워크로드를 설치합니다.

● .NET 데스크톱 개발
● C++를 사용한 데스크톱 개발
● UWP(유니버설 Windows 플랫폼) 개발
● Unity를 사용한 게임 개발(Unity를 사용하려는 경우)

참고: Unity를 먼저 설치한 경우 이러한 워크로드 중 일부는 미리 설치될 수 있습니다. 성공적인 배포를 위해 이러한 워크로드가 모두 있는지 확인합니다.

UWP 워크로드 내에서 다음 구성 요소가 설치에 포함되어 있는지 확인합니다.

*● Windows 10 SDK 버전 10.0.19041.0 또는 10.0.18362.0 또는 Windows 11 SDK
● USB 디바이스 연결(USB를 통해 HoloLens에 배포/디버그하는 데 필요)
● C++(v142) 유니버설 Windows 플랫폼 도구(Unity 사용 시 필요)

HoloLens(1세대) 및 데스크톱 Windows Mixed Reality 헤드셋에 대한 참고 사항
데스크톱 Windows Mixed Reality 헤드셋 또는 HoloLens(1세대)용 애플리케이션만 개발하는 경우에는 Visual Studio 2017을 사용하고 이를 통해 설치된 Windows SDK를 사용할 수 있습니다.
Visual Studio 로고

HoloLens 2 에뮬레이터(Windows Holographic 버전 23H2 2023년 12월 업데이트)(설치 링크: 10.0.22621.1252)

HoloLens(1세대) 에뮬레이터(설치 링크: 10.0.17763.134)

이 선택적 에뮬레이터를 사용하면 실제 HoloLens 없이도 HoloLens 가상 머신 이미지에서 애플리케이션을 실행할 수 있습니다.

선택적 에뮬레이터 시작 방법에 대한 자세한 내용은 HoloLens 에뮬레이터 사용을 참조하세요.

에뮬레이터 설치를 성공적으로 수행하려면 시스템에서 Hyper-V를 지원해야 합니다. 자세한 내용은 아래 시스템 요구 사항 섹션을 참조하세요.

HoloLens(1세대) 에뮬레이터에 대한 참고 사항
설치를 성공적으로 완료하려면 Visual Studio 2017이 필요합니다. Visual Studio 2022를 사용하여 HoloLens(1세대) 에뮬레이터를 설치하는 경우 VS 템플릿을 선택 취소하고 Visual Studio Marketplace에서 설치해야 합니다.

원하는 엔진 설치

이제 Windows 10 또는 11, Visual Studio 및 Windows 10 또는 11 SDK를 사용할 준비가 되었으므로 원하는 엔진을 설치하고 설정하겠습니다.

문제 해결

개발자 모드 설정은 회색으로 표시됩니다.

디바이스에서 개발자 모드를 사용하는 데 문제가 발생하면 디바이스 소유자가 아닐 수 있습니다. 다중 사용자 모드에서 디바이스를 먼저 사용하는 사용자가 디바이스 소유자입니다. 이후 사용자는 개발자 모드 또는 기타 구성 변경을 사용하는 데 필요한 권한이 없습니다. 하지만 HoloLens 보안 설명서에 자세히 설명된 Autopilot 환경의 첫 번째 사용자가 디바이스 소유자가 아닐 수 있는 예외가 있습니다.

가능한 솔루션은 다음과 같습니다.

참고

디바이스 관리에 대한 자세한 내용은 HoloLens 디바이스 관리 개요에서 확인할 수 있습니다.

USB를 통해 배포할 수 없습니다.

USB를 통해 애플리케이션을 직접 배포할 수 없는 경우 위에 나열된 모든 설치 요구 사항을 충족했는지 확인하고 단계별 자습서를 따르세요.