iOS での Cloud Anchors のクイックスタート

ARCore Cloud Anchor API（ARCore Cloud Anchor サービス）は、iOS アプリにクラウド アンカー機能を提供するため、 iOS デバイスと Android デバイスのユーザーが AR エクスペリエンスを共有できるようになりました。

このガイドでは、次の方法について説明します。

  • Cloud Anchor と連携するように開発環境を設定する
  • サンプルアプリでアンカーのホストと解決を試す

前提条件

  • Xcode バージョン 13.0 以降
  • Cocoapods を使用している場合: Cocoapods 1.4.0 以降
  • iOS 12.0 以降を搭載した ARKit 対応の Apple デバイス（デプロイ ターゲットが iOS 12.0 以降である必要があります）

Cloud Anchors の使用

次の手順では、Cloud Anchors サンプルアプリを使用して、 ARCore Cloud Anchors をサポートするアプリを構成、構築するためのタスクを実行します。

Cloud Anchors サンプルアプリを入手する

  1. GitHub から ARCore SDK for iOS のクローンを作成するかダウンロードして、サンプルアプリコードを取得します。

  2. ターミナル ウィンドウまたは Finder ウィンドウを開き、SDK をクローン化またはダウンロードしたフォルダに移動します。

  3. サンプルアプリのコードは
    にあります。 /arcore-ios-sdk-master/Examples/CloudAnchorExample。

    永続的な Cloud Anchors のサンプルアプリコードは
    /arcore-ios-sdk-master/Examples/PersistentCloudAnchorExample にあります。

セッションの設定

このサンプルアプリは、環境変数の設定の一環として次の重要なタスクを実行します。 session:

Cloud Anchor ID の共有を設定する

Cloud Anchors サンプルアプリは Firebase を使用して Cloud Anchor ID を できます。実際のアプリでは別のソリューションを使用できます。

サンプルアプリで Firebase データベースを設定するには:

  1. Firebase をアプリに追加する手順に沿って Firebase を追加します。
  2. 追加の一環として生成された GoogleService-Info.plist ファイルをダウンロードします。 Firebase をアプリに追加します。
  3. サンプルの Firebase Storage を有効にします。 <ph type="x-smartling-placeholder">
      </ph>
    • Firebase コンソールに移動し、設定したプロジェクトを選択します サンプルアプリを実行します。
    • [Database] パネルを選択します。
    • [Realtime Database] オプションで [Get Started] をクリックします。
    • Security rules for Realtime Database メニューが開きます。
      • サンプルを実行するには、Start in test mode を選択します。
      • なお、公開予定のアプリに Firebase を使用している場合、 より制限の厳しいセキュリティ・ルールを 使用する必要があります
  4. Xcode で、GoogleService-Info.plist ファイルをアプリの Info.plist の横に追加します。

ARCore API を設定する

Cloud Anchors を使用するには、まずアプリケーションの ARCore API を設定する必要があります。

Pod の更新を実行する

CloudAnchorExample アプリには、必要な ARCore SDK と iOS バージョンが事前構成された Podfile が付属しています。これらの依存関係をインストールするには:

  1. ターミナル ウィンドウを開き、Xcode プロジェクトが存在するフォルダから pod update を実行します。
    これにより、後でアプリのビルドと実行に使用する .xcworkspace ファイルが生成されます。

アプリに ARCore SDK を追加するをご覧ください。 をご覧ください。Podfile

  1. Xcode でプロジェクトの .xcworkspace ファイルを開きます。

    ビルドエラーを回避するには、.xcodeproj ファイルではなく .xcworkspace ファイルからビルドしていることを確認してください。

App Bundle ID を変更する

Xcode でアプリのバンドル ID を変更して、チームでアプリに署名できるようにします。

アプリをビルドして実行する

  1. デバイスを接続して、Xcode でアプリを起動します。

  2. （省略可）サンプルアプリをビルドして実行する場合は、アプリを使用して Cloud Anchor をホストして解決する方法について、次のセクションをご覧ください。

サンプルアプリを試す

  1. .xcworkspace ファイルからサンプルアプリをビルドして実行し、デバイスで起動します。

  2. メッセージが表示されたら、アプリにカメラの権限を付与します。これにより、ARKit はカメラの前面にある平面の検出を開始します。

  3. HOST をタップしてホスティング モードを開始します。ホストされているアンカーを共有するための客室コード 生成されて画面に表示されます。

  4. 平面をタップして、その場所でクラウド アンカーのホストを開始します。

    • Andy Android オブジェクトを平面に配置し、アンカーをアタッチします。 追加できます。
    • ホスト リクエストが ARCore API クラウド エンドポイントに送信されます。ホスト リクエストには、現在の場所に対するアンカーの位置を表す 表示されます。
    • アンカーはホストされると、クラウドの解決に使用される ID を取得します。 使用できます。

  5. RESOLVE をタップして部屋コードを入力し、同じデバイスまたは別のデバイスを使用して、この部屋で以前にホストされた Cloud Anchor にアクセスします。

    • 解決リクエストが ARCore API クラウド エンドポイントに送信されます。
    • 解決リクエストにはクラウド アンカー ID が含まれています。ID が ホスト型アンカーとローカライズが成功すると、サーバーは ローカル座標でアンカーの移動を行います。
    • サンプルアプリでは、変換を使用してアンカーをシーンに追加し、アンカーに接続された仮想オブジェクトをレンダリングします。

アプリに ARCore SDK を追加する

実際のアプリでは、Podfile を更新して、 ARCore SDK とサポートされている iOS バージョニング。手順は次のとおりです。

  1. プロジェクトの Podfile に次の platform と pod を追加します。

        platform :ios, '11.0'
    pod 'ARCore/CloudAnchors', '~> 1.46.0'
  1. ターミナル ウィンドウを開き、Xcode プロジェクトが存在するフォルダから pod update を実行します。
    これにより、アプリのビルドと実行に使用する .xcworkspace ファイルが生成されます。

永続的なクラウド アンカー

永続性のある Cloud Anchor をホストするで説明されているように、クラウド アンカーに最大 365 日の有効期間を設定できます。永続的なクラウド アンカーを使用するサンプルコードは、GitHub の ARCore SDK for iOS の /arcore-ios-sdk-master/Examples/PersistentCloudAnchorExample ディレクトリにあります。

次のステップ