在 iOS 專案中啟用 ARCore。
必要條件
ARCore 需要 11.0 或更高的部署目標。
安裝 iOS 版 ARCore SDK
您必須使用 iOS SDK 15.0 或更新版本建構應用程式。您可以使用 CocoaPods 或 Swift Package Manager (目前為 Beta 版) 安裝 SDK。
使用 CocoaPods
在 Podfile
中指定 iOS 版 ARCore SDK,以便整合至您的 Xcode 專案:
target 'YOUR_APPLICATION_TARGET_NAME_HERE'
platform :ios, '11.0'
pod 'ARCore/SUBSPEC_NAME_HERE' ~> VERSION_HERE
Geospatial API 適用的 Geospatial
是有效的 ARCore 子規格,Cloud Anchor API 則是 CloudAnchors
,擴增臉孔則是 AugmentedFaces
。
執行下列指令進行安裝:
$ pod install
使用 Swift Package Manager
從 1.36.0 版本開始,ARCore 正式支援透過 Swift Package Manager 進行安裝:
- 依序前往 [File] > [Add Packages],然後輸入套件網址:
https://github.com/google-ar/arcore-ios-sdk
- 將「Dependency Rule」(依附元件) 設為 [Up to Next Minor Version] (最高至下一個次要版本),然後選取最新版本的 ARCore。
- 選取要納入的 ARCore 程式庫。您也可以稍後再透過建構階段 > 連結程式庫與程式庫新增程式庫。
- 將
-ObjC
標記新增至「Other Linker Flags」。建議您將「其他連結器標記」設為$(inherited) -ObjC
。 - 確認「Enable Modules」和「Link FrameworkAutomatically」建構設定已設為「Yes」,因為 ARCore 需要自動連結。
- 確認 Enable Bitcode 已設為 No,因為 ARCore 二進位檔不包含位元碼。
建立 Google Cloud 專案並啟用 ARCore API
您必須先在新的或現有的 Google Cloud Platform 專案中啟用 ARCore API,才能開始使用 ARCore Cloud Anchor API 或 ARCore Geospatial API。
您必須在 Google Cloud 專案中啟用 ARCore API。如果您需要建立專案,請執行下列步驟:
輸入適當的「專案名稱」,並選擇專案的位置。
按一下「建立」。
搜尋並選取 ARCore API,然後按一下 [啟用]。
遵守使用者隱私權規定
確認您的應用程式符合 ARCore 使用者隱私權規定。
後續步驟
- 瞭解如何在 iOS 中設定 ARCore 工作階段。
- 參閱 iOS 參考說明文件。