나중에 누군가 환경 설정을 할 때 도움이 될 수 있다면 좋겠다.

HoloLens 2 Environment setting guide

1. 필수 사항

일단 다음과 같은 사항이 반드시 필요하다.

1-1. Windows SDK

Unity Version을 설치 할 때 다음과 같이 설정하면 자동으로 설치된다.

image

혹시라도 설치가 안되어 있다면, 이곳에서 다운받을 수 있다

1-2. Unity

유니티 2018.4.x 이상 버전을 사용해야 한다.

프로젝트 타입은 3D 프로젝트로 만들면 된다.

1-3. Visual Studio

유니티를 설치할 때 2019 커뮤니티 버전이 설치되므로, 그냥 설치하면 된다.

1-4. HoloLens2 Settings

홀로렌즈2를 개발자용으로 설정해야 한다.

image

설정에 들어간다.

image

업데이트 및 보안에 들어간다.

image

Windows 업데이트가 있는지 확인한다.

만약 있다면, 최신 버전으로 업데이트 한다.

다음은 개발자용 탭에 들어간다.

image

개발자 모드를 켜준다.

image

장치 포털도 켜준다.





2. Unity Project 세팅

HoloLens2 용 App을 만들기 위한 처음 세팅을 진행하도록 한다.

2-1. 프로젝트 생성

2-1-1. 새로운 프로젝트 만들기

일단 2018.4.x 버전 이상으로 프로젝트를 만든다.

3D 프로젝트로 만들어야 한다.

2-1-2. 프로젝트의 타겟 플랫폼을 변경한다.

image

Ctrl+B를 눌러 빌드 세팅창을 띄워준다.

그 후, Universal Windows Platform을 선택한다.

그 후, 오른쪽 빨간 네모처럼 확인해준다. 반드시 네모와 같아야 한다!

만약 유니티 설치를 진행 할 때 UWP Module을 잘 설치했다면, 문제가 없을 것이다.

그리고 Switch Platform을 눌러준다.


2-2. MR 툴킷 머징

2-2-1. MRTK (Mixed Reality Tool Kit)을 임포트 한다.

MRTK의 최신 릴리즈 다운로드 페이지에 들어가서 유니티 패키지를 받는다.

여러개가 있을텐데 Foundation이라고 적힌 패키지만 받아도 된다.

그리고 메뉴에서 Asset > Import Package > Custome Package...를 눌러 Import all한다.

그러면 우리의 디렉토리에 MRTK가 임포트 된 것을 확인 할 수 있을 것이다.

2-2-2. MRTK Project Configurator 적용하기

image

그럼 바로 이런 창이 뜰 텐데 Apply 버튼을 눌러준다.

일단 이것으로 새로운프로젝트에 MRTK 머징은 완료되었다.


2-3. 프로젝트를 Mixed Reality용으로 변경한다.

2-3-1. XR Settings

image

Edit > Project Settings...에 들어가서, Player에 들어간다.

항목중 XR Settings라는 항목이 있을텐데, Virtual Reality Supported를 체크하고,

SDKs에 +버튼을 눌러 Window Mixed Reality를 추가한다.

2-3-2. Depth Format 설정

image

그후, Depth Format을 16-bit로 설정해준다.

2-3-3. Scene에 Tool Kit 배치

image

정상적으로 MRTK이 임포트되었다면, 메뉴 항목에 Mixed Reality Toolkit이 생긴 것을 볼 수 있을 것이다.

클릭 후 Add to Scene and Configure...를 누른다.

image

그럼 위 그림처럼 하이어라키에 MixedReality Toolkit과 MixedReality Playspace가 생겨 있을 것이다.

(추가로 큐브가 있는데 그건 그냥 한번 만들어본 것이니 무시해도 좋다.)


2-4. 프로젝트 빌드

2-4-1. 프로젝트 빌드하기

여기까지 따라했으면 .HelloWorld 수준의 HoloLens2 App을 만든것이다.

본 위키의 목적은 개발 환경세팅이니, 테스트를 위해 빌드를 해보자.

image

Ctrl + B를 눌러 Build Setting을 띄운다음, Build를 눌러 적당한 폴더에 빌드한다.

2-4-2. HoloLens2로 전송하기

빌드된 폴더를 열어보면, Visual Studio Project file이 있을것이다. 열어준다.

image

그럼 이렇게 Debug / ARM / 디바이스로 설정해준다.

그럼 이렇게 Release / ARM / 디바이스로 설정해준다.

(사진에는 Debug로 나와있지만, 반드시 Release로 해야한다.)

(Release로 하지 않으면 프레임 드랍 현상이 발생하는 것을 확인하였다.)


그리고 HoloLens를 컴퓨터에 연결한다. USB C Type Data 전송이 가능한 케이블을 사용한다.

image

연결하면 이렇게 정상적으로 연결이 되었다고 해야한다.

그리고 Ctrl + F5를 눌러 디버그하지 않고 시작을 한다.

잠시 기다리면, 홀로렌즈 앱이 실행되는 모습을 볼 수 있을 것이다.

image





3. Problem Solve Note

물론 이런 가이드라인이 있지만,

그대로 따라했음에도 불구하고 PC가 홀로렌즈2 인식을 못한다던가,

빌드는 되는데 프로젝트가 홀로렌즈2에 올라가지 않는다던가 하는 경우가 있을 수 있다.

여기에 모든 정답이 있는 것은 아니지만, 내가 시도하면서 경험하고 풀었던 팁을 적어보려고 한다.

추가적으로 업데이트 될 수 있으니 벽에 부딪힌다면 한번 참고하길 바란다


3-1. 홀로렌즈2를 인식하지 못 할 때

3-1-1. USB C Type 케이블이 Data 전송을 지원하는지 확인한다.

image

위와 같이 데이터 케이블을 써야 전송이 된다.

3-1-2. HoloLens2가 최신 업데이트인지 확인한다.

image

3-1-3. PC가 최신 업데이트인지 확인한다.

PC에서 Window키 > 업데이트 확인을 입력해서 OS 상태가 최신인지 확인한다.

의외로 나는 윈도우 업데이트를 진행하니 바로 인식이 되었다.

3-1-4. 다른 USB 포트에 연결해보기

다른 USB 포트에 연결하고 인식이 되는지 확인해보자


3-2. Visual Studio Project File이 본 그림과 다를 때

Debug / ARM / 디바이스로 설정하라고 했는데,

Release / ARM / 디바이스로 설정하라고 했는데,

항목 중 디바이스를 선택 할 수 없는 경우에 시도한다.

아래 항목을 시도한 다음, 다시 Unity에서 빌드하고 실행시켜본다.

3-2-1. Visual Studio Installer로 UWP를 설치해준다.

Window 키 > Visual Studio Installer를 입력해 인스톨러를 켜준다.

그리고 설치된 2019버전의 (업데이트 해야하면 업데이트하고) 수정 버튼을 눌러준다.

image

그리고 유니버셜 Windows 플랫폼 개발의 체크를 반드시 해 주고, 다시 수정을 눌러준다.

3-2-2. Unity Module이 잘 설치 되었는지 확인

image

Universal Windows Platform Build Support와 Windows Build Support (IL2CPP)를 반드시 체크해줘야 한다.

3-2-3. Visual Studio Project File에서 시작 프로젝트 설정

이 문제에 대한 MS 공식 답변이 있는데, 아래와 같다.

디바이스가 대상 옵션으로 보이지 않으면, Visual Studio 솔루션의 시작 프로젝트를 IL2CPP 프로젝트에서 UWP 프로젝트로 변경해야 할 수 있습니다. 이렇게 하려면 솔루션 탐색기에서 YourProjectName(유니버설 Windows)을 마우스 오른쪽 단추로 클릭하고 시작 프로젝트로 설정 을 선택합니다.

솔루션 탐색기에서 프로젝트 이름(Universal Windows)를 마우스 우클릭한 다음,

image

시작 프로젝트로 설정을 누르면 된다.