Table of Contents

iOS アプリで EasyAR 機能を有効にする

この章では、Unity などの 3D エンジンを使用せずに、Xcode で EasyAR の iOS プロジェクトを設定する方法を説明します。

準備

開始する前に、次を準備してください。

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 はカメラを使用するため、プライバシー設定に Privacy - Camera Usage Description を追加する必要があります。

    campermission

    画面録画機能を使用する場合、プライバシー設定に Privacy - Microphone Usage Description を追加する必要があります。

    microphonepermission

Swift API で EasyAR を有効にする

EasyAR Sense Swift API はソースコード形式で提供され、最良の互換性を提供できます（Apple は 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 を参照してください。