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

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

요구사항

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

Android

하드웨어

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

소프트웨어

iOS

하드웨어

  • ARKit 호환 ARCore 지원 기기
  • 기기를 개발 머신에 연결하는 데 사용하는 USB 케이블

소프트웨어

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... 옵션을 선택합니다.

    3. 다음 URL을 텍스트 입력란에 붙여넣습니다.

      https://github.com/google-ar/arcore-unity-extensions.git

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

EDM4U 미사용

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

번들 종속 항목 없이 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 확장 프로그램 설정

AR Foundation 4.x

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

    • XR > AR Session
    • XR > AR Session Origin
    • XR > ARCore Extensions

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

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

    • Session: 장면의 AR Session을 사용합니다.
    • AR 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 애셋에 연결합니다.

      자세한 내용은 클라우드 앵커 개발자 가이드 및 카메라 구성 가이드를 참고하세요.

    6. 2020.3 미만의 Unity 버전을 사용하는 경우:

      • Project Settings > Player > Android > Publishing Settings > Build에서 Custom Gradle Properties Template을 선택합니다.

위의 모든 ARCore 확장 프로그램 필드가 적절하게 연결되면 ARCore 확장 프로그램 Inspector 창이 다음과 같이 표시됩니다.

AR Foundation 5.x

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

    • XR > AR Session
    • XR > XR Origin (Mobile AR)
    • XR > ARCore Extensions

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

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

    • Session: 장면의 AR Session을 사용합니다.
    • XR Origin: 장면의 XR 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 애셋에 연결합니다.

      자세한 내용은 클라우드 앵커 개발자 가이드 및 카메라 구성 가이드를 참고하세요.

    6. 2020.3 미만의 Unity 버전을 사용하는 경우:

      • Project Settings > Player > Android > Publishing Settings > Build에서 Custom Gradle Properties Template을 선택합니다.

위의 모든 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 확장 프로그램을 사용하면 앱에서 Cloud Anchors 및 카메라 구성을 사용할 수 있습니다.