HoloLens(1세대) 및 Azure 305: 함수 및 스토리지
참고 항목
Mixed Reality 아카데미 자습서는 HoloLens(1세대) 및 Mixed Reality 몰입형 헤드셋을 염두에 두고 설계되었습니다. 따라서 이러한 디바이스 개발에 대한 지침을 계속 찾고 있는 개발자를 위해 이러한 자습서를 그대로 두는 것이 중요합니다. 이러한 자습서는 HoloLens 2에 사용되는 최신 도구 집합 또는 상호 작용으로 업데이트되지 않습니다. 대신 지원되는 디바이스에서 계속 작동하도록 유지 관리됩니다. HoloLens 2용으로 개발하는 방법을 보여 주는 새로운 자습서 시리즈가 향후 게시될 예정입니다. 이 알림은 해당 자습서가 게시될 때 해당 자습서에 대한 링크로 업데이트됩니다.
이 과정에서는 혼합 현실 애플리케이션 내에서 Azure Functions를 만들고 사용하고 Azure Storage 리소스를 사용하여 데이터를 저장하는 방법을 알아봅니다.
Azure Functions 는 개발자가 Azure에서 작은 코드 'functions'를 실행할 수 있도록 하는 Microsoft 서비스입니다. 이렇게 하면 로컬 애플리케이션이 아닌 클라우드에 작업을 위임할 수 있으므로 많은 이점이 있을 수 있습니다. Azure Functions는 C#, F#, Node.js, Java 및 PHP를 비롯한 여러 개발 언어를 지원합니다. 자세한 내용은 Azure Functions 문서를 참조 하세요.
Azure Storage 는 개발자가 고가용성, 보안성, 내구성, 확장성 및 중복성을 보장하는 보험으로 데이터를 저장할 수 있는 Microsoft 클라우드 서비스입니다. 즉, Microsoft는 모든 유지 관리 및 중요한 문제를 처리합니다. 자세한 내용은 Azure Storage 문서를 참조 하세요.
이 과정을 완료하면 다음을 수행할 수 있는 혼합 현실 몰입형 헤드셋 애플리케이션이 있습니다.
- 사용자가 장면을 응시할 수 있도록 허용합니다.
- 사용자가 3D '단추'를 응시할 때 개체의 생성을 트리거합니다.
- 생성된 개체는 Azure Function에 의해 선택됩니다.
- 각 개체가 생성되면 애플리케이션은 Azure Storage에 있는 Azure File에 개체 형식을 저장합니다.
- 두 번째로 로드하면 Azure 파일 데이터가 검색되고 애플리케이션의 이전 인스턴스에서 생성 작업을 재생하는 데 사용됩니다.
애플리케이션에서 결과를 디자인과 통합하는 방법은 사용자에게 달려 있습니다. 이 과정은 Unity 프로젝트와 Azure 서비스를 통합하는 방법을 교육하기 위해 고안되었습니다. 혼합 현실 애플리케이션을 향상시키기 위해이 과정에서 얻은 지식을 사용하는 것이 당신의 일입니다.
디바이스 지원
| 과정 | HoloLens | 몰입형 헤드셋 |
|---|---|---|
| MR 및 Azure 305: 함수 및 스토리지 | ✔️ | ✔️ |
참고 항목
이 과정은 주로 Windows Mixed Reality 몰입형(VR) 헤드셋에 중점을 두고 있지만 이 과정에서 배운 내용을 Microsoft HoloLens에 적용할 수도 있습니다. 과정을 따라가면 HoloLens를 지원하기 위해 사용해야 할 수 있는 변경 내용에 대한 메모가 표시됩니다.
필수 조건
참고 항목
이 자습서는 Unity 및 C#에 대한 기본 경험이 있는 개발자를 위해 설계되었습니다. 또한 이 문서의 필수 구성 요소와 서면 지침은 작성 당시 테스트 및 확인된 내용을 나타냅니다(2018년 5월). 이 과정의 정보가 아래에 나열된 것보다 최신 소프트웨어에서 찾을 수 있는 것과 완벽하게 일치한다고 가정해서는 안 되지만, 설치 도구 문서에 나열된 대로 최신 소프트웨어를 자유롭게 사용할 수 있습니다.
이 과정에는 다음 하드웨어 및 소프트웨어를 사용하는 것이 좋습니다.
- 몰입형(VR) 헤드셋 개발을 위해 Windows Mixed Reality와 호환되는 개발 PC
- 개발자 모드를 사용하도록 설정된 Windows 10 Fall Creators Update(이상)
- 최신 Windows 10 SDK
- Unity 2017.4
- Visual Studio 2017
- 개발자 모드가 설정된 Windows Mixed Reality 몰입형(VR) 헤드셋 또는 Microsoft HoloLens
- Azure 리소스를 만들기 위한 Azure 계정에 대한 구독
- Azure 설정 및 데이터 검색을 위한 인터넷 액세스
시작하기 전에
이 프로젝트를 빌드하는 데 문제가 발생하지 않도록 이 자습서에서 언급한 프로젝트를 루트 또는 루트에 가까운 폴더에 만드는 것이 좋습니다(긴 폴더 경로는 빌드 시 문제를 일으킬 수 있음).
1장 - Azure Portal
Azure Storage 서비스를 사용하려면 Azure Portal에서 Storage 계정을 만들고 구성해야 합니다.
Azure Portal에 로그인합니다.
참고 항목
Azure 계정이 아직 없는 경우 계정을 만들어야 합니다. 교실 또는 랩 상황에서 이 자습서를 따르는 경우 강사 또는 프록터 중 한 명에게 새 계정 설정에 대한 도움을 요청하세요.
로그인한 후 왼쪽 위 모서리에서 새로 만들기를 클릭하고 Storage 계정을 검색한 다음 Enter 키를 클릭합니다.
참고 항목
새 단어는 최신 포털에서 리소스 만들기로 대체되었을 수 있습니다.
새 페이지에서는 Azure Storage 계정 서비스에 대한 설명을 제공합니다. 이 프롬프트의 왼쪽 아래에서 만들기 단추를 선택하여 이 서비스와의 연결을 만듭니다.
만들기를 클릭한 후에는 다음을 수행합니다.
계정의 이름을 삽입합니다. 이 필드는 숫자와 소문자만 허용합니다.
배포 모델의 경우 Resource Manager를 선택합니다.
계정 종류에 대해 스토리지(범용 v1)를 선택합니다.
리소스 그룹의 위치를 결정합니다(새 리소스 그룹을 만드는 경우). 위치는 애플리케이션이 실행되는 지역에 있는 것이 이상적입니다. 일부 Azure 자산은 특정 지역에서만 사용할 수 있습니다.
복제의 경우 RA-GRS(읽기 액세스 지역 중복 스토리지)를 선택합니다.
성능은 표준을 선택합니다.
보안 전송은 사용 안 함으로 유지합니다.
구독을 선택합니다.
리소스 그룹을 선택하거나 새 리소스 그룹을 만듭니다. 리소스 그룹은 Azure 자산 컬렉션에 대한 청구를 모니터링, 제어, 프로비전 및 관리하는 방법을 제공합니다. 단일 프로젝트(예: 이러한 랩)와 연결된 모든 Azure 서비스를 공통 리소스 그룹 아래에 유지하는 것이 좋습니다.
Azure 리소스 그룹에 대해 자세히 알아보려면 리소스 그룹 문서를 방문하세요.
또한 이 서비스에 적용된 사용 약관을 이해했음을 확인해야 합니다.
만들기를 실행합니다.
만들기를 클릭하면 서비스가 생성될 때까지 기다려야 합니다. 이 작업은 1분 정도 걸릴 수 있습니다.
서비스 인스턴스가 만들어지면 포털에 알림이 표시됩니다.
알림을 클릭하여 새 서비스 인스턴스를 탐색합니다.
알림에서 리소스 로 이동 단추를 클릭하여 새 서비스 인스턴스를 탐색합니다. 새 Storage 계정 서비스 인스턴스로 이동합니다.
액세스 키를 클릭하여 이 클라우드 서비스의 엔드포인트를 표시합니다. 메모장 또는 이와 유사한 키를 사용하여 나중에 사용할 키 중 하나를 복사합니다. 또한 나중에 만들 AzureServices 클래스에서 사용되므로 연결 문자열 값을 기록해 둡니다.
2장 - Azure 함수 설정
이제 Azure 서비스에서 Azure Function을 작성합니다.
Azure Function을 사용하여 코드의 클래식 함수로 수행할 수 있는 거의 모든 작업을 수행할 수 있습니다. 차이점은 Azure 계정에 액세스하기 위한 자격 증명이 있는 모든 애플리케이션에서 이 함수에 액세스할 수 있다는 점입니다.
Azure Function을 만들려면 다음을 수행합니다.
Azure Portal에서 왼쪽 위 모서리에 있는 새로 만들기를 클릭하고 함수 앱을 검색한 다음 Enter 키를 클릭합니다.
참고 항목
새 단어는 최신 포털에서 리소스 만들기로 대체되었을 수 있습니다.
새 페이지에서는 Azure Function App Service에 대한 설명을 제공합니다. 이 프롬프트의 왼쪽 아래에서 만들기 단추를 선택하여 이 서비스와의 연결을 만듭니다.
만들기를 클릭한 후에는 다음을 수행합니다.
앱 이름을 제공합니다. 여기서는 문자와 숫자만 사용할 수 있습니다(대문자 또는 소문자 허용).
선호하는 구독을 선택합니다.
리소스 그룹을 선택하거나 새 리소스 그룹을 만듭니다. 리소스 그룹은 Azure 자산 컬렉션에 대한 청구를 모니터링, 제어, 프로비전 및 관리하는 방법을 제공합니다. 단일 프로젝트(예: 이러한 랩)와 연결된 모든 Azure 서비스를 공통 리소스 그룹 아래에 유지하는 것이 좋습니다.
Azure 리소스 그룹에 대해 자세히 알아보려면 리소스 그룹 문서를 방문하세요.
이 연습에서는 선택한 OS로 Windows를 선택합니다.
호스팅 계획에 대한 사용 계획을 선택합니다.
리소스 그룹의 위치를 결정합니다(새 리소스 그룹을 만드는 경우). 위치는 애플리케이션이 실행되는 지역에 있는 것이 이상적입니다. 일부 Azure 자산은 특정 지역에서만 사용할 수 있습니다. 최적의 성능을 위해 스토리지 계정과 동일한 지역을 선택합니다.
스토리지의 경우 기존 스토리지 사용을 선택한 다음 드롭다운 메뉴를 사용하여 이전에 만든 스토리지를 찾습니다.
이 연습에서는 Application Insights를 해제합니다.
만들기 버튼을 클릭합니다.
만들기를 클릭하면 서비스가 생성될 때까지 기다려야 합니다. 이 작업은 1분 정도 걸릴 수 있습니다.
서비스 인스턴스가 만들어지면 포털에 알림이 표시됩니다.
알림을 클릭하여 새 서비스 인스턴스를 탐색합니다.
알림에서 리소스 로 이동 단추를 클릭하여 새 서비스 인스턴스를 탐색합니다. 새 Function App Service 인스턴스로 이동합니다.
함수 앱 대시보드에서 마우스를 왼쪽 패널에 있는 Functions 위로 마우스로 가리킨 다음 + (더하기) 기호를 클릭합니다.
다음 페이지에서 웹후크 + API가 선택되어 있는지 확인하고 언어 선택 시 이 자습서에 사용되는 언어이므로 CSharp를 선택합니다. 마지막으로 이 함수 만들기 단추를 클릭합니다.
코드 페이지(run.csx)로 이동해야 하지만 그렇지 않은 경우 왼쪽 패널 내의 함수 목록에서 새로 만든 함수를 클릭합니다.
다음 코드를 함수에 복사합니다. 이 함수는 호출될 때 0에서 2 사이의 임의 정수를 반환합니다. 기존 코드에 대해 걱정하지 마세요. 위에 자유롭게 붙여넣을 수 있습니다.
using System.Net; using System.Threading.Tasks; public static int Run(CustomObject req, TraceWriter log) { Random rnd = new Random(); int randomInt = rnd.Next(0, 3); return randomInt; } public class CustomObject { public String name {get; set;} }저장을 선택합니다.
결과는 아래 이미지와 같아야 합니다.
함수 URL 가져오기를 클릭하고 표시된 엔드포인트를 기록해 둡다. 이 과정 뒷부분 에서 만들 AzureServices 클래스에 삽입해야 합니다.
3장 - Unity 프로젝트 설정
다음은 Mixed Reality를 사용하여 개발하기 위한 일반적인 설정이며, 따라서 다른 프로젝트에 적합한 템플릿입니다.
혼합 현실 몰입형 헤드셋을 설정하고 테스트합니다.
참고 항목
이 과정에는 모션 컨트롤러가 필요하지 않습니다. 몰입형 헤드셋 설정을 지원해야 하는 경우 혼합 현실 설정 문서를 방문하세요.
Unity를 열고 새로 만들기를 클릭합니다.
이제 Unity 프로젝트 이름을 제공해야 합니다. MR_Azure_Functions 삽입합니다. 프로젝트 형식이 3D로 설정되어 있는지 확인합니다. 위치를 적절한 위치로 설정합니다(루트 디렉터리에 더 가깝습니다.). 그런 다음 프로젝트 만들기를 클릭합니다.
Unity가 열려 있으면 기본 스크립트 편집 기가 Visual Studio로 설정되어 있는지 확인할 필요가 있습니다. 기본 설정 편집>으로 이동한 다음 새 창에서 외부 도구로 이동합니다. 외부 스크립트 편집기를 Visual Studio 2017로 변경합니다. 기본 설정 창을 닫습니다.
다음으로 파일 빌드 설정으로> 이동하여 플랫폼 전환 단추를 클릭하여 플랫폼을 유니버설 Windows 플랫폼 전환합니다.
파일>빌드 설정으로 이동하여 다음을 확인합니다.
대상 디바이스가 모든 디바이스로 설정됩니다.
Microsoft HoloLens의 경우 대상 디바이스를 HoloLens로 설정합니다.
빌드 유형 이 D3D로 설정됨
SDK 가 최신 설치됨으로 설정됨
Visual Studio 버전 이 설치된 최신 버전으로 설정됨
빌드 및 실행 이 로컬 컴퓨터로 설정됩니다.
장면을 저장하고 빌드에 추가합니다.
열린 장면 추가를 선택하여 이 작업을 수행합니다. 저장 창이 나타납니다.
이에 대한 새 폴더 및 이후의 장면, 새 폴더 단추를 선택하여 새 폴더를 만들고 이름을 Scenes로 지정합니다.
새로 만든 Scenes 폴더를 열고 파일 이름: 텍스트 필드에 FunctionsScene을 입력한 다음 저장을 누릅니다.
빌드 설정의 나머지 설정은 현재 기본값으로 남아 있어야 합니다.
빌드 설정 창에서 플레이어 설정 단추를 클릭하면 Inspector가 있는 공간에서 관련 패널이 열립니다.
이 패널에서 몇 가지 설정을 확인해야 합니다.
기타 설정 탭에서 다음을 수행 합니다.
- 런타임 버전 스크립팅은 편집기를 다시 시작해야 하는 실험적 버전(.NET 4.6 등가)이어야 합니다.
- 백 엔드 스크립팅은 .NET이어야 합니다.
- API 호환성 수준은 .NET 4.6이어야 합니다.
게시 설정 탭의 기능 아래에서 다음을 확인합니다.
InternetClient
패널 아래에서 XR 설정(게시 설정 아래에 있음)에서 지원되는 Virtual Reality를 확인하여 Windows Mixed Reality SDK가 추가되었는지 확인합니다.
빌드 설정으로 돌아가면 Unity C# 프로젝트가 더 이상 회색으로 표시되지 않습니다. 이 옆에 있는 확인란을 선택합니다.
빌드 설정 창을 닫습니다.
장면 및 프로젝트 저장(FILE>SAVE SCENE / FILE>SAVE PROJECT).
4장 - 기본 카메라 설정
Important
이 과정의 Unity 설정 구성 요소를 건너뛰고 코드를 계속 진행하려면 이 .unitypackage를 자유롭게 다운로드하여 사용자 지정 패키지로 프로젝트로 가져올 수 있습니다. 여기에는 다음 챕터의 DLL도 포함됩니다. 가져온 후 7장에서 계속 합니다.
계층 구조 패널에서 주 카메라라는 개체를 찾을 수 있습니다. 이 개체는 애플리케이션의 "내부"에 있으면 "헤드" 관점을 나타냅니다.
Unity 대시보드를 앞에 두고 주 카메라 GameObject를 선택합니다. 검사기 패널(일반적으로 대시보드 내에서 오른쪽에 표시됨)에는 해당 GameObject의 다양한 구성 요소가 표시되고 맨 위에 변환이 표시되고 카메라 및 기타 구성 요소가 표시됩니다. 기본 카메라의 변환을 다시 설정해야 하므로 올바르게 배치됩니다.
이렇게 하려면 카메라의 변환 구성 요소 옆에 있는 기어 아이콘을 선택하고 다시 설정을 선택합니다.
그런 다음 다음과 같이 변환 구성 요소를 업데이트합니다.
변환 - 위치
| X | Y | Z |
|---|---|---|
| 0 | 1 | 0 |
변환 - 회전
| X | Y | Z |
|---|---|---|
| 0 | 0 | 0 |
변환 - 크기 조정
| X | Y | Z |
|---|---|---|
| 1 | 1 | 1 |
5장 - Unity 장면 설정
계층 패널의 빈 영역을 마우스 오른쪽 단추로 클릭하고 3D 개체 아래에서 평면을 추가합니다.
Plane 개체를 선택한 상태에서 검사기 패널에서 다음 매개 변수를 변경합니다.
변환 - 위치
| X | Y | Z |
|---|---|---|
| 0 | 0 | 4 |
변환 - 크기 조정
| X | Y | Z |
|---|---|---|
| 10 | 1 | 10 |
계층 패널의 빈 영역을 마우스 오른쪽 단추로 클릭하고 3D 개체 아래에서 큐브를 추가합니다.
큐브 이름을 GazeButton으로 바꿉니다(큐브가 선택된 상태에서 'F2' 누름).
검사기 패널에서 변환 위치에 대한 다음 매개 변수를 변경합니다.
X Y Z 0 3 5 
태그 드롭다운 단추를 클릭하고 태그 추가를 클릭하여 태그 및 레이어 창을 엽니다.
+(더하기) 단추를 선택하고 새 태그 이름 필드에서 GazeButton을 입력하고 저장을 누릅니다.
계층 패널에서 GazeButton 개체를 클릭하고 검사기 패널에서 새로 만든 GazeButton 태그를 할당합니다.
Hierarchy 패널에서 GazeButton 개체를 마우스 오른쪽 단추로 클릭하고 빈 GameObject(자식 개체로 추가됨)를 추가합니다.
새 개체를 선택하고 ShapeSpawnPoint의 이름을 바꿉니다.
검사기 패널에서 변환 위치에 대한 다음 매개 변수를 변경합니다.
X Y Z 0 -1 0 
다음으로 Azure 서비스의 상태에 대한 피드백을 제공하는 3D Text 개체를 만듭니다.
계층 패널에서 GazeButton을 마우스 오른쪽 단추로 클릭하고 3D Object>3D Text 개체를 자식으로 추가합니다.
3D Text 개체의 이름을 AzureStatusText로 바꿉니다.
다음과 같이 AzureStatusText 개체 변환 위치를 변경합니다.
X Y Z 0 0 -0.6 다음과 같이 AzureStatusText 개체 변환 배율을 변경합니다. | X | Y | Z | | :---: | :---: | :---: | | 0.1 | 0.1 | 0.1 | 0.1 |
참고 항목
아래 텍스트 메시 구성 요소가 업데이트될 때 수정되므로 중앙에서 벗어난 것처럼 보이는 경우 걱정하지 마세요.
아래와 일치하도록 Text Mesh 구성 요소를 변경합니다.
팁
여기서 선택한 색은 16진수 색: 000000FF이지만 자유롭게 직접 선택할 수 있지만 읽을 수 있는지 확인합니다.
이제 계층 패널 구조는 다음과 같이 표시됩니다.
이제 장면은 다음과 같이 표시됩니다.
6장 - Unity용 Azure Storage 가져오기
Unity용 Azure Storage를 사용합니다(자체에서 Azure용 .Net SDK를 활용). 이에 대한 자세한 내용은 Azure Storage for Unity 문서에서 확인할 수 있습니다.
현재 Unity에는 가져온 후 플러그 인을 다시 구성해야 하는 알려진 문제가 있습니다. 버그가 해결된 후에는 이러한 단계(이 섹션의 4-7)가 더 이상 필요하지 않습니다.
SDK를 사용자 고유의 프로젝트로 가져오려면 GitHub에서 최신 '.unitypackage'를 다운로드했는지 확인합니다. 그런 후 다음을 수행합니다.
자산 패키지 사용자 지정 패키지> 가져오기 메뉴 옵션을 사용하여 .unitypackage 파일을 Unity에 추가합니다.>
팝업되는 Unity 패키지 가져오기 상자에서 플러그 인>스토리지에서 모든 항목을 선택할 수 있습니다. 이 과정에 필요하지 않으므로 다른 모든 항목을 선택 취소합니다.
가져오기 단추를 클릭하여 프로젝트에 항목을 추가합니다.
프로젝트 보기에서 플러그 인 아래의 Storage 폴더로 이동하여 다음 플러그 인만 선택합니다.
Microsoft.Data.Edm
Microsoft.Data.OData
Microsoft.WindowsAzure.Storage
Newtonsoft.Json
System.Spatial
이러한 특정 플러그 인을 선택한 상태에서 모든 플랫폼의 선택을 취소하고 WSAPlayer를 선택 취소한 다음 적용을 클릭합니다.
참고 항목
이러한 특정 플러그 인을 Unity 편집기에서만 사용하도록 표시하고 있습니다. 이는 프로젝트를 Unity에서 내보낸 후 사용할 WSA 폴더에 동일한 플러그 인의 다른 버전이 있기 때문입니다.
Storage 플러그 인 폴더에서 다음만 선택합니다.
Microsoft.Data.Services.Client
플랫폼 설정에서 처리 안 함 상자를 선택하고 적용을 클릭합니다.
참고 항목
Unity 어셈블리 패치가 이 플러그 인을 처리하는 데 어려움을 겪기 때문에 이 플러그 인을 "처리 안 함"으로 표시하고 있습니다. 플러그 인은 처리되지 않더라도 계속 작동합니다.
7장 - AzureServices 클래스 만들기
만들려는 첫 번째 클래스는 AzureServices 클래스입니다.
AzureServices 클래스는 다음을 담당합니다.
Azure 계정 자격 증명 저장
Azure 앱 함수를 호출합니다.
Azure Cloud Storage에서 데이터 파일의 업로드 및 다운로드입니다.
이 클래스를 만들려면 다음을 수행합니다.
프로젝트 패널의 폴더 만들기에 있는 자산 폴더를 마우스 오른쪽 단추로>클릭합니다. 폴더 이름을 스크립트로 지정합니다.
방금 만든 폴더를 두 번 클릭하여 엽니다.
폴더 내부를 마우스 오른쪽 단추로 클릭하고 C# 스크립트를 만듭니>다. 스크립트 AzureServices를 호출합니다.
새 AzureServices 클래스를 두 번 클릭하여 Visual Studio에서 엽니다.
AzureServices의 맨 위에 다음 네임스페이스를 추가합니다.
using System; using System.Threading.Tasks; using UnityEngine; using Microsoft.WindowsAzure.Storage; using Microsoft.WindowsAzure.Storage.File; using System.IO; using System.Net;AzureServices 클래스 내에 다음 Inspector 필드를 추가합니다 .
/// <summary> /// Provides Singleton-like behavior to this class. /// </summary> public static AzureServices instance; /// <summary> /// Reference Target for AzureStatusText Text Mesh object /// </summary> public TextMesh azureStatusText;그런 다음, AzureServices 클래스 내에 다음 멤버 변수를 추가합니다 .
/// <summary> /// Holds the Azure Function endpoint - Insert your Azure Function /// Connection String here. /// </summary> private readonly string azureFunctionEndpoint = "--Insert here you AzureFunction Endpoint--"; /// <summary> /// Holds the Storage Connection String - Insert your Azure Storage /// Connection String here. /// </summary> private readonly string storageConnectionString = "--Insert here you AzureStorage Connection String--"; /// <summary> /// Name of the Cloud Share - Hosts directories. /// </summary> private const string fileShare = "fileshare"; /// <summary> /// Name of a Directory within the Share /// </summary> private const string storageDirectory = "storagedirectory"; /// <summary> /// The Cloud File /// </summary> private CloudFile shapeIndexCloudFile; /// <summary> /// The Linked Storage Account /// </summary> private CloudStorageAccount storageAccount; /// <summary> /// The Cloud Client /// </summary> private CloudFileClient fileClient; /// <summary> /// The Cloud Share - Hosts Directories /// </summary> private CloudFileShare share; /// <summary> /// The Directory in the share that will host the Cloud file /// </summary> private CloudFileDirectory dir;Important
엔드포인트 및 연결 문자열 값을 Azure Portal에 있는 Azure Storage의 값으로 바꿔야 합니다.
이제 Awake() 및 Start() 메서드에 대한 코드를 추가해야 합니다. 이러한 메서드는 클래스가 초기화될 때 호출됩니다.
private void Awake() { instance = this; } // Use this for initialization private void Start() { // Set the Status text to loading, whilst attempting connection to Azure. azureStatusText.text = "Loading..."; } /// <summary> /// Call to the Azure Function App to request a Shape. /// </summary> public async void CallAzureFunctionForNextShape() { }Important
향후 챕터에서 CallAzureFunctionForNextShape()에 대한 코드를 작성합니다.
이 클래스는 이 메서드를 사용하지 않으므로 Update() 메서드를 삭제합니다.
Visual Studio에서 변경 내용을 저장한 다음 Unity로 돌아갑니다.
스크립트 폴더에서 계층 패널의 Main Camera 개체로 AzureServices 클래스를 클릭하고 끕니다.
주 카메라를 선택한 다음 GazeButton 개체 아래에서 AzureStatusText 자식 개체를 잡고 검사기에서 AzureStatusText 참조 대상 필드 내에 배치하여 AzureServices 스크립트에 대한 참조를 제공합니다.
8장 - ShapeFactory 클래스 만들기
만들 다음 스크립트는 ShapeFactory 클래스입니다. 이 클래스의 역할은 요청 시 새 셰이프를 만들고 셰이프 기록 목록에서 만든 셰이프의 기록을 유지하는 것입니다. 셰이프를 만들 때마다 셰이프 기록 목록이 AzureService 클래스에서 업데이트된 다음 Azure Storage에 저장됩니다. 애플리케이션이 시작되면 Azure Storage에 저장된 파일이 있으면 생성된 셰이프가 스토리지에서 가져온 것인지 아니면 새로 생성되었는지를 제공하는 3D Text 개체와 함께 셰이프 기록 목록이 검색되고 재생됩니다.
이 클래스를 만들려면 다음을 수행합니다.
이전에 만든 Scripts 폴더로 이동합니다.
폴더 내부를 마우스 오른쪽 단추로 클릭하고 C# 스크립트를 만듭니>다. 스크립트 ShapeFactory를 호출합니다.
새 ShapeFactory 스크립트를 두 번 클릭하여 Visual Studio에서 엽니다.
ShapeFactory 클래스에 다음 네임스페이스가 포함되어 있는지 확인합니다.
using System.Collections.Generic; using UnityEngine;아래 표시된 변수를 ShapeFactory 클래스에 추가하고 Start() 및 Awake() 함수를 아래 함수로 바꿉니다.
/// <summary> /// Provide this class Singleton-like behaviour /// </summary> [HideInInspector] public static ShapeFactory instance; /// <summary> /// Provides an Inspector exposed reference to ShapeSpawnPoint /// </summary> [SerializeField] public Transform spawnPoint; /// <summary> /// Shape History Index /// </summary> [HideInInspector] public List<int> shapeHistoryList; /// <summary> /// Shapes Enum for selecting required shape /// </summary> private enum Shapes { Cube, Sphere, Cylinder } private void Awake() { instance = this; } private void Start() { shapeHistoryList = new List<int>(); }CreateShape() 메서드는 제공된 정수 매개 변수를 기반으로 기본 셰이프를 생성합니다. 부울 매개 변수는 현재 생성된 셰이프가 스토리지에서 생성되었는지 또는 새로 생성되었는지를 지정하는 데 사용됩니다. 이전 메서드 아래의 ShapeFactory 클래스에 다음 코드를 배치합니다.
/// <summary> /// Use the Shape Enum to spawn a new Primitive object in the scene /// </summary> /// <param name="shape">Enumerator Number for Shape</param> /// <param name="storageShape">Provides whether this is new or old</param> internal void CreateShape(int shape, bool storageSpace) { Shapes primitive = (Shapes)shape; GameObject newObject = null; string shapeText = storageSpace == true ? "Storage: " : "New: "; AzureServices.instance.azureStatusText.text = string.Format("{0}{1}", shapeText, primitive.ToString()); switch (primitive) { case Shapes.Cube: newObject = GameObject.CreatePrimitive(PrimitiveType.Cube); break; case Shapes.Sphere: newObject = GameObject.CreatePrimitive(PrimitiveType.Sphere); break; case Shapes.Cylinder: newObject = GameObject.CreatePrimitive(PrimitiveType.Cylinder); break; } if (newObject != null) { newObject.transform.position = spawnPoint.position; newObject.transform.localScale = new Vector3(0.5f, 0.5f, 0.5f); newObject.AddComponent<Rigidbody>().useGravity = true; newObject.GetComponent<Renderer>().material.color = UnityEngine.Random.ColorHSV(0f, 1f, 1f, 1f, 0.5f, 1f); } }Unity로 돌아가기 전에 Visual Studio에서 변경 내용을 저장해야 합니다.
Unity 편집기로 돌아가서 Scripts 폴더에서 계층 패널의 Main Camera 개체로 ShapeFactory 클래스를 클릭하고 끕니다.
주 카메라를 선택하면 ShapeFactory 스크립트 구성 요소에 생성 지점 참조가 없음을 알 수 있습니다. 이 문제를 해결하려면 [계층 구조] 패널에서 [생성 지점] 참조 대상으로 ShapeSpawnPoint 개체를 끕니다.
9장 - Gaze 클래스 만들기
만들어야 하는 마지막 스크립트는 Gaze 클래스입니다.
이 클래스는 사용자가 보고 있는 개체를 감지하기 위해 주 카메라에서 앞으로 프로젝싱되는 Raycast 를 만듭니다. 이 경우 Raycast는 사용자가 장면에서 GazeButton 개체를 보고 있는지 확인하고 동작을 트리거해야 합니다.
이 클래스를 만들려면 다음을 수행합니다.
이전에 만든 Scripts 폴더로 이동합니다.
프로젝트 패널에서 C# 스크립트를 마우스 오른쪽 단추로>클릭합니다. 스크립트 응시를 호출합니다.
새 응시 스크립트를 두 번 클릭하여 Visual Studio에서 엽니다.
스크립트 맨 위에 다음 네임스페이스가 포함되어 있는지 확인합니다.
using UnityEngine;그런 다음 Gaze 클래스 내에 다음 변수를 추가합니다.
/// <summary> /// Provides Singleton-like behavior to this class. /// </summary> public static Gaze instance; /// <summary> /// The Tag which the Gaze will use to interact with objects. Can also be set in editor. /// </summary> public string InteractibleTag = "GazeButton"; /// <summary> /// The layer which will be detected by the Gaze ('~0' equals everything). /// </summary> public LayerMask LayerMask = ~0; /// <summary> /// The Max Distance the gaze should travel, if it has not hit anything. /// </summary> public float GazeMaxDistance = 300; /// <summary> /// The size of the cursor, which will be created. /// </summary> public Vector3 CursorSize = new Vector3(0.05f, 0.05f, 0.05f); /// <summary> /// The color of the cursor - can be set in editor. /// </summary> public Color CursorColour = Color.HSVToRGB(0.0223f, 0.7922f, 1.000f); /// <summary> /// Provides when the gaze is ready to start working (based upon whether /// Azure connects successfully). /// </summary> internal bool GazeEnabled = false; /// <summary> /// The currently focused object. /// </summary> internal GameObject FocusedObject { get; private set; } /// <summary> /// The object which was last focused on. /// </summary> internal GameObject _oldFocusedObject { get; private set; } /// <summary> /// The info taken from the last hit. /// </summary> internal RaycastHit HitInfo { get; private set; } /// <summary> /// The cursor object. /// </summary> internal GameObject Cursor { get; private set; } /// <summary> /// Provides whether the raycast has hit something. /// </summary> internal bool Hit { get; private set; } /// <summary> /// This will store the position which the ray last hit. /// </summary> internal Vector3 Position { get; private set; } /// <summary> /// This will store the normal, of the ray from its last hit. /// </summary> internal Vector3 Normal { get; private set; } /// <summary> /// The start point of the gaze ray cast. /// </summary> private Vector3 _gazeOrigin; /// <summary> /// The direction in which the gaze should be. /// </summary> private Vector3 _gazeDirection;
Important
이러한 변수 중 일부는 편집기에서 편집할 수 있습니다.
이제 Awake() 및 Start() 메서드에 대한 코드를 추가해야 합니다.
/// <summary> /// The method used after initialization of the scene, though before Start(). /// </summary> private void Awake() { // Set this class to behave similar to singleton instance = this; } /// <summary> /// Start method used upon initialization. /// </summary> private void Start() { FocusedObject = null; Cursor = CreateCursor(); }GazeEnabled 부울이 토글되는 위치와 함께 Raycast 메서드를 실행하는 Update() 메서드와 함께 시작 시 커서 개체를 만드는 다음 코드를 추가합니다.
/// <summary> /// Method to create a cursor object. /// </summary> /// <returns></returns> private GameObject CreateCursor() { GameObject newCursor = GameObject.CreatePrimitive(PrimitiveType.Sphere); newCursor.SetActive(false); // Remove the collider, so it doesn't block raycast. Destroy(newCursor.GetComponent<SphereCollider>()); newCursor.transform.localScale = CursorSize; newCursor.GetComponent<MeshRenderer>().material = new Material(Shader.Find("Diffuse")) { color = CursorColour }; newCursor.name = "Cursor"; newCursor.SetActive(true); return newCursor; } /// <summary> /// Called every frame /// </summary> private void Update() { if(GazeEnabled == true) { _gazeOrigin = Camera.main.transform.position; _gazeDirection = Camera.main.transform.forward; UpdateRaycast(); } }다음으로 Raycast를 프로젝팅하고 적중 대상을 검색하는 UpdateRaycast() 메서드를 추가합니다.
private void UpdateRaycast() { // Set the old focused gameobject. _oldFocusedObject = FocusedObject; RaycastHit hitInfo; // Initialise Raycasting. Hit = Physics.Raycast(_gazeOrigin, _gazeDirection, out hitInfo, GazeMaxDistance, LayerMask); HitInfo = hitInfo; // Check whether raycast has hit. if (Hit == true) { Position = hitInfo.point; Normal = hitInfo.normal; // Check whether the hit has a collider. if (hitInfo.collider != null) { // Set the focused object with what the user just looked at. FocusedObject = hitInfo.collider.gameObject; } else { // Object looked on is not valid, set focused gameobject to null. FocusedObject = null; } } else { // No object looked upon, set focused gameobject to null. FocusedObject = null; // Provide default position for cursor. Position = _gazeOrigin + (_gazeDirection * GazeMaxDistance); // Provide a default normal. Normal = _gazeDirection; } // Lerp the cursor to the given position, which helps to stabilize the gaze. Cursor.transform.position = Vector3.Lerp(Cursor.transform.position, Position, 0.6f); // Check whether the previous focused object is this same // object. If so, reset the focused object. if (FocusedObject != _oldFocusedObject) { ResetFocusedObject(); if (FocusedObject != null) { if (FocusedObject.CompareTag(InteractibleTag.ToString())) { // Set the Focused object to green - success! FocusedObject.GetComponent<Renderer>().material.color = Color.green; // Start the Azure Function, to provide the next shape! AzureServices.instance.CallAzureFunctionForNextShape(); } } } }마지막으로 새 셰이프를 만드는지 여부를 나타내는 GazeButton 개체의 현재 색을 토글하는 ResetFocusedObject() 메서드를 추가합니다.
/// <summary> /// Reset the old focused object, stop the gaze timer, and send data if it /// is greater than one. /// </summary> private void ResetFocusedObject() { // Ensure the old focused object is not null. if (_oldFocusedObject != null) { if (_oldFocusedObject.CompareTag(InteractibleTag.ToString())) { // Set the old focused object to red - its original state. _oldFocusedObject.GetComponent<Renderer>().material.color = Color.red; } } }Unity로 돌아가기 전에 Visual Studio에서 변경 내용을 저장합니다.
[스크립트] 폴더에서 [계층 구조] 패널의 [Main Camera] 개체로 Gaze 클래스를 클릭하고 끕니다.
10장 - AzureServices 클래스 완료
다른 스크립트를 사용하면 이제 AzureServices 클래스를 완료할 수 있습니다. 이 작업은 다음을 통해 수행됩니다.
CreateCloudIdentityAsync()라는 새 메서드를 추가하여 Azure와 통신하는 데 필요한 인증 변수를 설정합니다.
또한 이 메서드는 셰이프 목록을 포함하는 이전에 저장된 파일이 있는지 확인합니다.
파일이 발견되면 사용자 응시를 사용하지 않도록 설정하고, Azure Storage 파일에 저장된 셰이프 패턴에 따라 셰이프 만들기를 트리거합니다. 텍스트 메시가 셰이프 원본에 따라 '스토리지' 또는 '새로 만들기' 표시를 제공하므로 사용자는 이를 볼 수 있습니다.
파일이 없으면 Gaze를 사용하도록 설정하므로 사용자가 장면에서 GazeButton 개체를 확인할 때 셰이프를 만들 수 있습니다.
/// <summary> /// Create the references necessary to log into Azure /// </summary> private async void CreateCloudIdentityAsync() { // Retrieve storage account information from connection string storageAccount = CloudStorageAccount.Parse(storageConnectionString); // Create a file client for interacting with the file service. fileClient = storageAccount.CreateCloudFileClient(); // Create a share for organizing files and directories within the storage account. share = fileClient.GetShareReference(fileShare); await share.CreateIfNotExistsAsync(); // Get a reference to the root directory of the share. CloudFileDirectory root = share.GetRootDirectoryReference(); // Create a directory under the root directory dir = root.GetDirectoryReference(storageDirectory); await dir.CreateIfNotExistsAsync(); //Check if the there is a stored text file containing the list shapeIndexCloudFile = dir.GetFileReference("TextShapeFile"); if (!await shapeIndexCloudFile.ExistsAsync()) { // File not found, enable gaze for shapes creation Gaze.instance.GazeEnabled = true; azureStatusText.text = "No Shape\nFile!"; } else { // The file has been found, disable gaze and get the list from the file Gaze.instance.GazeEnabled = false; azureStatusText.text = "Shape File\nFound!"; await ReplicateListFromAzureAsync(); } }다음 코드 조각은 Start() 메서드 내에서 시작됩니다. 여기서 CreateCloudIdentityAsync() 메서드를 호출합니다. 아래와 함께 현재 Start() 메서드를 자유롭게 복사할 수 있습니다.
private void Start() { // Disable TLS cert checks only while in Unity Editor (until Unity adds support for TLS) #if UNITY_EDITOR ServicePointManager.ServerCertificateValidationCallback = delegate { return true; }; #endif // Set the Status text to loading, whilst attempting connection to Azure. azureStatusText.text = "Loading..."; //Creating the references necessary to log into Azure and check if the Storage Directory is empty CreateCloudIdentityAsync(); }CallAzureFunctionForNextShape()메서드에 대한 코드를 입력합니다. 이전에 만든 Azure Function App 을 사용하여 셰이프 인덱스 요청합니다. 새 셰이프가 수신되면 이 메서드는 셰이프를 ShapeFactory 클래스로 보내 장면에 새 셰이프를 만듭니다. 아래 코드를 사용하여 CallAzureFunctionForNextShape()의 본문을 완료합니다.
/// <summary> /// Call to the Azure Function App to request a Shape. /// </summary> public async void CallAzureFunctionForNextShape() { int azureRandomInt = 0; // Call Azure function HttpWebRequest webRequest = WebRequest.CreateHttp(azureFunctionEndpoint); WebResponse response = await webRequest.GetResponseAsync(); // Read response as string using (Stream stream = response.GetResponseStream()) { StreamReader reader = new StreamReader(stream); String responseString = reader.ReadToEnd(); //parse result as integer Int32.TryParse(responseString, out azureRandomInt); } //add random int from Azure to the ShapeIndexList ShapeFactory.instance.shapeHistoryList.Add(azureRandomInt); ShapeFactory.instance.CreateShape(azureRandomInt, false); //Save to Azure storage await UploadListToAzureAsync(); }셰이프 기록 목록에 저장된 정수를 연결하고 Azure Storage 파일에 저장하여 문자열을 만드는 메서드를 추가합니다.
/// <summary> /// Upload the locally stored List to Azure /// </summary> private async Task UploadListToAzureAsync() { // Uploading a local file to the directory created above string listToString = string.Join(",", ShapeFactory.instance.shapeHistoryList.ToArray()); await shapeIndexCloudFile.UploadTextAsync(listToString); }Azure Storage 파일에 있는 파일에 저장된 텍스트를 검색하고 목록으로 역직렬화하는 메서드를 추가합니다.
이 프로세스가 완료되면 메서드는 사용자가 장면에 셰이프를 더 추가할 수 있도록 응시를 다시 사용하도록 설정합니다.
///<summary> /// Get the List stored in Azure and use the data retrieved to replicate /// a Shape creation pattern ///</summary> private async Task ReplicateListFromAzureAsync() { string azureTextFileContent = await shapeIndexCloudFile.DownloadTextAsync(); string[] shapes = azureTextFileContent.Split(new char[] { ',' }); foreach (string shape in shapes) { int i; Int32.TryParse(shape.ToString(), out i); ShapeFactory.instance.shapeHistoryList.Add(i); ShapeFactory.instance.CreateShape(i, true); await Task.Delay(500); } Gaze.instance.GazeEnabled = true; azureStatusText.text = "Load Complete!"; }Unity로 돌아가기 전에 Visual Studio에서 변경 내용을 저장합니다.
11장 - UWP 솔루션 빌드
빌드 프로세스를 시작하려면 다음을 수행합니다.
파일>빌드 설정으로 이동합니다.
빌드를 클릭한 다음 Unity에서 파일 탐색기 창이 시작됩니다. 여기서는 앱을 만들 폴더를 선택합니다. 이제 해당 폴더를 만들고 이름을 앱으로 지정합니다. 그런 다음 앱 폴더를 선택한 상태에서 폴더 선택 키를 누릅니 다.
Unity는 App 폴더에 프로젝트 빌드를 시작합니다.
Unity가 빌드를 마치면(시간이 좀 걸릴 수 있음) 빌드 위치에서 파일 탐색기 창이 열립니다(작업 표시줄이 항상 창 위에 표시되지는 않지만 새 창이 추가되었음을 알려 주시기 때문에 작업 표시줄 확인).
12장 - 애플리케이션 배포
애플리케이션을 배포하려면 다음을 수행합니다.
마지막 챕터에서 만든 앱 폴더로 이동합니다. 앱 이름이 '.sln' 확장명을 가진 파일이 표시되며, Visual Studio 내에서 파일을 열려면 두 번 클릭해야 합니다.
솔루션 플랫폼에서 x86, 로컬 머신을 선택합니다.
솔루션 구성에서 디버그를 선택합니다.
Microsoft HoloLens의 경우 컴퓨터에 테더링되지 않도록 원격 컴퓨터로 설정하는 것이 더 쉬울 수 있습니다. 하지만 다음을 수행해야 합니다.
- 설정>네트워크 및 인터넷>Wi-Fi>고급 옵션 내에서 찾을 수 있는 HoloLens의 IP 주소를 알고 있습니다. IPv4는 사용해야 하는 주소입니다.
- 개발자 모드가 켜지도록 합니다. 개발자를 위한 설정>업데이트 및 보안>에 있습니다.
빌드 메뉴로 이동하여 솔루션 배포를 클릭하여 애플리케이션을 컴퓨터에 테스트용으로 로드합니다.
이제 앱이 설치된 앱 목록에 표시되어 시작 및 테스트할 준비가 되었습니다.
완료된 Azure Functions 및 Storage 애플리케이션
축하합니다. Azure Functions 및 Azure Storage 서비스를 모두 활용하는 혼합 현실 앱을 빌드했습니다. 앱은 저장된 데이터를 그리고 해당 데이터를 기반으로 작업을 제공할 수 있습니다.
보너스 연습
연습 1
두 번째 생성 지점을 만들고 개체가 생성된 생성 지점을 기록합니다. 데이터 파일을 로드할 때 원래 생성된 위치에서 생성되는 셰이프를 재생합니다.
연습 2
매번 다시 열지 않고 앱을 다시 시작하는 방법을 만듭니다. 장면을 로드하는 것은 시작하기에 좋은 장소입니다. 이렇게 하면 앱에서 쉽게 다시 설정할 수 있도록 Azure Storage에서 저장된 목록을 지우는 방법을 만듭니다.