HoloLens 2 에뮬레이터 퀵스타트

HoloLens 2 에뮬레이터를 언리얼 엔진 4에서 환경설정하고 실행하기 위한 지침서입니다.

Choose your operating system:

Windows

macOS

Linux

필요한 사전지식

이 페이지의 콘텐츠를 이해하고 활용하기 위해 다음 주제를 숙지해 주세요.

HoloLens2Emulator.png

HoloLens 에뮬레이터는 실제 HoloLens 없이도 PC에서 홀로그램 애플리케이션을 테스트할 수 있도록 해 줍니다. 에뮬레이터는 Hyper-V 가상 머신을 사용합니다. HoloLens 센서가 일반적으로 읽어들이는 인간의 입력 및 환경적 입력은 키보드, 마우스 또는 Xbox 컨트롤러에서 시뮬레이션됩니다. 애플리케이션은 실제 HoloLens에서 실행되는 중이 아니라는 사실을 인식하지 못하므로, 애플리케이션을 에뮬레이터에서 실행하기 위해 변경할 필요는 없습니다.

1 - 시스템 요구 사항 검증

단계

  1. HoloLens 2 에뮬레이터를 실행하기 위한 전제조건 파일을 설치했는지 검증합니다. 자세한 정보는 HoloLens 2 전제조건을 참조하세요.

2 - HoloLens 2 에뮬레이터 설치

단계

  1. HoloLens 2 에뮬레이터를 다운로드 및 설치합니다. 

    HL2EmulatorInstallationLink.png

  2. 디폴트 세팅을 검토한 후 설치를 진행하세요. 단 Emulator, Emulator Image, Visual Studio Templates 은 반드시 설치해야 합니다.

    HL2EmulatorInstallation_Items.png

  3. HoloLens 2 Emulator 가 설치되면 성공 메시지가 나타날 것입니다. Close 버튼을 클릭합니다.

    hololens2eumlatorsuccess.png

에뮬레이터 설치에 실패했다면 HoloLens 2 전제조건을 다시 확인해 보세요.

3 - HoloLens 2 에뮬레이터 실행

단계

  1. Windows 키를 눌러 HoloLens 를 입력한 후 HoloLens 2 Emulator 를 선택하여 HoloLens 2 에뮬레이터를 실행합니다.

    HoloLensEmulatorInMenu.png

  2. HoloLens 2 Emulator 가 별도의 창에 로드됩니다. HoloLens2Emulator.png

  3. HoloLens 2 에뮬레이터 컨트롤을 검토합니다.

    • 앞, 뒤, 왼쪽, 오른쪽으로 걷기: 키보드의 W, A, S, D 키 또는 Xbox 컨트롤러의 왼쪽 스틱을 사용하세요.

    • 위, 아래, 왼쪽, 오른쪽 보기: 마우스를 클릭하여 드래그하거나, 키보드의 화살표 키를 사용하거나, Xbox 컨트롤러의 오른쪽 스틱을 사용하세요.

    • 에어 탭 제스처: 마우스를 우클릭하거나, 키보드의 Enter 키를 누르거나, Xbox 컨트롤러의 A 버튼을 사용하세요.

    • 블룸/시스템 제스처: 키보드의 Windows 키 또는 F2 키를 누르거나, Xbox 컨트롤러의 B 버튼을 누르세요.

    • 핸드 이동으로 스크롤하기: Alt 키와 오른쪽 마우스 버튼을 동시에 누른 상태로 마우스를 위 또는 아래로 드래그하거나, Xbox 컨트롤러에서 오른쪽 트리거와 A 버튼을 누른 상태로 오른쪽 스틱을 위아래로 움직입니다.

    • 핸드 이동 및 오리엔테이션: Alt 키를 누른 상태로 마우스를 위/아래, 왼쪽/오른쪽으로 드래그하여 핸드를 이동하거나, 화살표 키와 Q 또는 E를 사용해 핸드를 회전하거나 기울입니다. Xbox 컨트롤러의 경우, 왼쪽 또는 오른쪽 범퍼를 누른 상태로 왼쪽 스틱을 사용하여 핸드를 왼쪽, 오른쪽, 앞, 뒤로 이동할 수 있습니다. 오른쪽 스틱으로는 핸드를 회전하거나, Dpad에서 위 또는 아래로 움직여 핸드를 들거나 내릴 수 있습니다.

4 - HoloLens 2 에뮬레이터용 패키지 설치

이미 HoloLens 2 에뮬레이터용으로 빌드되어 사용 가능한 앱이 없다면, HoloLens 2용 언리얼 프로젝트 패키징에서 HoloLens 2용 에뮬레이터 패키징에 대한 자세한 정보를 확인해 보세요. 

다음의 단계에서는 *.appxbundle 파일 및 *.appx 파일, 총 2개의 파일을 로드하게 됩니다. *.appxbundle 파일은 게임 패키지입니다. *.appx 파일은 타깃 아키텍처(arm64 또는 x64)용 지원 파일이 포함된 종속성 패키지입니다. 종속성 패키지는 디바이스당 한 번만 설치하면 됩니다. 이미 종속성 파일을 설치한 경우, 옵션 패키지를 선택하지 않고 설치를 계속 진행하면 됩니다. 디바이스를 리플래시(reflash)한 경우 모든 종속성 패키지를 포함하여 디바이스에 디플로이된 모든 내용이 소실됩니다.  

  1. 오른쪽 메뉴에서 HoloLens 2 에뮬레이터용으로 Device Portal 을 엽니다.

    DevicePortalButton.png

  2. Windows Device Portal 이 브라우저 창에서 열립니다.

    DevicePortal.png

  3. Windows Device Portal 의 툴바에서 Views > Apps 를 선택합니다.

    DeployApps2.png

  4. Choose File 버튼을 클릭하고 \Unreal Projects\TestProject\Hololens 와 같은 프로젝트 위치로 이동합니다.

    ChooseFileButton.png

    BrowseToAppxPackage.png

  5. .appxbundle 파일을 선택하여 설치하고자 하는 패키지를 지정합니다.

    ChooseAppxBundle.png

  6. Allow me to select optional packages 옵션을 선택한 후 Next 를 선택합니다.

    *.appx 파일은 종속성 패키지로, 디바이스당 한 번만 설치하면 됩니다. 이미 종속성 파일을 설치한 경우, 옵션 패키지를 선택하지 않고 설치를 계속 진행하면 됩니다.

    CheckSelectOptionalPackages.png

  7. Choose File 버튼을 선택하고 \Unreal Projects\TestProject\Hololens 와 같은 프로젝트 위치로 이동합니다.

    ChooseOptionalPackage_ChooseFileButton.png

    BrowseToOptionalPackage.png

  8. 타깃 플랫폼(에뮬레이터용: x64, 디바이스용: arm64)에 대해 *.appx 파일을 선택한 후 Next 를 클릭합니다.

    ChooseAppx.png

  9. Install 버튼을 클릭합니다.

    InstallPackages_Emulator.png

  10. 앱 설치가 완료될 때까지 기다립니다.

    InstallationProgress.png Success_PackageRegistered.png

  11. 앱 설치가 완료되면 에뮬레이터의 All Apps 에서 스크롤하여 앱을 찾습니다.

    AllApps.png AppOnDevice.png

5 - 직접 해보기

이제 HoloLens 2 에뮬레이터에 여러분의 앱을 설치했으니, 앱을 실행하여 언리얼 프로젝트를 로드해 보세요.