AR Foundation 시작하기

Unity의 AR Foundation은 크로스 플랫폼 프레임워크로, 이를 사용하면 증강 현실 환경을 한 번 작성하고 추가 변경 없이 Android 또는 iOS 기기용으로 빌드할 수 있습니다. 프레임워크는 Unity의 AR Foundation 패키지를 통해 사용할 수 있습니다.

ARCore의 선택사항인 AR Foundation용 ARCore 확장 프로그램 패키지에는 클라우드 앵커, 카메라 구성 필터, 녹화 및 재생과 같은 기능을 앱에 사용할 수 있는 기능이 추가됩니다.

기존 프로젝트 이전 또는 업그레이드

  • 기존 프로젝트를 (지원 중단됨) Unity용 ARCore SDK에서 Unity의 AR FoundationARCore 확장 프로그램(선택사항)으로 이전하려면 이전 가이드를 참고하세요.
  • 이전 버전의 AR Foundation에서 기존 프로젝트를 업그레이드하려면 Unity의 업그레이드 및 이전 가이드를 참고하세요.

요구사항

타겟 플랫폼에 따라 AR Foundation 패키지에는 다음이 필요합니다.

Android

하드웨어

  • ARCore 지원 Android 기기 또는 에뮬레이터
  • 기기를 개발 머신에 연결하는 데 사용하는 USB 케이블

소프트웨어

iOS

하드웨어

소프트웨어

AR Foundation 설치

다음 단계에 따라 AR Foundation Unity 패키지를 설치합니다.

  1. 기존 Unity 프로젝트를 열거나 새 3D 프로젝트를 만듭니다.

  2. Window > Package Manager로 이동합니다.

  3. Packages 옆의 Unity Registry를 선택합니다.

  4. 검색창에 'AR Foundation'을 입력합니다.

  5. Install 아이콘을 클릭합니다.

플랫폼별 플러그인 패키지 설치 및 사용 설정

AR Foundation 패키지는 Unity 개발자가 사용할 인터페이스를 제공하지만 AR 기능 자체를 구현하지는 않습니다. 대상 기기에서 AR Foundation을 사용하려면 별도의 패키지를 설치하고 각 플랫폼에 상응하는 플러그인을 사용 설정해야 합니다.

Android

ARCore XR 플러그인 패키지를 사용하면 Android 기기용 증강 현실 앱을 빌드할 수 있습니다. 애플리케이션이 Android 기기를 타겟팅하는 경우 다음 단계에 따라 Unity 프로젝트에 앱을 설치하세요. AR Foundation 패키지와 동일한 버전을 사용하여 호환성 문제를 방지합니다.

  1. 프로젝트에서 Window > Package Manager로 이동합니다.

  2. Packages 옆의 Unity Registry를 선택합니다.

  3. 검색창에 'ARCore XR 플러그인'을 입력합니다.

  4. Install 아이콘을 클릭합니다.

  5. Edit > Project Settings로 이동합니다. XR Plug-in Management에서 Android 탭을 열고 ARCore를 사용 설정합니다.

iOS

ARKit XR 플러그인을 사용하면 iOS 기기용 증강 현실 앱을 빌드할 수 있습니다. 애플리케이션이 iOS 기기를 타겟팅하는 경우 다음 단계에 따라 Unity 프로젝트에 설치합니다. AR Foundation 패키지와 동일한 버전을 사용하여 호환성 문제를 방지하세요.

  1. 프로젝트에서 Window > Package Manager로 이동합니다.

  2. Packages 옆의 Unity Registry를 선택합니다.

  3. 검색창에 'ARKit XR 플러그인'을 입력합니다.

  4. Install 아이콘을 클릭합니다.

  5. Edit > Project Settings로 이동합니다. XR Plug-in Management에서 iOS 탭을 열고 ARKit를 사용 설정합니다.

AR 세션을 구성하고 장면에 AR Foundation 구성요소를 추가하세요.

