샘플 앱 실행: Android - Android Studio(Java 또는 C++/NDK)

아티클
02/27/2024

이 빠른 시작에서는 Android Studio(Java 또는 C++/NDK)를 사용하여 Android 디바이스용 Azure Spatial Anchors 샘플 앱을 실행하는 방법을 다룹니다. Azure Spatial Anchors는 시간이 지남에 따라 디바이스에서 위치를 유지하는 개체를 사용하여 혼합 현실 환경을 만들 수 있는 플랫폼 간 개발자 서비스입니다. 완료되면, ARCore Android 앱이 있어 공간 앵커를 저장하고 회수할 수 있습니다.

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

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

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

필수 조건

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

Android Studio 3.4+가 설치된 Windows 또는 macOS 머신.
- Windows에서 실행하는 경우 Windows용 Git 및 Git LFS도 필요합니다.
- macOS에서 실행하는 경우 HomeBrew를 통해 Git이 설치됩니다. 터미널의 한 줄에 /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)" 명령을 입력합니다. 그런 다음, brew install git 및 brew install git-lfs를 실행합니다.
- NDK 샘플을 빌드하려면 Android Studio에 NDK 및 CMake 3.6 이상의 SDK Tools를 설치해야 합니다.
개발자 사용 및 ARCore 지원 Android 디바이스.
- 컴퓨터가 Android 디바이스와 통신하려면 추가 디바이스 드라이버가 필요할 수 있습니다. 추가 정보 및 지침은 여기를 참조하세요.
앱은 ARCore 1.11.0을 대상으로 해야 합니다.

Spatial Anchors 리소스 만들기

Azure Portal로 이동합니다.

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

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

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

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

일반 영숫자 문자를 사용하여 고유한 리소스 이름을 입력합니다.
리소스를 연결할 구독을 선택합니다.
새로 만들기를 선택하여 리소스 그룹을 만듭니다. 이름을 myResourceGroup으로 지정한 다음, 확인을 선택합니다.

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

Screenshot of the Spatial Anchors pane for creating a resource.

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

Screenshot showing that the resource deployment is complete.

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

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

Screenshot of the resource properties pane.

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

Screenshot showing the resource's account domain value.

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

Screenshot of the Keys pane for the account.

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를 실행합니다.

로그인 후 az account set 명령을 사용하여 공간 앵커 계정을 설정할 구독을 선택합니다.
```
az account set --subscription 00000000-0000-0000-0000-000000000000
```
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
```

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

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

az spatial-anchors-account show 명령을 사용하여 리소스 속성을 봅니다.
```
az spatial-anchors-account show --resource-group myResourceGroup --name MySpatialAnchorsQuickStart
```
나중에 사용하기 위해 리소스 계정 ID 값과 리소스 계정 도메인 값을 텍스트 편집기에 복사합니다.

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을 로컬로 사용하도록 선택하는 경우:
- 최신 버전의 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

로그인 후 Set-AzContext cmdlet을 사용하여 공간 앵커 계정을 설정할 구독을 선택합니다.
```
Set-AzContext -SubscriptionId 00000000-0000-0000-0000-000000000000
```
New-AzResourceGroup cmdlet을 실행하여 리소스 그룹을 만들거나 기존 리소스 그룹을 사용합니다.
```
New-AzResourceGroup -Name myResourceGroup -Location eastus2
```
리소스 그룹은 웹앱, 데이터베이스, 스토리지 계정과 같은 Azure 리소스가 배포되고 관리되는 논리적 컨테이너입니다. 예를 들어 나중에 간단한 단계 하나만으로 전체 리소스 그룹을 삭제하도록 선택할 수 있습니다.

Get-AzSpatialAnchorsAccount cmdlet을 사용하여 리소스 그룹의 현재 공간 앵커 계정을 볼 수 있습니다.
```
Get-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup
```
또한 구독의 공간 앵커 계정을 볼 수도 있습니다.
```
Get-AzSpatialAnchorsAccount
```

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

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

Get-AzSpatialAnchorsAccount cmdlet을 사용하여 리소스 속성을 봅니다.
```
Get-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart
```
나중에 사용할 수 있도록 accountId 속성 값과 accountDomain 속성 값을 텍스트 편집기에 복사합니다.

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

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

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

여기에서 arcore_c_api.h를 다운로드하여 Android\NDK\libraries\include에 배치합니다.

새로 복제된 리포지토리 내에서 다음 명령을 실행하여 하위 모듈를 초기화합니다.

git submodule update --init --recursive

Android Studio를 엽니다.

Java
NDK

기존 Android Studio 프로젝트 열기를 선택하여 Android/Java/에 있는 프로젝트를 선택합니다.

계정 식별자 및 키 구성

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

Java
NDK

Android/Java/app/src/main/java/com/microsoft/sampleandroid/AzureSpatialAnchorsManager.java을(를) 여십시오.

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

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

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

Android 디바이스에 앱 배포

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

Android Studio 도구 모음에서 실행을 선택합니다.

Android Studio Deploy and Run

배포 대상 선택 대화 상자에서 Android 디바이스를 선택하고 확인을 선택하여 Android 디바이스에서 앱을 실행합니다.

앱의 지침에 따라 앵커를 배치하고 회수합니다.

Android Studio 도구 모음에서 중지를 선택하여 앱을 중지합니다.

Android Studio Stop

리소스 정리

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

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

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

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

다음 단계

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

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