빠른 시작: Azure Spatial Anchors를 사용하여 Xamarin Android 앱 만들기

이 빠른 시작에서는 Azure Spatial Anchors를 사용하여 Xamarin 지원 Android 앱을 만드는 방법을 설명합니다. Azure Spatial Anchors는 시간이 지남에 따라 디바이스에서 위치를 유지하는 개체를 사용하여 혼합 현실 환경을 만들 수 있는 플랫폼 간 개발자 서비스입니다. 이 과정을 마치면, 공간 앵커를 저장하고 회수할 수 있는 Android 앱을 갖게 됩니다.

이 문서에서 배울 내용은 다음과 같습니다.

  • Spatial Anchors 계정 만들기
  • Spatial Anchors 계정 식별자 및 계정 키 구성
  • Android 디바이스 배포 및 실행

Azure 구독이 아직 없는 경우 시작하기 전에 체험 계정을 만듭니다.

사전 요구 사항

이 빠른 시작을 완료하려면 다음 항목이 있어야 합니다.

Spatial Anchors 리소스 만들기

Azure 포털로 이동합니다.

왼쪽 창에서 리소스 만들기 를 선택합니다.

검색 상자를 사용하여 Spatial Anchors 를 검색합니다.

Spatial Anchors 검색 결과를 보여주는 스크린샷.

Spatial Anchors 를 선택한 다음, 만들기 를 선택합니다.

Spatial Anchors 계정 창에서 다음을 수행합니다.

  • 일반 영숫자 문자를 사용하여 고유한 리소스 이름을 입력합니다.

  • 리소스를 연결할 구독을 선택합니다.

  • 새로 만들기 를 선택하여 리소스 그룹을 만듭니다. 이름을 myResourceGroup 으로 지정한 다음, 확인 을 선택합니다.

    리소스 그룹은 웹앱, 데이터베이스, 스토리지 계정과 같은 Azure 리소스가 배포되고 관리되는 논리적 컨테이너입니다. 예를 들어 나중에 간단한 단계 하나만으로 전체 리소스 그룹을 삭제하도록 선택할 수 있습니다.

  • 리소스를 배치할 위치(Azure 지역)를 선택합니다.

  • 새로 만들기 를 선택하여 리소스 만들기를 시작합니다.

리소스를 만들기 위한 Spatial Anchors 창의 스크린샷.

리소스를 만든 후 Azure Portal은 배포가 완료되었음을 표시합니다.

리소스 배포가 완료되었음을 보여주는 스크린샷입니다.

리소스로 이동 을 선택합니다. 이제 리소스 속성을 볼 수 있습니다.

나중에 사용하기 위해 리소스의 계정 ID 값을 텍스트 편집기에 복사합니다.

리소스 속성 창의 스크린샷.

또한 리소스의 계정 도메인 값을 텍스트 편집기에 복사합니다.

리소스의 계정 도메인 값을 보여주는 스크린샷.

설정 아래에서 를 선택합니다. 나중에 사용하기 위해 기본 키 값, 계정 키 를 텍스트 편집기에 복사합니다.

계정에 대한 키 창의 스크린샷.

샘플 프로젝트 열기

다음 명령을 실행하여 샘플 리포지토리를 복제합니다.

git clone https://github.com/Azure/azure-spatial-anchors-samples.git
cd ./azure-spatial-anchors-samples

Visual Studio에서 Xamarin/SampleXamarin.sln을 엽니다.

계정 식별자 및 키 구성

다음 단계는 계정 식별자 및 계정 키를 사용하도록 앱을 구성하는 것입니다. Spatial Anchors 리소스 설정 시 텍스트 편집기에 복사했습니다.

Xamarin/SampleXamarin.Common/AccountDetails.cs를 엽니다.

SpatialAnchorsAccountKey 필드를 찾아 Set me를 계정 키로 바꿉니다.

SpatialAnchorsAccountId 필드를 찾아 Set me를 계정 식별자로 바꿉니다.

SpatialAnchorsAccountDomain 필드를 찾아 Set me를 계정 도메인으로 바꿉니다.

Android 디바이스에 앱 배포

Android 디바이스의 전원을 켜고 로그인한 후 USB 케이블을 사용하여 컴퓨터에 연결합니다.

시작 프로젝트를 SampleXamarin.Android 로 설정하고, 솔루션 구성릴리스 로 변경하고, 디바이스 선택기 드롭다운에서 배포할 디바이스를 선택합니다.

Windows에서 프로젝트 및 디바이스를 선택하는 메뉴를 보여주는 스크린샷.

디버그 > 디버깅 시작 을 선택하여 앱을 배포하고 시작합니다.

앱에서 기본 을 선택하여 데모를 실행하고 지침에 따라 앵커를 배치하고 회수합니다.

스크린샷 1 스크린샷 2 스크린샷 3

리소스 정리

이전 단계에서 Azure 리소스를 리소스 그룹에 만들었습니다. 이러한 리소스가 나중에 필요하지 않을 경우에는 리소스 그룹을 삭제하여 해당 리소스를 삭제할 수 있습니다.

Azure Portal 메뉴 또는 페이지에서 리소스 그룹 을 선택합니다. 그런 다음, 리소스 그룹 페이지에서 myResourceGroup 을 선택합니다.

myResourceGroup 페이지에서 나열된 리소스가 삭제하려는 리소스인지 확인합니다.

리소스 그룹 삭제 를 선택하고, 텍스트 상자에서 myResourceGroup 을 입력하여 확인한 다음, 삭제 를 선택합니다.

다음 단계

이 빠른 시작에서는 Spatial Anchors 계정을 만들었습니다. 그런 다음, 공간 앵커를 저장하고 회수하도록 앱을 구성하고 배포했습니다. 다른 디바이스와 공간 앵커를 공유할 수 있도록 앱을 개선하는 방법을 자세히 알아보려면 다음 자습서를 계속 진행하세요.