샘플 앱 실행: Android - Xamarin(C#)

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

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

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

Azure를 구독하고 있지 않다면 시작하기 전에 Azure 체험 계정을 만듭니다.

필수 조건

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

• Windows 또는 macOS 컴퓨터:
  • Windows를 사용하는 경우:
    • 최신 버전의 Visual Studio 2019 16.2 이상
    • Windows용 Git.
    • Git LFS.
  • macOS를 사용하는 경우:
    • 최신 버전의 Mac용 Visual Studio 8.1 이상
    • macOS용 Git.
    • Git LFS.
• 선택한 플랫폼에 설치되어 실행 중인 최신 버전의 Xamarin.Android. Xamarin.Android를 설치하는 가이드는 Xamarin.Android 설치 가이드를 참조하세요.
• 개발자 사용 및 ARCore 지원 Android 디바이스.
  • 컴퓨터가 Android 디바이스와 통신하려면 추가 디바이스 드라이버가 필요할 수 있습니다. 자세한 내용은 여기를 참조하세요.
• 앱은 ARCore 1.8을 대상으로 해야 합니다.

Spatial Anchors 리소스 만들기

포털

Azure Portal로 이동합니다.

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

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

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

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

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

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

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

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

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

• 리소스 만들기를 시작하려면 만들기를 선택합니다.

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

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

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

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

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

Azure CLI

Azure CLI에 대한 환경 준비하는 것으로 시작합니다.

• Azure Cloud Shell에서 Bash 환경을 사용합니다. 자세한 내용은 Azure Cloud Shell의 Bash에 대한 빠른 시작을 참조하세요.

  

• CLI 참조 명령을 로컬에서 실행하려면 Azure CLI를 설치합니다. Windows 또는 macOS에서 실행 중인 경우 Docker 컨테이너에서 Azure CLI를 실행하는 것이 좋습니다. 자세한 내용은 Docker 컨테이너에서 Azure CLI를 실행하는 방법을 참조하세요.

  • 로컬 설치를 사용하는 경우 az login 명령을 사용하여 Azure CLI에 로그인합니다. 인증 프로세스를 완료하려면 터미널에 표시되는 단계를 수행합니다. 다른 로그인 옵션은 Azure CLI를 사용하여 로그인을 참조하세요.

  • 메시지가 표시되면 처음 사용할 때 Azure CLI 확장을 설치합니다. 확장에 대한 자세한 내용은 Azure CLI에서 확장 사용을 참조하세요.

  • az version을 실행하여 설치된 버전과 종속 라이브러리를 찾습니다. 최신 버전으로 업그레이드하려면 az upgrade를 실행합니다.

1. 로그인 후 az account set 명령을 사용하여 공간 앵커 계정을 설정할 구독을 선택합니다.

   az account set --subscription 00000000-0000-0000-0000-000000000000
   

2. az group create 명령을 실행하여 리소스 그룹을 만들거나 기존 리소스 그룹을 사용합니다.

   az group create --name myResourceGroup --location eastus2
   

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

   az spatial-anchors-account list 명령을 사용하여 리소스 그룹의 현재 공간 앵커 계정을 볼 수 있습니다.

   az spatial-anchors-account list --resource-group myResourceGroup
   

   또한 구독의 공간 앵커 계정을 볼 수도 있습니다.

   az spatial-anchors-account list
   

3. az spatial-anchors-account create 명령을 실행하여 공간 앵커 계정을 만듭니다.

   az spatial-anchors-account create --resource-group myResourceGroup --name MySpatialAnchorsQuickStart --location eastus2
   

4. az spatial-anchors-account show 명령을 사용하여 리소스 속성을 봅니다.

   az spatial-anchors-account show --resource-group myResourceGroup --name MySpatialAnchorsQuickStart
   

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

5. az spatial-anchors-account key show 명령을 실행하여 기본 키 및 보조 키를 가져옵니다.

   az spatial-anchors-account key show --resource-group myResourceGroup --name MySpatialAnchorsQuickStart
   

   나중에 사용하기 위해 키 값을 텍스트 편집기에 복사합니다.

   키를 다시 생성해야 하는 경우 az spatial-anchors-account key renew 명령을 사용합니다.

   az spatial-anchors-account key renew --resource-group myResourceGroup --name example --key primary
   az spatial-anchors-account key renew --resource-group myResourceGroup --name example --key secondary
   

az spatial-anchors-account delete 명령을 사용하여 계정을 삭제할 수 있습니다.

az spatial-anchors-account delete --resource-group myResourceGroup --name MySpatialAnchorsQuickStart

Azure PowerShell

Azure PowerShell에 대한 환경을 준비하는 것으로 시작합니다.

• Azure PowerShell을 로컬로 사용하도록 선택하는 경우:
  • 최신 버전의 Az PowerShell 모듈을 설치합니다.
  • Connect-AzAccount cmdlet을 사용하여 Azure 계정에 로그인합니다.
• Azure Cloud Shell을 사용하도록 선택하는 경우:
  • 자세한 내용은 Azure Cloud Shell 개요를 참조하세요.

Important

Az.MixedReality PowerShell 모듈이 미리 보기로 제공되는 동안 Install-Module cmdlet을 사용하여 별도로 설치해야 합니다. 이 PowerShell 모듈이 일반 공급되면 이후 Az PowerShell 모듈 릴리스의 일부가 되며 기본적으로 Azure Cloud Shell 내에서 사용할 수 있습니다.

Install-Module -Name Az.MixedReality

1. 로그인 후 Set-AzContext cmdlet을 사용하여 공간 앵커 계정을 설정할 구독을 선택합니다.

   Set-AzContext -SubscriptionId aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e
   

2. New-AzResourceGroup cmdlet을 실행하여 리소스 그룹을 만들거나 기존 리소스 그룹을 사용합니다.

   New-AzResourceGroup -Name myResourceGroup -Location eastus2
   

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

   Get-AzSpatialAnchorsAccount cmdlet을 사용하여 리소스 그룹의 현재 공간 앵커 계정을 볼 수 있습니다.

   Get-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup
   

   또한 구독의 공간 앵커 계정을 볼 수도 있습니다.

   Get-AzSpatialAnchorsAccount
   

3. New-AzSpatialAnchorsAccount cmdlet을 실행하여 공간 앵커 계정을 만듭니다.

   New-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart -Location eastus2
   

4. Get-AzSpatialAnchorsAccount cmdlet을 사용하여 리소스 속성을 봅니다.

   Get-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart
   

   나중에 사용할 수 있도록 accountId 속성 값과 accountDomain 속성 값을 텍스트 편집기에 복사합니다.

5. Get-AzSpatialAnchorsAccountKey cmdlet을 실행하여 기본 키 및 보조 키를 가져옵니다.

   Get-AzSpatialAnchorsAccountKey -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart
   

   나중에 사용하기 위해 키 값을 텍스트 편집기에 복사합니다.

   키를 다시 생성해야 하는 경우 New-AzSpatialAnchorsAccountKey cmdlet을 사용합니다.

   New-AzSpatialAnchorsAccountKey -ResourceGroupName myResourceGroup -Name MySpatialAnchorsQuickStart -Primary
   New-AzSpatialAnchorsAccountKey -ResourceGroupName myResourceGroup -Name MySpatialAnchorsQuickStart -Secondary
   

Remove-AzSpatialAnchorsAccount cmdlet을 사용하여 계정을 삭제할 수 있습니다.

Remove-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart

샘플 프로젝트 열기

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

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

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

macOS

실행>디버깅 없이 시작을 선택하여 앱을 배포하고 시작합니다.

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

리소스 정리

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

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

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

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

다음 단계

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

자습서: 여러 디바이스에서 Spatial Anchors 공유