모션 추적, 환경 이해, 조명 추정과 같은 AR 프로세스를 사용 설정하려면 장면에 AR 세션이 필요합니다. AR 세션을 지원하려면 다음 게임 객체가 필요합니다.

AR Foundation 4.x

  • AR Session: AR 환경의 수명 주기를 제어합니다.

  • AR Session Origin: AR 좌표를 Unity 세계 좌표로 변환합니다.

새 게임 객체를 추가하기 전에 기본 Main Camera를 삭제합니다. 이는 AR Session Origin에서 새로운 AR Camera로 대체됩니다.

Hierarchy 창을 마우스 오른쪽 버튼으로 클릭하고 XR을 선택하여 새 AR 게임 객체를 장면에 추가합니다. 새 AR Session 및 새 AR Session Origin 게임 객체를 추가합니다.

AR Foundation 5.x

  • AR Session: AR 환경의 수명 주기를 제어합니다.

  • XR Origin: AR 좌표를 Unity 세계 좌표로 변환합니다.

새 게임 객체를 추가하기 전에 기본 Main Camera를 삭제합니다. 이는 XR Origin에서 새로운 AR Camera로 대체됩니다.

Hierarchy 창을 마우스 오른쪽 버튼으로 클릭하고 XR을 선택하여 새 AR 게임 객체를 장면에 추가합니다. 새 AR Session 및 새 XR Origin 게임 객체를 추가합니다.

플레이어 설정 구성

Android

  1. File > Build Settings로 이동하여 Build Settings 창을 엽니다.
  2. Platform 아래에서 Android를 선택하고 Switch Platform를 클릭합니다.
  3. Player Settings 아이콘을 클릭합니다.
  4. 다음 변경사항을 적용합니다.

    Player Settings > …
    Other Settings > Rendering Auto Graphics API을 선택 해제합니다.
    VulkanGraphics APIs 아래에 표시되면 ARCore에서 Vulkan을 아직 지원하지 않으므로 삭제합니다.
    Other Settings > Package Name 자바 패키지 이름 형식을 사용하여 고유한 앱 ID를 만드세요.
    예를 들어 com.example.helloAR을(를) 사용하세요.
    Other Settings > Minimum API Level AR 필수 앱을 빌드 중인 경우 Android 7.0 'Nougat' (API Level 24) or higher를 지정합니다.
    AR Optional 앱을 빌드하는 경우 Android API Level 19 or higher를 지정합니다.
    Other Settings > Scripting Backend 다음 단계에서 ARM64 지원을 사용 설정할 수 있도록 Mono 대신 IL2CPP를 선택합니다.

    개발 중:

    • Mono + 32비트 (ARMv7) 사용
    • FAT (32비트 + 64비트) ARCore APK 설치

    Play 스토어로 배송하는 경우

    • IL2CPP 사용
    • Play 스토어 64비트 요구사항을 충족하려면 32비트 (ARMv7) 및 64비트 (ARM64)를 모두 사용 설정하세요.
    • 선택사항 (2018.3 이상에서 지원됨): Build Settings에서 Android App Bundles를 사용 설정합니다.
    Other Settings > Target Architectures Google Play 64비트 요구사항을 충족하려면 ARM64 (64비트 ARM)를 사용 설정합니다. 32비트 기기를 지원하도록 ARMv7 (32비트 ARM)을 사용 설정된 상태로 둡니다.

iOS

  1. File > Build Settings로 이동하여 Build Settings 창을 엽니다.
  2. Platform 아래에서 iOS를 선택하고 Switch Platform를 클릭합니다.
  3. Player Settings 아이콘을 클릭합니다.
  4. 다음 설정을 구성합니다.

    Player Settings > …
    Other Settings > Bundle Identifier 역방향 DNS 형식으로 앱 이름을 추가합니다.
    예를 들어 com.mycompany.myapp을 사용합니다.
    Other Settings > Camera usage description AR 사용에 관한 설명 (예: ARKit)을 입력하세요.
    Other Settings > Target minimum iOS version 11.0 및 이후 버전
    Other Settings > Architecture ARM64

다음 단계