6. 패키징 후 디바이스 또는 에뮬레이터에 배포6. Packaging & deploying to device or emulator

개요Overview

이전 자습서에서는 체스 말을 원래 위치로 다시 설정하는 간단한 단추를 추가했습니다.In the previous tutorial, you added a simple button that resets the chess piece to its original position. 이 마지막 섹션에서는 HoloLens 2 또는 에뮬레이터에서 앱을 실행할 수 있게 준비합니다.In this final section, you'll get the app ready to run on a HoloLens 2 or an Emulator. HoloLens 2가 있는 경우 컴퓨터에서 스트리밍하거나 앱을 패키징하여 디바이스에서 직접 실행할 수 있습니다.If you have a HoloLens 2, you can either stream from your computer or package the app to run directly on the device. 디바이스가 없는 경우 에뮬레이터에서 실행되도록 앱을 패키징합니다.If you don't have a device, you'll be packaging the app to run on the Emulator. 이 섹션을 마치면 재생할 수 있는 혼합 현실 앱이 배포되며 조작과 UI가 완성됩니다.By the end of this section, you'll have a deployed mixed reality app that you can play, complete with interactions and UI.

목표Objectives

  • [디바이스 전용] 홀로그램 앱 원격 기능을 통해 HoloLens 2에 스트리밍[Device only] Streaming to HoloLens 2 with holographic app remoting
  • HoloLens 2 디바이스 또는 에뮬레이터에 앱 패키징 및 배포Packaging and deploying the app to a HoloLens 2 device or emulator

[디바이스 전용] 스트리밍[Device Only] Streaming

이 경우 홀로그램 원격 기능은 채널을 전환하는 것이 아니라 PC나 독립 실행형 UWP 디바이스에서 HoloLens 2로 데이터를 스트리밍합니다.Holographic Remoting in this case means streaming data from a PC or standalone UWP device to the HoloLens 2, not switching the channel. 이 작업에서는 원격 호스트 앱이 HoloLens로부터 입력 데이터 스트림을 받고 가상 몰입형 보기에서 콘텐츠를 렌더링하며 다시 Wi-Fi를 통해 콘텐츠 프레임을 HoloLens로 돌려 보냅니다.The way this works is a remoting host app receives an input data stream from a HoloLens, renders content in a virtual immersive view, and streams content frames back to HoloLens over Wi-Fi. 스트리밍에서는 사용자가 원격 몰입형 보기를 기존 데스크톱 PC 소프트웨어에 추가할 수 있고 다른 시스템 리소스에 액세스할 수 있습니다.Streaming allows you to add remote immersive views into existing desktop PC software and has access to more system resources.

체스 앱에 이 경로를 적용하려면 다음 몇 가지가 필요합니다.If you're going this route with the chess app, you'll need a few things:

  1. Microsoft Store에서 HoloLens 2에 Holographic Remoting Player를 설치하고 앱을 실행합니다.Install the Holographic Remoting Player from the Microsoft Store on your HoloLens 2 and run the app. 앱에 표시되는 IP 주소를 확인합니다.Note your IP address displayed in the app.

  2. Unreal 편집기로 돌아가서 편집 > 프로젝트 설정으로 이동하고 홀로그램 원격 섹션에서 원격 사용을 선택합니다.Back in the Unreal editor, go to Edit > Project Settings and check Enable Remoting in the Holographic Remoting section.

  3. 편집기를 다시 시작한 다음, 디바이스 IP 주소(Holographic Remoting Player 앱에 표시됨)를 입력한 다음, 연결을 클릭합니다.Restart the editor, then enter your device's IP address (as displayed in the Holographic Remoting Player app), then click Connect.

연결되면 재생 단추 오른쪽의 드롭다운 화살표를 클릭하여 VR 미리 보기를 선택합니다.Once you’re connected, click the drop-down arrow to the right of the Play button and select VR Preview. 그러면 HoloLens 헤드셋으로 스트리밍되는 VR 미리 보기 창에 앱이 실행됩니다.This will run the app in the VR Preview window, which is streamed to the HoloLens headset.

디바이스 포털을 통해 앱 패키징 및 배포Packaging and deploying the app via device portal

참고

HoloLens용 Unreal 앱을 처음으로 패키징하는 경우 Epic Launcher에서 지원 파일을 다운로드해야 합니다.If this is your first time packaging an Unreal app for HoloLens, you'll need to download supporting files from the Epic Launcher.

  • 편집기 기본 설정 > 일반 > 소스 코드 > 소스 코드 편집기로 이동하여 Visual Studio 2019가 선택되어 있는지 확인합니다.Go to Editor Preferences > General > Source Code > Source Code Editor and check that Visual Studio 2019 is selected.
  • Epic Games 시작 관리자에서 라이브러리 탭으로 이동한 다음, 시작 옆의 드롭다운 화살표를 선택하고 옵션을 클릭합니다.Go to the Library tab in the Epic Games Launcher, select the dropdown arrow next to Launch >and click Options.
  • 대상 플랫폼에서 HoloLens 2를 선택하고 적용을 클릭합니다.Under Target Platforms, select HoloLens 2 and click Apply. 프로젝트 설정에서 대상 플랫폼 변경Change target platform in project settings
  1. 편집 > 프로젝트 설정으로 이동합니다.Go to Edit > Project Settings.
    • 프로젝트 > 설명 > 정보 > 프로젝트 이름에서 프로젝트 이름을 추가합니다.Add a project name under Project > Description > About > Project Name.
    • 프로젝트 > 설명 > 게시자 > 회사 고유 이름 아래에서 CN=YourCompanyName을 추가합니다.Add CN=YourCompanyName under Project > Description > Publisher > Company Distinguished Name.

