샘플 앱 실행: HoloLens - Unity(C#)
이 빠른 시작에서는 Unity(C#)를 사용하여 HoloLens용 Azure Spatial Anchors 샘플 앱을 실행합니다. Spatial Anchors는 시간이 지나도 위치를 유지하는 개체를 사용하여 혼합 현실 환경을 만들 수 있는 플랫폼 간 개발자 서비스입니다. 완료되면, Unity 지원 HoloLens 앱이 있어 공간 앵커를 저장하고 회수할 수 있습니다.
이 문서에서 배울 내용은 다음과 같습니다.
- Spatial Anchors 계정 만들기
- Unity 빌드 설정 준비
- Spatial Anchors 계정 식별자 및 계정 키 구성
- HoloLens Visual Studio 프로젝트 내보내기
- HoloLens 디바이스에 앱을 배포하고 실행
Azure를 구독하고 있지 않다면 시작하기 전에 Azure 체험 계정을 만듭니다.
필수 조건
이 빠른 시작을 완료하려면 다음이 필요합니다.
- 개발자 모드가 설정된 HoloLens 디바이스가 필요합니다. HoloLens 2의 경우 Windows 10 2020년 5월 업데이트 이상이 디바이스에 설치되어 있어야 합니다. HoloLens의 최신 릴리스로 업데이트하려면 설정 앱을 열고 업데이트 및 보안으로 이동한 다음, 업데이트 확인을 선택합니다.
- Visual Studio 2019 이상이 설치된 Windows 컴퓨터가 필요합니다. Visual Studio 설치에는 유니버설 Windows 플랫폼 개발 워크로드 및 Windows 10 SDK(10.0.18362.0 이상) 구성 요소가 포함되어야 합니다. Windows용 Git 및 Git LFS도 설치해야 합니다.
- Unity가 설치되어 있어야 합니다. 지원되는 버전 및 필수 기능은 Unity 프로젝트 설정 페이지를 참조하세요.
Spatial Anchors 리소스 만들기
Azure Portal로 이동합니다.
왼쪽 창에서 리소스 만들기를 선택합니다.
검색 상자를 사용하여 Spatial Anchors를 검색합니다.
Spatial Anchors를 선택한 다음, 만들기를 선택합니다.
Spatial Anchors 계정 창에서 다음을 수행합니다.
일반 영숫자 문자를 사용하여 고유한 리소스 이름을 입력합니다.
리소스를 연결할 구독을 선택합니다.
새로 만들기를 선택하여 리소스 그룹을 만듭니다. 이름을 myResourceGroup으로 지정한 다음, 확인을 선택합니다.
리소스 그룹은 웹앱, 데이터베이스, 스토리지 계정과 같은 Azure 리소스가 배포되고 관리되는 논리적 컨테이너입니다. 예를 들어 나중에 간단한 단계 하나만으로 전체 리소스 그룹을 삭제하도록 선택할 수 있습니다.
리소스를 배치할 위치(Azure 지역)를 선택합니다.
리소스 만들기를 시작하려면 만들기를 선택합니다.
리소스를 만든 후 Azure Portal은 배포가 완료되었음을 표시합니다.
리소스로 이동을 선택합니다. 이제 리소스 속성을 볼 수 있습니다.
나중에 사용하기 위해 리소스의 계정 ID 값을 텍스트 편집기에 복사합니다.
또한 리소스의 계정 도메인 값을 텍스트 편집기에 복사합니다.
설정 아래에서 액세스 키를 선택합니다. 나중에 사용하기 위해 기본 키 값, 계정 키를 텍스트 편집기에 복사합니다.
샘플 프로젝트 다운로드 및 SDK 가져오기
샘플 리포지토리 복제
다음 명령을 실행하여 샘플 리포지토리를 복제합니다.
git clone https://github.com/Azure/azure-spatial-anchors-samples.git
cd ./azure-spatial-anchors-samples
ASA SDK 가져오기
여기의 지침에 따라 HoloLens 플랫폼에 필요한 ASA SDK 패키지를 다운로드하여 가져옵니다.
Unity 구성
Unity에서 Unity 폴더의 프로젝트를 엽니다. Unity는 프로젝트의 버전과 컴퓨터에 설치된 버전이 차이가 있는지를 묻는 메시지를 표시할 수 있습니다. 이 경고는 프로젝트가 생성한 버전보다 Unity 편집기의 버전이 더 최신인 경우에는 문제가 되지 않습니다. 사용 중인 버전이 최신 버전이면 계속을 선택합니다. 사용 중인 버전이 프로젝트에 필요한 버전보다 오래된 경우 끝내기를 클릭하고 Unity 편집기를 업그레이드합니다.
파일>빌드 설정을 선택하여 빌드 설정을 엽니다.
플랫폼 섹션에서 유니버설 Windows 플랫폼을 선택합니다. 대상 디바이스를 HoloLens로 변경합니다.
플랫폼 전환을 선택하여 플랫폼을 유니버설 Windows 플랫폼으로 변경합니다. UWP 지원 구성 요소가 누락된 경우 Unity가 이러한 구성 요소를 설치하라고 요청할 수 있습니다.
빌드 설정 창을 닫습니다.
계정 정보 구성
다음 단계는 계정 정보를 사용하도록 앱을 구성하는 것입니다. 앞서 "Spatial Anchors 리소스 만들기" 섹션에서 계정 키, 계정 ID 및 계정 도메인 값을 텍스트 편집기에 복사했습니다.
프로젝트 창에서 Assets\AzureSpatialAnchors.SDK\Resources로 이동합니다.
SpatialAnchorConfig를 선택합니다. 검사기 창에서 Spatial Anchors 계정 키의 값으로 Account Key를, Spatial Anchors 계정 ID의 값으로 Account ID를, Spatial Anchors 계정 도메인의 값으로 Account Domain을 입력합니다.
HoloLens Visual Studio 프로젝트 내보내기
파일>빌드 설정을 선택하여 빌드 설정을 엽니다.
빌드 장면 아래에서 모든 장면 옆에 확인 표시가 있는지 확인합니다.
빌드를 선택합니다. 대화 상자에서 HoloLens Visual Studio 프로젝트를 내보낼 폴더를 선택합니다.
내보내기가 완료되면 내보낸 HoloLens 프로젝트가 포함된 폴더가 표시됩니다.
HoloLens 애플리케이션 배포
이 폴더의 HelloAR U3D.sln 파일을 두 번 클릭하여 Visual Studio에서 프로젝트를 엽니다.
솔루션 구성을 릴리스로 변경하고, 솔루션 플랫폼을 x86으로 변경하고, 배포 대상 옵션에서 디바이스를 선택합니다.
HoloLens 2를 사용하는 경우 x86 대신 ARM64을 솔루션 플랫폼으로 사용합니다.
HoloLens 디바이스를 켜고, 로그인하고, USB 케이블을 사용하여 디바이스를 PC에 연결합니다.
디버그>디버깅 시작을 선택하여 앱을 배포하고 디버깅을 시작합니다.
앱에서 화살표를 사용하여 BasicDemo를 선택한 다음, Go! 단추를 눌러 데모를 실행합니다. 지침에 따라 앵커를 배치하고 회수합니다.
Visual Studio에서 디버깅 중지를 선택하거나 Shift+F5 키를 눌러 앱을 중지합니다.
리소스 정리
이전 단계에서는 리소스 그룹에서 Azure 리소스를 만들었습니다. 나중에 이러한 리소스가 필요하지 않은 경우에 리소스 그룹을 삭제하여 삭제할 수 있습니다.
Azure Portal 메뉴 또는 홈 페이지에서 리소스 그룹을 선택합니다. 그런 다음, 리소스 그룹 페이지에서 myResourceGroup을 선택합니다.
myResourceGroup 페이지에서 나열된 리소스가 삭제하려는 리소스인지 확인합니다.
리소스 그룹 삭제를 선택하고, 텍스트 상자에서 myResourceGroup을 입력하여 확인한 다음, 삭제를 선택합니다.
다음 단계
이 빠른 시작에서는 Spatial Anchors 계정을 만들었습니다. 그런 다음, 공간 앵커를 저장하고 회수하도록 앱을 구성하고 배포했습니다. 다른 디바이스와 공간 앵커를 공유할 수 있도록 앱을 개선하는 방법을 자세히 알아보려면 다음 자습서를 계속 진행하세요.