Uruchamianie przykładowej aplikacji: Android — Android Studio (Java lub C++/NDK)

W tym przewodniku Szybki start opisano sposób uruchamiania przykładowej aplikacji usługi Azure Spatial Anchors dla urządzeń z systemem Android przy użyciu programu Android Studio (Java lub C++/NDK). Azure Spatial Anchors to usługa dla deweloperów programujących dla wielu platform, która pozwala kreować rozwiązania z rzeczywistością mieszaną z użyciem obiektów, których lokalizacja jest taka sama na różnych urządzeniach mimo upływu czasu. Gdy skończysz, będziesz mieć aplikację ARCore dla systemu Android, która może zapisywać i przywoływać kotwicę przestrzenną.

Dowiesz się, jak:

• Tworzenie konta usługi Spatial Anchors
• Konfigurowanie identyfikatora i klucza konta usługi Spatial Anchors
• Wdrażanie i uruchamianie na urządzeniu z systemem Android

Jeśli nie masz subskrypcji platformy Azure, przed rozpoczęciem utwórz bezpłatne konto platformy Azure.

Wymagania wstępne

Aby ukończyć ten przewodnik Szybki start, upewnij się, że dysponujesz następującymi elementami:

• Komputer z systemem Windows lub macOS z programem Android Studio 3.4 lub nowszym.
  • Jeśli korzystasz z systemu Windows, potrzebujesz również usługi Git dla systemów Windows i Git LFS.
  • Jeśli korzystasz z systemu macOS, pobierz narzędzie Git zainstalowane za pośrednictwem oprogramowania HomeBrew. Wprowadź następujące polecenie w jednym wierszu terminalu: /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)". Następnie uruchom polecenie brew install git i brew install git-lfs.
  • Aby utworzyć przykład NDK, należy również zainstalować zestaw NDK i narzędzia CMake 3.6 lub nowsze w programie Android Studio.
• Urządzenie z systemem Android pracujące w trybie dewelopera i zgodne z platformą ARCore.
  • Aby komputer mógł komunikować się z urządzeniem z systemem Android, może być wymagane dodatkowe sterowniki urządzeń. Zobacz tutaj , aby uzyskać dodatkowe informacje i instrukcje.
• Aplikacja musi być docelowa arcore 1.11.0.

Tworzenie zasobu usługi Spatial Anchors

Portal

Przejdź do portalu Azure Portal.

W okienku po lewej stronie wybierz pozycję Utwórz zasób.

Użyj pola wyszukiwania, aby wyszukać usługi Spatial Anchors.

Wybierz pozycję Zakotwiczenia przestrzenne, a następnie wybierz pozycję Utwórz.

W okienku Konto usługi Spatial Anchors wykonaj następujące czynności:

• Wprowadź unikatową nazwę zasobu przy użyciu zwykłych znaków alfanumerycznych.

• Wybierz subskrypcję, do której chcesz dołączyć zasób.

• Utwórz grupę zasobów, wybierając pozycję Utwórz nową. Nadaj jej nazwę myResourceGroup, a następnie wybierz przycisk OK.

  Grupa zasobów to logiczny kontener, w którym są wdrażane i zarządzane zasoby platformy Azure, takie jak aplikacje internetowe, bazy danych i konta magazynu. Na przykład można później usunąć całą grupę zasobów w jednym prostym kroku.

• Wybierz lokalizację (region), w której ma być umieszczany zasób.

• Wybierz pozycję Utwórz , aby rozpocząć tworzenie zasobu.

Po utworzeniu zasobu witryna Azure Portal pokazuje, że wdrożenie zostało ukończone.

Wybierz pozycję Przejdź do zasobu. Teraz możesz wyświetlić właściwości zasobu.

Skopiuj wartość identyfikatora konta zasobu do edytora tekstów do późniejszego użycia.

Skopiuj również wartość domeny konta zasobu do edytora tekstów do późniejszego użycia.

W obszarze Ustawienia wybierz pozycję Klucz dostępu. Skopiuj wartość Klucza podstawowego, Klucz konta, do edytora tekstów do późniejszego użycia.

Interfejs wiersza polecenia platformy Azure

Rozpocznij od przygotowania środowiska dla interfejsu wiersza polecenia platformy Azure:

• Użyj środowiska powłoki Bash w usłudze Azure Cloud Shell. Aby uzyskać więcej informacji, zobacz Szybki start dotyczący powłoki Bash w usłudze Azure Cloud Shell.

  

