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

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

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

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

前提条件

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

Cloud Anchors の使用

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

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

  1. GitHub から iOS 向け ARCore SDK のクローンを作成するかダウンロードします。 サンプルアプリのコードを入手します。

  2. ターミナルまたは Finder ウィンドウを開き、クローンを作成したフォルダに移動します。 ダウンロードするかを選択します

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

    Persistent Cloud Anchors サンプルアプリのコードは、次のとおりです。 （
    内） /arcore-ios-sdk-master/Examples/PersistentCloudAnchorExample。

セッションの設定

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

Cloud Anchor ID の共有を設定する

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

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

  1. アプリに 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 アプリには Podfile が事前構成されており、 必要なバージョン（ARCore SDK と iOS のバージョン）が必要です。これらの依存関係をインストールするには:

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

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

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

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

App Bundle ID を変更する

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

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

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

  2. （省略可）サンプルアプリをビルドして実行する場合は、以下をご覧ください。 セクションをご覧ください。

サンプルアプリを試す

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

  2. プロンプトが表示されたら、アプリにカメラへのアクセスを許可します。ARKit、その後 カメラの前に写った飛行機が検知されるようになります。

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

  4. 飛行機をタップすると、そこにクラウド アンカーが設置されます。

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

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

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

アプリに ARCore SDK を追加する

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

  1. 次の platform と pod を プロジェクトの Podfile:

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

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

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

次のステップ