Table of Contents

在 iOS 應用中啟用 EasyAR 功能

本章介紹如何在 Xcode 中配置 EasyAR 的 iOS 工程 ， 而不需使用 Unity 等 3D 引擎。

準備工作

開始之前，您需要準備：

使用 Objective-C 啟用 EasyAR

  1. 新增 Frameworks

    在 Frameworks, Libraries, and Embedded Content 中新增 easyar.xcframework。

    addxframework1

  2. 停用 Bitcode

    EasyAR 不使用 bitcode 也不提供 bitcode 相容性, 需要在配置中停用 bitcode。

    disablebitcode2

  3. 初始化 EasyAR

    使用 easyar_Engine 的 initialize: 方法來初始化 EasyAR 。您可以新增初始化程式碼如下

    [easyar_Engine initialize:key];

  4. 隱私配置

    由於 AR 要使用相機，隱私配置需要新增 隱私 - 相機使用說明，

    campermission

    如果要使用螢幕錄製功能，隱私配置需要新增 隱私 - 麥克風使用說明，

    microphonepermission

透過 Swift API 啟用 EasyAR

EasyAR Sense Swift API 是以原始碼形式提供的，這樣可以提供最好的相容性（蘋果從 Swift 5 開始提供 ABI 相容）。

使用 EasyAR Sense Swift API 需要首先建立一個 framework 工程，然後將 framework target 嵌入到你的工程中。

建立 EasyARSwift framework 工程

  1. 建立一個 Cocoa Touch Framework 類型的新工程並命名為 EasyARSwift

    你可以選擇將 EasyARSwift 工程嵌入到你的 app 工程裡面或建立獨立的工程。

    embedprj

  2. 導入EasyAR Swift 程式碼到 EasyARSwift 工程

    embedswiftcode2

    XCode 自動產生的 EasyARSwift.h 檔案並沒有被使用，可以安全刪除。

  3. 在 build settings 中配置 Objective-C Bridging Header

    bridgeheader

    [!注意] 這個選項在導入 swift 檔案之前不會顯示在 XCode 選項中，所以請一定先導入 Swift 程式碼再進行配置更改。

  4. 導入 easyar.xcframework 到 EasyARSwift 工程中

    addxframework3

  5. 關閉 Bitcode

    EasyAR 不使用 bitcode 也不提供 bitcode 相容性, 需要保證在配置中停用 bitcode。 disablebitcode

  6. Deployment Target

    根據您的 app 工程修改 deployment target，保證 EasyARSwift 工程的 deployment target比 app 工程的小或相等。 setdeploytarget

嵌入和使用 EasyARSwift framework

  1. 在工程中嵌入 EasyARSwift framework

    embedswiftfw embedswiftfw2

  2. 在 Swift 原始碼中 import EasyARSwift

    importeasyswift

程式碼書寫方式可以參考 HelloARSwift 樣例中的程式碼或 API Reference 。