• Jeśli wolisz uruchamiać polecenia referencyjne interfejsu wiersza polecenia lokalnie, zainstaluj interfejs wiersza polecenia platformy Azure. Jeśli korzystasz z systemu Windows lub macOS, rozważ uruchomienie interfejsu wiersza polecenia platformy Azure w kontenerze Docker. Aby uzyskać więcej informacji, zobacz Jak uruchomić interfejs wiersza polecenia platformy Azure w kontenerze platformy Docker.

  • Jeśli korzystasz z instalacji lokalnej, zaloguj się do interfejsu wiersza polecenia platformy Azure za pomocą polecenia az login. Aby ukończyć proces uwierzytelniania, wykonaj kroki wyświetlane w terminalu. Aby uzyskać inne opcje logowania, zobacz Logowanie się przy użyciu interfejsu wiersza polecenia platformy Azure.

  • Po wyświetleniu monitu zainstaluj rozszerzenie interfejsu wiersza polecenia platformy Azure podczas pierwszego użycia. Aby uzyskać więcej informacji na temat rozszerzeń, zobacz Korzystanie z rozszerzeń w interfejsie wiersza polecenia platformy Azure.

  • Uruchom polecenie az version, aby znaleźć zainstalowane wersje i biblioteki zależne. Aby uaktualnić do najnowszej wersji, uruchom polecenie az upgrade.

1. Po zalogowaniu użyj polecenia az account set , aby wybrać subskrypcję, w której chcesz skonfigurować konto kotwic przestrzennych:

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

2. Uruchom polecenie az group create, aby utworzyć grupę zasobów lub użyć istniejącej grupy zasobów:

   az group create --name myResourceGroup --location eastus2
   

   Grupa zasobów to logiczny kontener, w którym są wdrażane i zarządzane zasoby platformy Azure, takie jak aplikacje internetowe, bazy danych i konta magazynu. Na przykład można później usunąć całą grupę zasobów w jednym prostym kroku.

   Bieżące konta zakotwiczeń przestrzennych dla grupy zasobów można wyświetlić za pomocą polecenia az spatial-anchors-account list :

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

   Możesz również wyświetlić konta kotwic przestrzennych dla subskrypcji:

   az spatial-anchors-account list
   

3. Uruchom polecenie az spatial-anchors-account create, aby utworzyć konto kotwic przestrzennych:

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

4. Wyświetl właściwości zasobu za pomocą polecenia az spatial-anchors-account show :

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

   Skopiuj wartość identyfikatora konta zasobu i wartość domeny konta zasobu do edytora tekstów do późniejszego użycia.

5. Uruchom polecenie az spatial-anchors-account key show, aby pobrać klucze podstawowe i pomocnicze:

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

   Skopiuj wartości kluczy do edytora tekstów do późniejszego użycia.

   Jeśli musisz ponownie wygenerować klucze, użyj polecenia az spatial-anchors-account 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
   

Konto można usunąć za pomocą polecenia az spatial-anchors-account delete :

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

Azure PowerShell

Rozpocznij od przygotowania środowiska pod kątem programu Azure:

• Jeśli zdecydujesz się używać programu Azure PowerShell lokalnie:
  • Zainstaluj najnowszą wersję modułu Az programu PowerShell.
  • Połącz się z kontem platformy Azure przy użyciu polecenia cmdlet Connect-AzAccount .
• Jeśli zdecydujesz się używać usługi Azure Cloud Shell:
  • Aby uzyskać więcej informacji, zobacz Omówienie usługi Azure Cloud Shell .

Ważne

Chociaż moduł Az.MixedReality programu PowerShell jest w wersji zapoznawczej, należy zainstalować go oddzielnie przy użyciu Install-Module polecenia cmdlet . Gdy ten moduł programu PowerShell stanie się ogólnie dostępny, będzie częścią przyszłych wydań modułu Az programu PowerShell i będzie domyślnie dostępny z poziomu usługi Azure Cloud Shell.

Install-Module -Name Az.MixedReality

1. Po zalogowaniu użyj polecenia cmdlet Set-AzContext , aby wybrać subskrypcję, w której chcesz skonfigurować konto kotwic przestrzennych:

   Set-AzContext -SubscriptionId 00000000-0000-0000-0000-000000000000
   

2. Uruchom polecenie cmdlet New-AzResourceGroup, aby utworzyć grupę zasobów lub użyć istniejącej grupy zasobów:

   New-AzResourceGroup -Name myResourceGroup -Location eastus2
   

   Grupa zasobów to logiczny kontener, w którym są wdrażane i zarządzane zasoby platformy Azure, takie jak aplikacje internetowe, bazy danych i konta magazynu. Na przykład można później usunąć całą grupę zasobów w jednym prostym kroku.

   Bieżące konta kotwic przestrzennych dla grupy zasobów można wyświetlić przy użyciu polecenia cmdlet Get-AzSpatialAnchorsAccount :

   Get-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup
   

   Możesz również wyświetlić konta kotwic przestrzennych dla subskrypcji:

   Get-AzSpatialAnchorsAccount
   

