Table of Contents

EasyAR 기능을 iOS 앱에서 활성화하기

이 장에서는 Unity와 같은 3D 엔진을 사용하지 않고 Xcode에서 EasyAR의 iOS 프로젝트를 설정하는 방법을 설명합니다.

준비 작업

시작하기 전에 다음을 준비해야 합니다:

Objective-C로 EasyAR 활성화하기

  1. 프레임워크 추가

    Frameworks, Libraries, and Embedded Content에 easyar.xcframework를 추가합니다.

    addxframework1

  2. Bitcode 비활성화

    EasyAR은 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 타겟을 당신의 프로젝트에 임베드해야 합니다.

EasyARSwift framework 프로젝트 생성

  1. EasyARSwift라는 이름으로 Cocoa Touch Framework 유형의 새 프로젝트를 생성합니다.

    EasyARSwift 프로젝트를 당신의 앱 프로젝트 내에 임베드하거나 별도의 프로젝트로 생성할 수 있습니다.

    embedprj

  2. EasyARSwift 프로젝트에 EasyAR Swift 코드 임포트

    embedswiftcode2

    XCode에서 자동 생성된 EasyARSwift.h 파일은 사용되지 않으므로 안전하게 삭제할 수 있습니다.

  3. 빌드 설정에서 Objective-C Bridging Header 구성

    bridgeheader

    참고

    이 옵션은 Swift 파일을 임포트하기 전에는 XCode 옵션에 표시되지 않으므로, Swift 코드를 먼저 임포트한 후 설정을 변경해야 합니다.

  4. EasyARSwift 프로젝트에 easyar.xcframework 임포트

    addxframework3

  5. Bitcode 비활성화

    EasyAR은 bitcode를 사용하지 않으며 호환성도 제공하지 않으므로, 설정에서 bitcode를 비활성화해야 합니다. disablebitcode

  6. 배포 타겟(Deployment Target)

    앱 프로젝트에 따라 deployment target을 수정하여, EasyARSwift 프로젝트의 deployment target이 앱 프로젝트의 것보다 작거나 같도록 보장합니다. setdeploytarget

EasyARSwift framework 임베드 및 사용

  1. 프로젝트에 EasyARSwift framework 임베드

    embedswiftfw embedswiftfw2

  2. Swift 소스 코드에서 import EasyARSwift

    importeasyswift

코드 작성 방식은 HelloARSwift 샘플의 코드나 API Reference를 참조할 수 있습니다.