빠른 시작: Unity에서 Azure Object Anchors를 사용하여 HoloLens 앱 만들기
이 빠른 시작에서는 Azure Object Anchors를 사용하는 Unity HoloLens 앱을 만듭니다. Azure Object Anchors는 3D 자산을 HoloLens에 대한 개체 인식 혼합 현실 환경을 지원하는 AI 모델로 변환하는 관리형 클라우드 서비스입니다. 완료하면 실제 세계에서 개체를 검색할 수 있는 Unity로 빌드된 HoloLens 앱이 생성됩니다.
이 문서에서 배울 내용은 다음과 같습니다.
- Unity 빌드 설정 준비
- HoloLens Visual Studio 프로젝트 내보내기
- HoloLens 2 디바이스에 앱을 배포하고 실행
필수 조건
이 빠른 시작을 완료하려면 다음 항목이 있어야 합니다.
- 사용자 환경 및 해당 3D 모델(CAD 또는 스캔)의 물리적 개체
- 다음이 설치된 Windows 머신:
- Windows용 GIT
- 유니버설 Windows 플랫폼 개발 워크로드 및 Windows 10 SDK(10.0.18362.0 이상) 구성 요소가 포함된 Visual Studio 2019
- Unity 2019.4
- 최신 상태이고 개발자 모드가 사용하도록 설정된 HoloLens 2 디바이스.
- HoloLens의 최신 릴리스로 업데이트하려면 설정 앱을 열고 업데이트 및 보안으로 이동한 다음, 업데이트 확인을 선택합니다.
Object Anchors 계정 만들기
먼저 Object Anchors 서비스를 사용하여 계정을 만들어야 합니다.
Azure Portal로 이동하여 리소스 만들기를 선택합니다.
Object Anchors 리소스를 검색합니다.
"Object Anchors"를 검색합니다.
검색 결과의 Object Anchors 리소스에서 만들기 -> Object Anchors를 선택합니다.
Object Anchors 계정 대화 상자에서:
- 고유한 리소스 이름을 입력합니다.
- 리소스를 연결할 구독을 선택합니다.
- 기존 리소스 그룹을 만들거나 사용합니다.
- 리소스를 배치할 지역을 선택합니다.
리소스 만들기를 시작하려면 만들기를 선택합니다.
리소스를 만들었으면 리소스로 이동을 선택합니다.
개요 페이지에서:
계정 도메인을 기록해 둡니다. 나중에 필요합니다.
계정 ID를 기록해 둡니다. 나중에 필요합니다.
액세스 키 페이지로 이동하여 기본 키를 기록해 둡니다. 나중에 필요합니다.
장치 설정
HoloLens에 앱을 배포하려면 HoloLens를 컴퓨터와 페어링해야 합니다.
- HoloLens에서 설정 -> 업데이트 및 보안 -> 개발자용으로 이동합니다.
- 쌍을 클릭하고 첫 번째 배포 중에 Visual Studio에 PIN을 입력할 때까지 화면을 열어둡니다.
모델 업로드
앱을 실행하기 전에 앱에서 모델을 사용할 수 있어야 합니다. Object Anchors 모델이 아직 없는 경우 모델 만들기의 지침에 따라 모델을 만듭니다. 그런 다음, 여기로 돌아옵니다.
HoloLens의 전원이 켜져 있고 개발 디바이스(PC)에 연결된 상태에서 다음 단계에 따라 HoloLens의 3D Objects 폴더에 모델을 업로드합니다.
Ctrl 키와 C(Ctrl + C)를 함께 눌러 작업할 모델을 선택하고 복사합니다.
Windows 로고 키와 E(Win + E)를 함께 눌러 파일 탐색기를 시작합니다. 왼쪽 창에 다른 드라이브 및 폴더와 함께 나열된 HoloLens가 표시되어야 합니다.
HoloLens 링크를 탭하여 오른쪽 창에 HoloLens 디바이스의 스토리지를 표시합니다.
파일 탐색기에서 내부 스토리지> 3D 개체로 이동합니다. 이제 Ctrl 키와 V(Ctrl + V)를 함께 눌러 3D Objects 폴더에 모델을 붙여넣을 수 있습니다.
샘플 프로젝트 열기
다음 명령을 실행하여 샘플 리포지토리를 복제합니다.
git clone https://github.com/Azure/azure-object-anchors.git
cd ./azure-object-anchors
다음은 Unity용 Azure Object Anchors 패키지를 다운로드하는 단계입니다.
여기에서 Unity용 Azure Object Anchors 패키지(com.microsoft.azure.object-anchors.runtime)를 찾습니다. 원하는 버전을 선택하고 다운로드 단추를 사용하여 패키지를 다운로드합니다.
Unity에서 quickstarts/apps/unity/basic 프로젝트를 엽니다.
Unity 패키지 관리자를 사용하여 Unity 프로젝트로 다운로드한 Azure Object Anchors 패키지를 가져오려면 여기 지침을 따르세요.
계정 정보 구성
다음 단계는 계정 정보를 사용하도록 앱을 구성하는 것입니다. "Object Anchors 계정 만들기" 섹션에서 계정 키, 계정 ID 및 계정 도메인 값을 기록해 두었습니다.
프로젝트 창에서 Assets\AzureObjectAnchors.SDK\Resources로 이동합니다.
ObjectAnchorsConfig를 선택합니다. 검사기 창에서 Object Anchors 계정 키의 값으로 Account Key를, Object Anchors 계정 ID의 값으로 Account ID를, Object Anchors 계정 도메인의 값으로 Account Domain을 입력합니다.
앱 빌드 및 실행
샘플 장면 빌드
Unity 편집기에서 Assets/MixedReality.AzureObjectAnchors/Scenes로 이동하고, AOASampleScene을 열고, 장면 빌드 목록에 추가합니다.
파일 -> 설정 빌딩을 선택합니다. 유니버설 Windows 플랫폼을 선택한 다음, 플랫폼 전환을 선택합니다. Unity 편집기에서 일부 구성 요소를 먼저 다운로드해야 한다고 표시되면 해당 구성 요소를 다운로드하여 설치합니다. 아래 스크린샷에 따라 빌드 설정을 구성합니다. AOASampleScene 옆에만 확인 표시가 있어야 합니다. 다른 장면은 포함하면 안 됩니다.
빌드를 선택하고 출력 폴더를 선택합니다. 이제 출력 폴더에 VS 프로젝트를 생성할 수 있습니다.
앱 빌드 및 배포
Unity에서 생성한 .sln 파일을 엽니다. 빌드 구성을 다음과 같이 변경합니다.
다음으로, 앱을 배포하고 디버그하기 위해 원격 컴퓨터 IP 주소를 구성해야 합니다.
앱 프로젝트를 마우스 오른쪽 단추로 클릭하고 속성을 선택합니다. 속성 페이지에서 구성 속성 -> 디버깅을 선택합니다. 컴퓨터 이름 값을 HoloLens 디바이스의 IP 주소로 변경하고 적용을 클릭합니다.
속성 페이지를 닫습니다. 원격 컴퓨터를 클릭합니다. 앱이 빌드되고 원격 디바이스에 배포되기 시작합니다. 디바이스가 활성 상태인지 확인합니다.
Unity 시작 화면 다음에는 Object Observer가 초기화되었음을 나타내는 메시지가 표시됩니다.
앱은 보기의 현재 필드에서 개체를 찾은 다음 검색된 후 추적합니다. 인스턴스는 사용자의 위치에서 6미터 떨어진 경우 제거됩니다. 디버그 텍스트는 ID, 업데이트된 타임스탬프 및 표면 적용 비율과 같은 인스턴스에 대한 세부 정보를 보여 줍니다.
문제 해결
팁
개체가 검색되지 않으면 다음 단계를 시도할 수 있습니다.
- 개체에 올바른 모델을 사용하고 있는지 다시 확인합니다.
- 검색 영역을 시각화하고 대상 개체를 포함하는지 확인합니다.
MinSurfaceCoverage를 줄여 보세요.- Windows Device Portal에서 보기 -> 3D 보기를 클릭하고 검사가 완료되었는지 확인합니다.