중요

이러한 필드 중 하나를 비워 두면 3단계에서 새 인증서를 생성하려고 할 때 오류가 발생합니다.Leaving either of these fields blank will result in an error when you try and generate a new certificate in step 3.

중요

게시자의 이름은 LADPv3 고유 이름 형식이어야 합니다.The publisher's name must be in LADPv3 Distinguished Names Format. 패키지할 때 잘못된 형식의 게시자 이름으로 인해 "서명 키를 찾을 수 없습니다.A malformed publisher's name leads to the "Signing key not found. 앱에 디지털 서명할 수 없습니다."라는The app could not be digitally signed." 오류가 발생합니다.error upon packaging.

프로젝트 설정 - 설명

  1. 플랫폼 > HoloLens에서 HoloLens 에뮬레이션에 대해 빌드 및/또는 HoloLens 디바이스에 대해 빌드를 사용하도록 설정합니다.Enable Build for HoloLens Emulation and/or Build for HoloLens Device under Platforms > HoloLens.

  2. 서명 인증서 옆의 패키징 섹션에서 새로 생성을 클릭합니다.Click Generate new in the Packaging section (next to Signing Certificate).

중요

이미 생성된 인증서를 사용하는 경우 인증서의 게시자 이름은 애플리케이션의 게시자 이름과 동일해야 합니다.If you're using an already generated certificate, then the certificate's publisher name must be the same as the application's publisher name. 그렇지 않으면 "서명 키를 찾을 수 없습니다.Otherwise it leads to the "Signing key not found. 앱에 디지털 서명할 수 없습니다."라는The app could not be digitally signed." 오류로 인해 path\filename 파일을 삭제하지 못했습니다.error.

프로젝트 설정 - 플랫폼 - HoloLens

  1. 프라이빗 키 암호를 만들라는 메시지가 표시되면 테스트 목적으로 없음을 클릭합니다.Click None for testing purposes when you're prompted to create a Private Key Password.

새 인증서 생성

  1. 파일 > 패키지 프로젝트으로 이동하여 HoloLens를 선택합니다.Go to File > Package Project and select HoloLens.

    • 새 폴더를 만들어 패키지를 저장하고 폴더 선택을 선택합니다.Create a new folder to save your package in and click Select Folder.
  2. 앱 패키징 후 Windows 장치 포털을 열고 보기 > 앱으로 이동한 다음, 앱 배포 섹션을 찾습니다.Open the Windows Device Portal once the app is packaged, go to Views > Apps and find the Deploy apps section.

  3. 찾아보기... 를 클릭하고 ChessApp.appxbundle 파일로 이동한 다음, 열기를 클릭합니다.Click Browse..., go to your ChessApp.appxbundle file and click Open.

    • 디바이스에 앱을 처음 설치하는 경우 프레임워크 패키지를 선택하도록 허용 옆의 확인란을 선택합니다.Check the box next to Allow me to select framework packages if this is the first time you're installing the app on your device.
    • 다음 대화 상자에서 적절한 VCLibsappx 파일을 포함합니다(디바이스에는 arm64, 에뮬레이터에는 x64).In the next dialogue, include the appropriate VCLibs and appx files (arm64 for device, x64 for emulator). 이 항목은 패키지를 저장한 폴더 안의 HoloLens 아래에 있습니다.You can find these under HoloLens inside the folder where you saved your package.
  4. 설치를 클릭합니다.Click Install

    • 이제 모든 앱으로 이동하고 새로 설치된 앱을 탭하여 실행하거나 Windows Device Portal에서 직접 앱을 시작할 수 있습니다.You can now go to All Apps and tap the newly installed app to run it, or you can start the app directly from the Windows Device Portal.

축하합니다!Congratulations! HoloLens 혼합 현실 애플리케이션이 완료되어 진행할 준비가 되었습니다.Your HoloLens mixed reality application is finished and ready to go. 그러나 모두 끝난 것은 아닙니다.However, this isn't the end of the road. MRTK에는 공간 매핑, 응시, 음성 입력을 비롯하여 QR 코드에 이르기까지, 프로젝트에 추가할 수 있는 무수한 독립 실행형 기능이 있습니다.MRTK has lots of standalone features that you can add to your projects, including spatial mapping, gaze and voice input, and even QR codes. 이러한 기능에 대한 자세한 내용은 Unreal 개발 개요에서 확인할 수 있습니다.More information on these features can be found in the Unreal development overview.

다음 개발 검사점Next Development Checkpoint

앞에서 설명한 Unreal 개발 검사점 경험을 수행하는 경우 MRTK 핵심 구성 요소를 탐색하는 것이 좋습니다.If you're following the Unreal development checkpoint journey we've laid out, you're in the midst of exploring the MRTK core building blocks. 여기에서 다음 구성 요소로 진행할 수 있습니다.From here, you can proceed to the next building block:

또는 Mixed Reality 플랫폼 기능 및 API로 이동합니다.Or jump to Mixed Reality platform capabilities and APIs:

언제든지 Unreal 개발 검사점으로 돌아갈 수 있습니다.You can always go back to the Unreal development checkpoints at any time.