クイック スタート:Azure Spatial Anchors を使用して Unity Android アプリを作成するQuickstart: Create a Unity Android app with Azure Spatial Anchors

このクイック スタートでは、Azure Spatial Anchors を使用して Unity Android アプリを作成する方法について説明します。This quickstart covers how to create a Unity Android app using Azure Spatial Anchors. Azure Spatial Anchors は、クロスプラットフォーム対応の開発者向けサービスです。このサービスを使用すると、時間が経過した後でも複数のデバイス間で位置情報を保持するオブジェクトを使用して複合現実エクスペリエンスを作成できます。Azure Spatial Anchors is a cross-platform developer service that allows you to create mixed reality experiences using objects that persist their location across devices over time. 完了すると、Unity でビルドされた、空間アンカーを保存して呼び戻すことができる ARCore Android アプリが作成されます。When you're finished, you'll have an ARCore Android app built with Unity that can save and recall a spatial anchor.

学習内容は次のとおりです。You'll learn how to:

  • Spatial Anchors アカウントを作成するCreate a Spatial Anchors account
  • Unity のビルド設定を準備するPrepare Unity build settings
  • ARCore SDK for Unity をダウンロードしてインポートするDownload and import the ARCore SDK for Unity
  • Spatial Anchors アカウント識別子とアカウント キーを構成するConfigure the Spatial Anchors account identifier and account key
  • Android Studio プロジェクトをエクスポートするExport the Android Studio project
  • Android デバイスに配置して実行するDeploy and run on an Android device

Azure サブスクリプションをお持ちでない場合は、開始する前に無料アカウントを作成してください。If you don't have an Azure subscription, create a free account before you begin.

前提条件Prerequisites

このクイック スタートを実行するには、以下が必要です。To complete this quickstart, make sure you have:

  • Unity 2018.3 以降および Android Studio 3.3 以降がインストールされている Windows または macOS コンピューター。A Windows or macOS machine with Unity 2018.3+ and Android Studio 3.3+.
    • Windows で実行する場合は、Git for Windows も必要になります。If running on Windows, you'll also need Git for Windows.
    • MacOS で実行する場合は、HomeBrew から Git をインストールします。If running on macOS, get Git installed via HomeBrew. /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)" コマンドをターミナルに 1 行で入力します。Enter the following command into a single line of the Terminal: /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)". 次に、brew install git を実行します。Then, run brew install git.
  • 開発者向けARCore 対応 Android デバイス。A developer enabled and ARCore capable Android device.
  • アプリでは Unity 用 ARCore SDK のバージョン 1.7 を使用する必要があります。Your app must use version 1.7 of the ARCore SDK for Unity.

Spatial Anchors リソースを作成するCreate a Spatial Anchors resource

Azure ポータルにアクセスします。Go to the Azure portal.

Azure portal の左側のナビゲーション ウィンドウで、 [リソースの作成] を選択します。In the left navigation pane in the Azure portal, select Create a resource.

検索ボックスを使用して、「Spatial Anchors」を検索します。Use the search box to search for Spatial Anchors.

Spatial Anchors の検索

[Spatial Anchors] を選択します。Select Spatial Anchors. ダイアログ ボックスで [作成] を選択します。In the dialog box, select Create.

[Spatial Anchors アカウント] ダイアログ ボックスで以下を行います。In the Spatial Anchors Account dialog box:

  • 通常の英数字を使用して、一意のリソース名を入力します。Enter a unique resource name, using regular alphanumeric characters.

  • リソースをアタッチするサブスクリプションを選択します。Select the subscription that you want to attach the resource to.

  • [新規作成] を選択して、リソース グループを作成します。Create a resource group by selecting Create new. myResourceGroup」と名前を付け、 [OK] を選択します。Name it myResourceGroup and select OK. リソース グループとは、Web アプリ、データベース、ストレージ アカウントなどの Azure リソースのデプロイと管理に使用する論理コンテナーです。A resource group is a logical container into which Azure resources like web apps, databases, and storage accounts are deployed and managed. たとえば、後から簡単な手順で一度にリソース グループ全体を削除することもできます。For example, you can choose to delete the entire resource group in one simple step later.

  • リソースを配置する場所 (リージョン) を選択します。Select a location (region) in which to place the resource.

  • [新規] を選択して、リソースの作成を開始します。Select New to begin creating the resource.

    リソースの作成

