サンプル アプリを実行する: Android - Android Studio (Java または C++/NDK)

このクイックスタートでは、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 で実行する場合は、Git for Windows および Git LFS も必要になります。
  • MacOS で実行する場合は、HomeBrew から Git をインストールします。 /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)" コマンドをターミナルに 1 行で入力します。 続けて、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 ポータルにアクセスします。

左側のウィンドウで、 [リソースの作成] を選択します。

検索ボックスを使用して、「Spatial Anchors」を検索します。

[Spatial Anchors] を選択し、 [作成] を選択します。

[Spatial Anchors アカウント] ウィンドウで次を行います。

• 通常の英数字を使用して一意のリソース名を入力します。

• リソースをアタッチするサブスクリプションを選択します。

• [新規作成] を選択して、リソース グループを作成します。 「myResourceGroup」と名前を付け、 [OK] を選択します。

  リソース グループとは、Web アプリ、データベース、ストレージ アカウントなどの 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 コマンドを使用して、Spatial Anchors アカウントを設定するサブスクリプションを選択します。

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

2. az group create コマンドを実行してリソース グループを作成するか、既存のリソース グループを使用します。

   az group create --name myResourceGroup --location eastus2
   

   リソース グループとは、Web アプリ、データベース、ストレージ アカウントなどの Azure リソースのデプロイと管理に使用する論理コンテナーです。 たとえば、後から簡単な手順で一度にリソース グループ全体を削除することもできます。

   リソース グループの現在の Spatial Anchors アカウントを表示するには、az spatial-anchors-account list コマンドを使用します。

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

   また、ご利用のサブスクリプションの Spatial Anchors アカウントを表示することもできます。

   az spatial-anchors-account list
   

3. Spatial Anchors アカウントを作成するには、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 コマンドレットを使用して、Azure アカウントに接続します。
• Azure Cloud Shell を使用する場合は、次のようにします。
  • 詳細については、Azure Cloud Shell の概要に関するページを参照してください。

重要

Az.MixedReality PowerShell モジュールがプレビュー段階にある間は、Install-Module コマンドレットを使用して、これを別途インストールする必要があります。 この PowerShell モジュールは、一般提供されると、将来の Az PowerShell モジュール リリースに含まれ、既定で Azure Cloud Shell 内から使用できるようになります。

Install-Module -Name Az.MixedReality

1. サインインしたら、Set-AzContext コマンドレットを使用して、Spatial Anchors アカウントを設定するサブスクリプションを選択します。

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

2. New-AzResourceGroup コマンドレットを実行してリソース グループを作成するか、または既存のリソース グループを使用します。

   New-AzResourceGroup -Name myResourceGroup -Location eastus2
   

   リソース グループとは、Web アプリ、データベース、ストレージ アカウントなどの Azure リソースのデプロイと管理に使用する論理コンテナーです。 たとえば、後から簡単な手順で一度にリソース グループ全体を削除することもできます。

   リソース グループの現在の Spatial Anchors アカウントを表示するには、Get-AzSpatialAnchorsAccount コマンドレットを使用します。

   Get-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup
   

   また、ご利用のサブスクリプションの Spatial Anchors アカウントを表示することもできます。

   Get-AzSpatialAnchorsAccount
   

3. New-AzSpatialAnchorsAccount コマンドレットを実行して、Spatial Anchors アカウントを作成します。

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

4. Get-AzSpatialAnchorsAccount コマンドレットを使用してリソースのプロパティを表示します。

   Get-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart
   

   accountId プロパティの値と accountDomain プロパティの値を後で使用するためにテキスト エディターにコピーします。

5. Get-AzSpatialAnchorsAccountKey コマンドレットを実行して、プライマリ キーとセカンダリ キーを取得します。

   Get-AzSpatialAnchorsAccountKey -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart
   

   後で使用するためにキー値をテキスト エディターにコピーします。

   キーを再生成する必要がある場合は、New-AzSpatialAnchorsAccountKey コマンドレットを使用します。

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

アカウントは、Remove-AzSpatialAnchorsAccount コマンドレットを使用して削除できます。

Remove-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart

サンプル プロジェクトを開く

Java

次のコマンドを実行して samples リポジトリを複製します。

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

NDK

次のコマンドを実行して samples リポジトリを複製します。

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

arcore_c_api.h をarcore_c_api.hからダウンロードし、Android\NDK\libraries\include に配置してください。

新しく複製されたリポジトリ内から、次のコマンドを実行して、サブモジュールを初期化します。

git submodule update --init --recursive

Android Studio を起動します。

Java

[Open an existing Android Studio project]\(既存の Android Studio プロジェクトを開く\) を選択し、Android/Java/ にあるプロジェクトを選択します。

NDK

[Open an existing Android Studio project]\(既存の Android Studio プロジェクトを開く\) を選択し、Android/NDK/ にあるプロジェクトを選択します。

アカウント識別子とキーを構成する

次に、自分のアカウント識別子とアカウント キーを使用するようにアプリを構成します。 これらの情報は、Spatial Anchors リソースを設定するときにテキスト エディターにコピーしました。

Java

Android/Java/app/src/main/java/com/microsoft/sampleandroid/AzureSpatialAnchorsManager.javaを開きます。

SpatialAnchorsAccountKey フィールドを見つけ、Set me をアカウント キーに置き換えます。

SpatialAnchorsAccountId フィールドを見つけ、Set me をアカウント識別子に置き換えます。

SpatialAnchorsAccountDomain フィールドを見つけ、Set me をアカウント ドメインに置き換えます。

NDK

Android/NDK/app/src/main/cpp/AzureSpatialAnchorsApplication.cppを開きます。

SpatialAnchorsAccountKey フィールドを見つけ、Set me をアカウント キーに置き換えます。

SpatialAnchorsAccountId フィールドを見つけ、Set me をアカウント識別子に置き換えます。

SpatialAnchorsAccountDomain フィールドを見つけ、Set me をアカウント ドメインに置き換えます。

アプリを Android デバイスに配置する

Android デバイスの電源をオンにしてサインインし、USB ケーブルを使用して PC に接続します。

Android Studio のツール バーから [Run](実行) を選択します。

[Select Deployment Target](配置ターゲットの選択) ダイアログで Android デバイスを選択し、 [OK] を選択して Android デバイス上でアプリを実行します。

アプリの指示に従って、アンカーを配置し、呼び戻します。

Android Studio ツール バーの [Stop](停止) を選択して、アプリを停止します。

リソースをクリーンアップする

前の手順では、リソース グループ内に Azure リソースを作成しました。 これらのリソースが将来必要になると思わない場合は、リソース グループを削除してリソースを削除できます。

Azure portal メニューまたは [ホーム] ページから、 [リソース グループ] を選択します。 次に、 [リソース グループ] ページで [myResourceGroup] を選択します。

[myResourceGroup] ページで、一覧表示されたリソースが、削除しようとするリソースであることを確認します。

[リソース グループの削除] を選択し、確認のためテキスト ボックスに「myResourceGroup」と入力して、 [削除] を選択します。

次のステップ

このクイック スタートでは、Spatial Anchors アカウントを作成しました。 次に、空間アンカーを保存して再呼び出しするようにアプリを構成してデプロイしました。 他のデバイスと空間アンカーを共有できるようにアプリを改良する方法の詳細を学習するには、次のチュートリアルに進んでください。

チュートリアル:デバイス間で Spatial Anchors を共有する