AR Foundation용 ARCore 확장 프로그램 시작하기

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

요구사양

AR Foundation용 ARCore 확장 프로그램으로 개발하려면 다음이 필요합니다.

Android

하드웨어

  • ARCore 지원 Android 기기
  • 기기를 개발 머신에 연결하기 위한 USB 케이블

소프트웨어

iOS

하드웨어

소프트웨어

ARCore 확장 프로그램 패키지 설치

다음 단계를 따라 AR Foundation용 ARCore 확장 프로그램을 설치합니다.

번들 종속 항목

  1. 개발 환경에 AR Foundation이 설치 및 구성되어 있는지 확인합니다.
  2. 새 Unity 프로젝트를 열거나 만듭니다.
  3. 원하는 타겟 빌드 플랫폼을 선택합니다.
    1. File 메뉴에서 Build Settings을 선택합니다.
    2. 원하는 타겟 플랫폼에 따라 Android 또는 iOS를 선택합니다.
    3. Switch Platform를 클릭합니다.
  4. 최신 ARCore 확장 프로그램 패키지를 가져옵니다.

    1. Window > Package Manager로 이동합니다.
    2. 버튼을 클릭하고 드롭다운 메뉴에서 Add package from git URL... 옵션을 선택합니다.

    1. 텍스트 입력란에 다음 URL을 붙여넣습니다.
    https://github.com/google-ar/arcore-unity-extensions.git
    
    1. Add를 클릭합니다.

EDM4U 제외

기본적으로 ARCore 확장 프로그램은 추가 종속 항목과 함께 번들로 제공됩니다. 다른 버전의 Unity용 외부 종속 항목 관리자에 종속되는 다른 라이브러리 (예: Firebase Analytics)를 사용하는 경우 정의되지 않은 동작이 발생하여 종속 항목이 올바르게 작동하지 않을 수 있습니다.

번들 버전 종속 항목이 없는 ARCore 확장 프로그램을 설치하여 라이브러리 버전 관리 충돌을 방지합니다.

  1. EDM4U 출시가 없는 ARCore 확장 프로그램com.google.external-dependency-manager를 다운로드합니다.
  2. .tgz 파일로 UPM 패키지 가져오기의 안내를 따라 다음 순서로 패키지를 설치합니다.
    1. com.google.external-dependency-manager
    2. ARCore 확장 프로그램 (EDM4U 제외)

ARCore Extensions을 설치하면 Unity는 필요한 종속 항목의 적절한 버전도 자동으로 설치합니다.

  • AR Foundation
  • ARCore XR Plugin(Android를 타겟팅할 때 사용)
  • ARKit XR Plugin (iOS를 타겟팅할 때 사용)

이러한 종속 항목은 Package Manager > Package: In project 뷰에 표시되지 않을 수 있습니다. 그러나 패키지는 Project 창의 Packages 아래 표시될 수 있습니다.

ARCore 확장 프로그램 설정

  1. Hierarchy 창에서 다음 게임 객체를 마우스 오른쪽 버튼으로 클릭하고 추가합니다 (아직 추가되지 않은 경우).

    • XR > AR Session
    • XR > AR Session Origin
    • XR > ARCore Extensions
  2. Hierarchy 창에서 ARCore Extensions 패키지를 선택합니다.

  3. Inspector 창에서 다음 각 필드에 대해 대상 버튼을 클릭하고 다음과 같이 각 필드를 해당 게임 객체와 연결합니다.

    • Session: 장면의 AR Session를 사용합니다.
    • Session Origin: 장면의 AR Session Origin를 사용합니다.
    • Camera Manager: 장면의 AR Camera를 사용합니다.
  4. 원하는 경우 클라우드 앵커 및 카메라 구성 필터에 대해 다음 애셋을 만들고 연결합니다.

    1. Project > Assets 창에서 마우스 오른쪽 버튼을 클릭하고 Create > XR > ARCore Extensions Config을 선택합니다.

    2. Project > Assets 창에서 마우스 오른쪽 버튼을 클릭하고 Create > XR > Camera Config Filter을 선택합니다.

    3. Hierarchy 창에서 ARCore Extensions 패키지를 선택합니다.

    4. Inspector 창의 ARCore Extensions Config 필드에서 타겟 버튼을 클릭하고 ARCoreExtensionsConfig 애셋에 연결합니다.

    5. Inspector 창의 Camera Config Filter 필드에서 타겟 버튼을 클릭하고 ARCoreExtensionsCameraConfigFilter 애셋에 연결합니다.

      자세한 내용은 Android 또는 iOS용 Unity (AR Foundation) 클라우드 앵커 개발자 가이드와 카메라 구성 가이드를 참조하세요.

위의 ARCore 확장 프로그램 필드가 모두 제대로 연결되면 ARCore 확장 프로그램 Inspector 창이 다음과 같이 표시됩니다.

속성 설정에 관한 자세한 내용은 Unity의 속성 수정 가이드를 참고하세요.

샘플 프로젝트

AR Foundation용 ARCore 확장 프로그램 번들은 자체 프로젝트 빌드를 시작하는 데 사용할 수 있는 샘플 프로젝트입니다.

  1. Window 메뉴에서 Package Manager을 열고 ARCore Extensions 패키지를 선택합니다.

  2. Samples에서 아래에 설명된 샘플 프로젝트의 Import를 클릭합니다.

GitHub 저장소에서 가져오는 샘플 프로젝트는 다음과 같습니다.

  • 지리정보(Android만 해당) - 전 세계에서 AR 환경을 만들고 Google 스트리트 뷰가 적용되는 모든 지역에 원격으로 콘텐츠를 연결합니다. 자세한 내용은 Geospatial API 소개를 참고하세요.

  • PersistentCloudAnchors (Android 및 iOS) - 실제 위치에 고정된 디지털 정보 대화형 레이어를 사용하여 실제 환경에서 지속적인 AR 환경을 만들고 시간이 지남에 따라 여러 기기에서 여러 사용자가 공유할 수 있는 디자인 환경을 만듭니다. 자세한 내용은 클라우드 앵커 소개를 참조하세요.

다음 단계

AR Foundation용 ARCore 확장 프로그램을 사용하면 이제 앱에서 클라우드 앵커카메라 구성을 사용할 수 있습니다.