リソースが作成されると、Azure portal に、デプロイが完了したことが表示されます。After the resource is created, Azure Portal will show that your deployment is complete. [リソースに移動] をクリックします。Click Go to resource.

デプロイ完了

これで、リソースのプロパティを確認できます。Then, you can view the resource properties. リソースの [アカウント ID] 値は、後で必要になるため、テキスト エディターにコピーしておきます。Copy the resource's Account ID value into a text editor because you'll need it later.

リソースのプロパティ

[設定][キー] を選択します。Under Settings, select Key. [主キー] の値をテキスト エディターにコピーします。Copy the Primary key value into a text editor. この値は Account Key ですThis value is the Account Key. この情報は後で必要になります。You'll need it later.

アカウント キー

Unity のサンプル プロジェクトをダウンロードして開くDownload and open the Unity sample project

次のコマンドを実行して samples リポジトリを複製します。Clone the samples repository by running the following command:

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

Unity で、Unity フォルダー内のプロジェクトを開きます。In Unity, open the project in the Unity folder. Unity により、プロジェクトと、コンピューターにインストールしたものとの間の Unity バージョンの相違について聞かれる場合があります。Unity might prompt you about a different Unity version between the project and the one you've installed on your machine. この警告は、Unity エディターのバージョンが、プロジェクトの作成に使用されたバージョンより新しければ、特に問題ありません。This warning is okay, as long as your version of Unity Editor is newer than the one the project was created with. この場合、 [続行] をクリックします。In that case, just click Continue. Unity エディターのバージョンがプロジェクトに必要なバージョンよりも古い場合は、 [終了] をクリックして、Unity エディターをアップグレードします。If your Unity Editor version is older than the one the project needs, click Quit, and upgrade your Unity Editor.

Unity ウィンドウ

[ファイル] > [ビルド設定] を選択して、 [ビルド設定] を開きます。Open Build Settings by selecting File > Build Settings.

[プラットフォーム] セクションで、 [Android] を選択します。In the Platform section, select Android. [ビルド システム][Gradle] に変更し、 [プロジェクトの変更] チェックボックスがオンになっていないことを確認します。Change the Build System to Gradle and ensure the Export Project checkbox doesn't have a check mark.

[Switch Platform](プラットフォームの切り替え) を選択して、プラットフォームを [Android] に変更します。Select Switch Platform to change the platform to Android. Android をサポートするコンポーネントが不足している場合は、Unity によってそれらをインストールすることを要求される場合があります。Unity might prompt you to install Android support components if they're missing.

Unity の [Build Settings](ビルド設定) ウィンドウ

[ビルド設定] ウィンドウを閉じます。Close the Build Settings window.

Unity 用 ARCore SDK をダウンロードしてインポートするDownload and import the ARCore SDK for Unity

Unity 用 ARCore SDK 1.7 リリースから unitypackage ファイルをダウンロードします。Download the unitypackage file from the ARCore SDK for Unity 1.7 releases. Unity プロジェクトに戻り、 [資産] > [パッケージのインポート] > [カスタム パッケージ] を選択した後、先ほどダウンロードした unitypackage ファイルを選択します。Back in the Unity project, select Assets > Import Package > Custom Package and then select the unitypackage file you previously downloaded. [Unity パッケージのインポート] ダイアログ ボックスで、すべてのファイルが選択されていることを確認し、 [インポート] を選択します。In the Import Unity Package dialog box, make sure all files are selected and then select Import.

アカウント識別子とキーを構成するConfigure account identifier and key

[Project](プロジェクト) ウィンドウで Assets/AzureSpatialAnchorsPlugin/Examples に移動し、シーン ファイル AzureSpatialAnchorsBasicDemo.unity を開きます。In the Project pane, navigate to Assets/AzureSpatialAnchorsPlugin/Examples and open the AzureSpatialAnchorsBasicDemo.unity scene file.

