本指南將說明如何:
- 設定與擴增臉孔搭配使用的開發環境
- 套用 2D 紋理,並將 3D 物件附加至偵測到的表面
必要條件
- Xcode 13.0 以上版本
- Cocoapods 1.4.0 以上版本 (如果使用 Cocoapods)
- 搭載 iOS 12.0 以上版本的 ARKit 相容 Apple 裝置 (需要 iOS 12.0 以上版本的部署目標)
使用擴增臉孔功能
下列步驟使用擴增臉孔範例應用程式,說明設定及建構具有擴增臉孔功能應用程式的重要工作。
取得擴增 Faces 範例應用程式
- 從 GitHub 複製或下載最新的 iOS 版 ARCore SDK,取得範例應用程式的程式碼。
- 開啟終端機或 Finder 視窗,然後前往您複製或下載 SDK 的資料夾。
- 您可以在
/Examples/AugmentedFacesExample
中找到範例應用程式程式碼。
執行 pod install
AugmentedFacesSample 應用程式隨附的 Podfile 已預先設定您需要的 ARCore SDK 和 iOS 版本。如要安裝這些依附元件:
- 開啟終端機視窗,然後從 Xcode 專案所在的資料夾執行
pod install
。這樣做會產生*.xcworkspace
檔案,稍後您將用來建構及執行應用程式。
建立應用程式並加以執行
- 在 Xcode 中開啟專案的
.xcworkspace
(而非.xcodeproj
) 檔案。 - 開啟目標的一般設定並變更軟體包 ID。
- 按下 Cmd+R 鍵或按一下「執行」。搭配實體裝置 (而非模擬器) 使用擴增臉孔功能。裝置應透過 USB 連接至開發機器。
試用範例應用程式
- 從
.xcworkspace
檔案建構並執行範例應用程式,以便在裝置上啟動應用程式。 - 如果系統顯示提示,請將相機權限授予應用程式。然後,ARCore 就會開始偵測相機中顯示的臉孔。目前一次只能偵測到一次臉孔。
- 確認攝影機是面向使用者。
後續步驟
- 請參閱 iOS 適用的擴增臉孔開發人員指南,探索範例應用程式的程式碼,並進一步瞭解如何在自己的應用程式中使用擴增臉孔功能。
- 參閱 ARCore iOS API 參考資料。
- 請觀看以下影片,瞭解如何在 iOS 裝置上開始使用擴增臉孔功能: