クイック スタート:Azure Spatial Anchors を使用する iOS アプリを Swift または Objective-C で作成するQuickstart: Create an iOS app with Azure Spatial Anchors, in either Swift or Objective-C

このクイック スタートでは、Azure Spatial Anchors を使用する iOS アプリを Swift または Objective-C で作成する方法について説明します。This quickstart covers how to create an iOS app using Azure Spatial Anchors in either Swift or Objective-C. 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. 完了すると、空間アンカーを保存して再呼び出しできる ARKit iOS アプリが作成されます。When you're finished, you'll have an ARKit iOS app that can save and recall a spatial anchor.

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

  • Spatial Anchors アカウントを作成するCreate a Spatial Anchors account
  • Spatial Anchors アカウント識別子とアカウント キーを構成するConfigure the Spatial Anchors account identifier and account key
  • iOS デバイスにデプロイして実行するDeploy and run on an iOS 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:

  • Xcode 10 以降CocoaPods がインストールされている、開発者向けの macOS マシン。A developer enabled macOS machine with Xcode 10+ and CocoaPods installed.
  • HomeBrew を介してインストールされた Git。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.
  • 開発者向けの ARKit 対応 iOS デバイス。A developer enabled ARKit compatible iOS device.

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.

アカウント キー

サンプル プロジェクトを開くOpen the sample project

ターミナルを使用して、以下のアクションを実行します。Use the Terminal to perform the following actions.

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

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

CocoaPods を使用して必要なポッドをインストールします。Install the necessary pods using CocoaPods:

iOS/Swift/ に移動します。Navigate to iOS/Swift/.

cd ./iOS/Swift/

pod install --repo-update を実行して、プロジェクトの CocoaPods をインストールします。Run pod install --repo-update to install the CocoaPods for the project.

Xcode で .xcworkspace を開きます。Now open the .xcworkspace in Xcode.

open ./SampleSwift.xcworkspace

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

次に、自分のアカウント識別子とアカウント キーを使用するようにアプリを構成します。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.

iOS/Swift/SampleSwift/ViewControllers/BaseViewController.swiftを開きます。Open iOS/Swift/SampleSwift/ViewControllers/BaseViewController.swift.

spatialAnchorsAccountKey フィールドを見つけ、Set me をアカウント キーに置き換えます。Locate the spatialAnchorsAccountKey field and replace Set me with the account key.

spatialAnchorsAccountId フィールドを見つけ、Set me をアカウント識別子に置き換えます。Locate the spatialAnchorsAccountId field and replace Set me with the account identifier.

アプリを iOS デバイスにデプロイするDeploy the app to your iOS device

iOS デバイスを Mac に接続し、アクティブ スキームを iOS デバイスに設定します。Connect the iOS device to the Mac and set the active scheme to your iOS device.

デバイスを選択する

[Build and then run the current scheme](ビルドしてから現在のスキームを実行する) を選択します。Select Build and then run the current scheme.

デプロイして実行する

注意

library not found for -lPods-SampleObjC エラーが表示される場合は、.xcworkspace ではなく .xcodeproj ファイルを開いた可能性があります。If you see a library not found for -lPods-SampleObjC error, you likely opened the .xcodeproj file instead of the .xcworkspace. .xcworkspace を開き、もう一度試してください。Open the .xcworkspace and try again.

Xcode で、 [Stop](停止) を押してアプリを停止します。In Xcode, stop the app by pressing Stop.

リソースのクリーンアップ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 Azure portal menu or Home page, select Resource groups, and on the Resource groups page, select myResourceGroup.

[myResourceGroup] ページで、一覧表示されたリソースが、削除しようとするリソースであることを確認します。On the myResourceGroup 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.