iOS 中的 Cloud Anchor 快速入門導覽課程

ARCore Cloud Anchor API (或 ARCore Cloud Anchor 服務) 可為 iOS 應用程式提供雲端錨點功能，讓 iOS 應用程式更加完善 讓 iOS 和 Android 裝置的使用者分享 AR 體驗。

本指南說明如何：

  • 設定使用 Cloud Anchors 的開發環境
  • 嘗試在範例應用程式中託管和解析錨點

必要條件

  • Xcode 13.0 以上版本
  • Cocoapods 1.4.0 以上版本 (如果使用 Cocoapods)
  • 與 ARKit 相容的 Apple 裝置 (搭載 iOS 12.0 以上版本) (需要部署目標為 iOS 12.0 以上版本)
，瞭解如何調查及移除這項存取權。

使用 Cloud Anchors

下列步驟使用 Cloud Anchors 範例應用程式來顯示 任務，用於設定及建構支援 ARCore Cloud Anchors 的應用程式。

取得 Cloud Anchors 範例應用程式

  1. 複製或從 GitHub 下載 iOS 版 ARCore SDK 取得範例應用程式的程式碼

  2. 開啟「Terminal」或「Finder」視窗，然後前往您複製的資料夾 或是下載 SDK

  3. 您可以在
    中找到範例應用程式的程式碼 /arcore-ios-sdk-master/Examples/CloudAnchorExample。

    永久雲端錨點範例應用程式的程式碼為 在
    /arcore-ios-sdk-master/Examples/PersistentCloudAnchorExample。

工作階段設定

範例應用程式會在設定 工作階段：

設定 Cloud Anchor ID 共用功能

Cloud Anchors 範例應用程式會使用 Firebase，在以下兩個位置共用 Cloud Anchor ID： 裝置。您可以在自己的應用程式中使用其他解決方案。

如要在範例應用程式中設定 Firebase 資料庫，請按照下列步驟操作：

  1. 按照 Firebase 操作說明，在應用程式中新增 Firebase。
  2. 下載系統在新增時產生的 GoogleService-Info.plist 檔案 由 Firebase 導入您的應用程式。
  3. 為範例啟用 Firebase 儲存空間：
    • 前往 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 檔案

變更應用程式套件 ID

在 Xcode 中變更應用程式的軟體包 ID，以便與您的團隊簽署應用程式。

建立應用程式並加以執行

  1. 連結裝置，然後在 Xcode 中啟動應用程式。

  2. (選用) 如果您要建構並執行範例應用程式，請參閱以下資源 一節，進一步瞭解如何使用應用程式託管及解析 Cloud Anchor。

試用範例應用程式

  1. 透過 .xcworkspace 檔案建構並執行範例應用程式，以便啟動 在您的裝置上。

  2. 如果出現提示，請將相機權限授予應用程式。然後 ARKit 然後 從攝影機前開始偵測飛機

  3. 輕觸 HOST 即可進入託管模式。分享代管錨定廣告的會議室代碼 。

  4. 輕觸飛機即可開始代管雲端錨點。

    • 應用程式將 Andy Android 物件放到平面上，並附加錨點 先前提過 執行個體對於分配到的外部 IP 位址一無所知
    • 主機要求會傳送至 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」所述， 則最多能保留 365 天的雲端錨點存留時間以下應用程式的程式碼範例： 使用永久雲端錨點的/arcore-ios-sdk-master/Examples/PersistentCloudAnchorExample功能 從 GitHub 下載 iOS 版 ARCore SDK 的目錄。

後續步驟