3. Uruchom polecenie cmdlet New-AzSpatialAnchorsAccount, aby utworzyć konto kotwic przestrzennych:

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

4. Wyświetl właściwości zasobu przy użyciu polecenia cmdlet Get-AzSpatialAnchorsAccount :

   Get-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart
   

   Skopiuj wartość accountId właściwości i wartość accountdomain właściwości do edytora tekstów do późniejszego użycia.

5. Uruchom polecenie cmdlet Get-AzSpatialAnchorsAccountKey, aby pobrać klucze podstawowe i pomocnicze:

   Get-AzSpatialAnchorsAccountKey -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart
   

   Skopiuj wartości kluczy do edytora tekstów do późniejszego użycia.

   Jeśli chcesz ponownie wygenerować klucze, użyj polecenia cmdlet New-AzSpatialAnchorsAccountKey :

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

Konto można usunąć przy użyciu polecenia cmdlet Remove-AzSpatialAnchorsAccount :

Remove-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart

Otwieranie przykładowego projektu

Java

Sklonuj repozytorium przykładów, uruchamiając następujące polecenia:

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

NDK

Sklonuj repozytorium przykładów, uruchamiając następujące polecenia:

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

Pobierz arcore_c_api.h z tego miejsca i umieść go w pliku Android\NDK\libraries\include.

Z nowo sklonowanego repozytorium zainicjuj podmoduły, uruchamiając następujące polecenie:

git submodule update --init --recursive

Otwórz program Android Studio.

Java

Wybierz opcję Open an existing Android Studio project (Otwórz istniejący projekt Android Studio) i wybierz projekt znajdujący się w katalogu Android/Java/.

NDK

Wybierz opcję Open an existing Android Studio project (Otwórz istniejący projekt Android Studio) i wybierz projekt znajdujący się w katalogu Android/NDK/.

Konfigurowanie identyfikatora i klucza konta

Następnym krokiem jest skonfigurowanie aplikacji do używania identyfikatora konta i klucza konta. Skopiowano je do edytora tekstów podczas konfigurowania zasobu usługi Spatial Anchors.

Java

Otwórz Android/Java/app/src/main/java/com/microsoft/sampleandroid/AzureSpatialAnchorsManager.java.

Znajdź pole SpatialAnchorsAccountKey i zastąp wartość Set me kluczem konta.

Znajdź pole SpatialAnchorsAccountId i zastąp wartość Set me identyfikatorem konta.

SpatialAnchorsAccountDomain Znajdź pole i zastąp ciąg Set me domeną konta.

NDK

Otwórz Android/NDK/app/src/main/cpp/AzureSpatialAnchorsApplication.cpp.

Znajdź pole SpatialAnchorsAccountKey i zastąp wartość Set me kluczem konta.

Znajdź pole SpatialAnchorsAccountId i zastąp wartość Set me identyfikatorem konta.

SpatialAnchorsAccountDomain Znajdź pole i zastąp ciąg Set me domeną konta.

Wdrażanie aplikacji na urządzeniu z systemem Android

Włącz urządzenie z systemem Android, zaloguj się i połącz to urządzenie z komputerem PC za pomocą kabla USB.

Wybierz polecenie Run (Uruchom) na pasku narzędzi programu Android Studio.

Wybierz urządzenie z systemem Android w oknie dialogowym Select Deployment Target (Wybierz miejsce docelowe wdrożenia), a następnie wybierz przycisk OK, aby uruchomić aplikację na urządzeniu z systemem Android.

Postępuj zgodnie z instrukcjami w aplikacji, aby umieścić i przywołać kotwicę.

Zatrzymaj aplikację, wybierając polecenie Stop (Zatrzymaj) na pasku narzędzi programu Android Studio.

Czyszczenie zasobów

W poprzednich krokach utworzono zasoby platformy Azure w grupie zasobów. Jeśli nie będziesz już potrzebować tych zasobów w przyszłości, możesz je usunąć przez usunięcie grupy zasobów.

W menu witryny Azure Portal lub na stronie głównej wybierz pozycję Grupy zasobów. Następnie na stronie Grupy zasobów wybierz pozycję myResourceGroup.

Na stronie myResourceGroup upewnij się, że wymienione zasoby są tymi, które chcesz usunąć.

Wybierz pozycję Usuń grupę zasobów, wpisz myResourceGroup w polu tekstowym, aby potwierdzić, a następnie wybierz pozycję Usuń.

Następne kroki

W tym przewodniku Szybki start utworzono konto usługi Spatial Anchors. Następnie skonfigurowano i wdrożono aplikację do zapisywania i odwoływania kotwic przestrzennych. Aby dowiedzieć się więcej na temat ulepszania aplikacji w celu udostępniania kotwic przestrzennych innym urządzeniom, przejdź do następnego samouczka.

Samouczek: udostępnianie kotwic przestrzennych między urządzeniami