빠른 시작: HoloLens에 네이티브 C++ WMR 샘플 배포

아티클
02/21/2024

이 빠른 시작에서는 HoloLens 2에서 네이티브 C++ WMR(Windows Mixed Reality) 자습서 애플리케이션을 배포하고 실행하는 방법을 다룹니다.

이 빠른 시작에서 다음을 수행하는 방법을 알아봅니다.

HoloLens용 자습서 애플리케이션을 빌드합니다.
원본 코드에서 Azure Remote Rendering 자격 증명을 변경합니다.
디바이스에서 샘플을 배포하고 실행합니다.

필수 조건

Azure Remote Rendering 서비스에 액세스하려면 먼저 계정을 만들어야 합니다.

다음 소프트웨어가 설치되어 있어야 합니다.

Windows SDK 10.0.18362.0 이상.
최신 버전의 Visual Studio 2022.
혼합 현실용 Visual Studio 도구. 특히, 다음 워크로드 설치가 필요합니다.
- C++를 사용한 데스크톱 개발
- UWP(유니버설 Windows 플랫폼) 개발
Git
Git LFS 플러그 인

Remote Rendering 샘플 리포지토리 복제

첫 번째 단계로, 전역 Azure Remote Rendering 샘플을 보관하는 Git 리포지토리를 복제합니다. Windows 시작 메뉴에서 cmd를 입력하여 명령 프롬프트 창을 엽니다. ARR 샘플 프로젝트를 저장할 디렉터리로 변경합니다.

다음 명령을 실행합니다.

mkdir ARR
cd ARR
git clone https://github.com/Azure/azure-remote-rendering

마지막 명령은 Azure Remote Rendering에 사용할 다양한 샘플 프로젝트가 들어 있는 폴더를 ARR 폴더에 만듭니다.

C++ Hololens 자습서는 NativeCpp/HoloLens-Wmr 폴더에서 찾을 수 있습니다.

프로젝트 빌드

Visual Studio를 사용하여 NativeCpp/HoloLens-Wmr 폴더에 있는 HolographicApp.sln 솔루션 파일을 엽니다.

빌드 구성을 디버그(또는 릴리스) 및 ARM64로 전환합니다. 디버거 모드가 원격 컴퓨터와는 반대로 디바이스로 설정되어 있는지 확인합니다.

Screenshot shows the Visual Studio configuration area with values as described.

계정 자격 증명은 자습서의 소스 코드에서 하드 코딩되므로 올바른 자격 증명으로 변경합니다. Visual Studio 내에서 HolographicAppMain.cpp 파일을 열고 HolographicAppMain 클래스의 생성자 내에서 클라이언트가 만들어지는 파트를 변경합니다.

// 2. Create Client
{
    // Users need to fill out the following with their account data and model
    RR::SessionConfiguration init;
    init.AccountId = "00000000-0000-0000-0000-000000000000";
    init.AccountKey = "<account key>";
    init.RemoteRenderingDomain = "westus2.mixedreality.azure.com"; // <change to the region that the rendering session should be created in>
    init.AccountDomain = "westus2.mixedreality.azure.com"; // <change to the region the account was created in>
    m_modelURI = "builtin://Engine";
    m_sessionOverride = ""; // If there is a valid session ID to re-use, put it here. Otherwise a new one is created
    m_client = RR::ApiHandle(RR::RemoteRenderingClient(init));
}

구체적으로 다음 값을 변경합니다.

계정 데이터를 사용할 init.AccountId, init.AccountKey 및 init.AccountDomain. 계정 정보 검색 방법에 대한 섹션을 참조하세요.
westus2 이외에 지역에 대한 init.RemoteRenderingDomain 문자열의 지역 부분을 수정하여 원격 렌더링 세션을 만들 위치를 지정합니다(예: "westeurope.mixedreality.azure.com").
또한 기존 세션 ID로 m_sessionOverride를 변경할 수 있습니다. 세션은 이 샘플 외부에서 만들어질 수 있습니다. 자세한 내용은 RenderingSession.ps1 또는 직접 세션 관리 REST API 사용을 참조하세요.

샘플을 여러 번 실행해야 하는 경우 샘플 외부에서 세션을 만드는 것이 좋습니다. 세션이 전달되지 않은 경우 이 샘플은 시작될 때마다 세션을 만듭니다. 세션을 만드는 데 몇 분 정도 걸릴 수 있습니다.

이제 애플리케이션을 컴파일할 수 있습니다.

응용 프로그램 시작

USB 케이블을 사용하여 HoloLens를 PC에 연결합니다.
HoloLens를 켜고 시작 메뉴가 표시될 때까지 기다립니다.
Visual Studio에서 디버거를 시작합니다(F5). 컴파일하면 앱이 자동으로 디바이스에 배포됩니다.

샘플 앱이 시작되고 현재 애플리케이션 상태를 알려 주는 텍스트 패널이 표시됩니다. 시작 시간 시 상태는 새 세션을 시작하거나 기존 세션에 연결하는 중입니다. 모델 로드를 완료한 후 기본 제공 엔진 모델이 헤드 위치에 바로 표시됩니다. 폐색, 엔진 모델은 로컬로 렌더링되는 회전 큐브와 제대로 상호 작용합니다.

나중에 샘플을 다시 시작하려는 경우 HoloLens 시작 메뉴에서도 찾을 수 있습니다. 만료된 세션 ID가 컴파일되어 있을 수 있습니다.

다음 단계

이 빠른 시작은 모든 Remote Rendering 관련 부분을 주식 Holographic 앱에 통합하는 방법을 설명하는 자습서의 결과를 기반으로 합니다. 필요한 단계를 알아보려면 다음 자습서를 따릅니다.

자습서: Hololens Holographic 앱에 Remote Rendering 통합

Share via