次に、自分のアカウント識別子とアカウント キーを使用するようにアプリを構成します。The next step is to configure the app to use your account identifier and account key. これらの情報は、Spatial Anchors リソースを設定するときにテキスト エディターにコピーしました。You copied them into a text editor when setting up the Spatial Anchors resource.

[Project](プロジェクト) ウィンドウで Assets\AzureSpatialAnchorsPlugin\Examples\Resources に移動します。In the Project pane, navigate to Assets\AzureSpatialAnchorsPlugin\Examples\Resources. [AzureSpatialAnchorsDemoConfig] を選択します。Select AzureSpatialAnchorsDemoConfig. 次に、 [Inspector] ウィンドウで、Spatial Anchors Account Key の値として Account Key を、Spatial Anchors Account Id の値として Account ID を入力します。Then, in the Inspector pane, enter the Account Key as the value for Spatial Anchors Account Key and the Account ID as the value for Spatial Anchors Account Id.

[File](ファイル) -> [Save](保存) の順に選択してシーンを保存します。Save the scene by selecting File -> Save.

Android Studio プロジェクトをエクスポートするExport the Android Studio project

[ファイル] > [ビルド設定] を選択して、 [ビルド設定] を開きます。Open Build Settings by selecting File > Build Settings.

[Scenes In Build](ビルド内のシーン) の下で、すべてのシーンの横にチェック マークが付いていることを確認します。Under Scenes In Build, ensure all the scenes have a check mark next to them.

[Export Project](プロジェクトのエクスポート) チェック ボックスがオフになっていることを確認してください。Ensure the Export Project checkbox does not have a check mark. [Build And Run](ビルドして実行) をクリックします。Click Build And Run. .apk ファイルを保存するよう求められたら、任意の名前を選択できます。You'll be asked to save your .apk file, you can pick any name for it.

アプリの指示に従って、アンカーを配置し、呼び戻します。Follow the instructions in the app to place and recall an anchor.

注意

アプリを実行したとき、背景としてカメラが表示されない場合は (たとえば、代わりに空白、青、または他のテクスチャが表示される場合)、Unity に資産を再インポートすることが必要な場合があります。When running the app, if you don't see the camera as the background (for instance you instead see a blank, blue or other textures) then you likely need to re-import assets in Unity. アプリを停止します。Stop the app. Unity の上部のメニューで、 [Assets](資産) -> [Reimport all](すべて再インポート) を選択します。From the top menu in Unity, choose Assets -> Reimport all. その後、アプリをもう一度実行します。Then, run the app again.

リソースのクリーンアップClean up resources

前の手順では、リソース グループ内に Azure リソースを作成しました。In the preceding steps, you created Azure resources in a resource group. これらのリソースが将来必要になると思わない場合は、リソース グループを削除してリソースを削除できます。If you don't expect to need these resources in the future, you can delete them by deleting the resource group.

Azure Portal の左側のメニューで、 [リソース グループ][myResourceGroup] の順に選択します。From the left menu in the Azure portal, select Resource groups and then select myResourceGroup.

リソース グループのページで、一覧表示されたリソースが、削除しようとするリソースであることを確認します。On the resource group page, make sure that the listed resources are the ones you want to delete.

[削除] を選択し、テキスト ボックスに「myResourceGroup」と入力してから、 [削除] を選択します。Select Delete, type myResourceGroup in the text box, and then select Delete.

次の手順Next steps

このクイック スタートでは、Spatial Anchors アカウントを作成しました。In this quickstart, you created a Spatial Anchors account. 次に、空間アンカーを保存して再呼び出しするようにアプリを構成してデプロイしました。You then configured and deployed an app to save and recall spatial anchors. 他のデバイスと空間アンカーを共有できるようにアプリを改良する方法の詳細を学習するには、次のチュートリアルに進んでください。To learn more about how to improve the app so it can share spatial anchors with other devices, continue to the next tutorial.