Unity용 ARCore SDK는 2021년에 지원 중단되었으며 더 이상 지원되지 않습니다. 또한 Unity용 ARCore SDK는 Unity 2020 이상에서 사용할 수 없습니다. 새 프로젝트를 시작하는 개발자는 대신 AR Foundation용 ARCore 확장 프로그램을 사용해야 합니다. 이 SDK는 AR Foundation으로 이전할 수 없는 기존 프로젝트에서 작업하는 개발자만 사용해야 합니다.

Android용 ARCore 사용 설정

이 페이지에서는 Android 기기를 타겟팅하는 Unity 프로젝트에서 ARCore 기능을 사용 설정하는 방법을 설명합니다. 이렇게 하려면 다음이 필요합니다.

  1. Unity용 ARCore SDK 가져오기
  2. 앱을 AR 필수 또는 AR 선택사항으로 구성
  3. 앱이 ARCore의 사용자 개인 정보 보호 요구사항을 준수하는지 확인합니다.

Google Play AR 서비스

ARCore SDK를 사용하면 AR용 Google Play 서비스(ARCore)가 설치된 ARCore 지원 기기에서 AR 기능을 사용할 수 있습니다.

Google Play AR 서비스는 자동으로 설치되며 지원되는 대부분의 기기에 최신 상태로 유지됩니다.

AR 세션을 시작하기 전에 앱은 다음 요건을 충족해야 합니다.

  1. CheckApkAvailability를 호출하여 ARCore가 지원되는지 확인합니다.
  2. Session.RequestApkInstallation(bool userRequested)를 호출하여 AR용 Google Play 서비스가 설치되어 있고 최신 버전이며 필요한 ARCore 기기 프로필 데이터가 다운로드되었는지 확인합니다.

Unity용 ARCore SDK 가져오기

  1. Unity를 열고 새 3D 프로젝트를 만듭니다.

  2. 버전별 패키지를 설치합니다.

    Unity 2020

    Window(창) > Package Manager(패키지 관리자)를 선택하고 다음 패키지를 설치합니다.

    • 멀티플레이어 HLAPI (클라우드 앵커 샘플에 필요)
    • XR 플러그인 관리(TrackedPoseDriver를 사용하는 인스턴트 미리보기에 필요)

    Unity 2019

    Window(창) > Package Manager(패키지 관리자)를 선택하고 다음 패키지를 설치합니다.

    • 멀티플레이어 HLAPI(클라우드 앵커 샘플에 필요)
    • XR 레거시 입력 도우미 (TrackedPoseDriver를 사용하는 인스턴트 미리보기에서 필요)

    Unity 2018

    추가 패키지가 필요하지 않습니다. 다음 단계로 진행합니다.

    Unity 2017

    추가 패키지가 필요하지 않습니다. 다음 단계로 진행합니다.

  3. Unity용 ARCore SDK를 가져옵니다.

    1. Assets(애셋) > Import Package(패키지 가져오기) > Custom Package(맞춤 패키지)를 선택합니다.

    2. 다운로드한 arcore-unity-sdk-1.25.0.unitypackage를 선택합니다.

    3. 패키지 가져오기 대화상자에서 모든 패키지 옵션이 선택되었는지 확인하고 가져오기를 클릭합니다.

Unity의 프로젝트 창에 Assets/GoogleARCore/Examples/HelloAR/의 SDK 파일과 HelloAR 샘플 앱이 모두 표시됩니다.

앱을 AR 필수 또는 AR 선택사항으로 구성

AR 기능을 지원하는 앱은 AR 필수AR 선택사항이라는 두 가지 방법으로 구성할 수 있습니다. 어떤 앱을 선택할지 결정하는 데 도움이 필요하면 Google Play 스토어에 AR 앱 게시하기를 참고하세요.

AR 필요

이 기능을 사용하려면 AR 필수 앱에 AR용 Google Play 서비스가 설치된 ARCore 지원 기기가 필요합니다.

  • Google Play 스토어에서는 AR AR 앱은 ARCore를 지원하는 기기에서만 사용할 수 있습니다.

  • 사용자가 AR 필수 앱을 설치하면 Google Play 스토어에서 AR용 Google Play 서비스를 자동으로 설치합니다. 하지만 Google Play AR 서비스를 업데이트하거나 수동으로 제거해야 하거나 ARCore 기기 프로필 데이터가 최신이 아닌 경우 앱에서 추가 런타임 검사를 실행해야 합니다.

자세한 내용은 Google Play 스토어에 AR 앱 게시를 참고하세요.

앱 AR을 필수로 설정하려면 다음 단계를 따르세요.

Unity 2020

  1. 수정 > 프로젝트 설정을 엽니다. Google ARCore를 선택하고 ARCore 필수가 선택되어 있는지 확인합니다.

  2. Edit > Project Settings > Player를 클릭하고 Android 아이콘이 있는 탭을 선택하여 적절한 Minimum API Level을 설정합니다. Other Settings > Identification에서 Minimum API Level24 이상으로 선택합니다.

Unity 2019

  1. 수정 > 프로젝트 설정을 엽니다. Google ARCore를 선택하고 ARCore 필수가 선택되어 있는지 확인합니다.

  2. Edit > Project Settings > Player를 클릭하고 Android 아이콘이 있는 탭을 선택하여 적절한 Minimum API Level을 설정합니다. Other Settings > Identification에서 Minimum API Level24 이상으로 선택합니다.

Unity 2018

  1. 수정 > 프로젝트 설정을 엽니다. Google ARCore를 선택하고 ARCore 필수가 선택되어 있는지 확인합니다.

  2. Edit > Project Settings > Player를 클릭하고 Android 아이콘이 있는 탭을 선택하여 적절한 Minimum API Level을 설정합니다. Other Settings > Identification에서 Minimum API Level24 이상으로 선택합니다.

Unity 2017

  1. 수정 > 프로젝트 설정 > Google ARCore를 열고 ARCore 필수가 선택되어 있는지 확인합니다.

  2. Edit > Project Settings > Player를 클릭하고 Android 아이콘이 있는 탭을 선택하여 적절한 Minimum API Level을 설정합니다. Other Settings > Identification에서 Minimum API Level24 이상으로 선택합니다.

앱은 자동으로 런타임 검사를 실행하여 기기가 ARCore를 지원하고 AR용 Google Play 서비스가 설치되어 있고 ARCore 기기 프로필 데이터가 최신 상태인지 확인합니다. AR용 Google Play 서비스가 설치되어 있지 않거나 (사용자가 삭제했기 때문에) 버전이 너무 오래된 경우 앱에서 사용자에게 설치 또는 업데이트하라는 메시지를 표시합니다. ARCore 기기 프로필 데이터가 최신 상태가 아니면 앱에서 데이터를 다운로드하고 업데이트합니다. 설치 또는 업데이트가 실패하면 (네트워크 장애로 인해) Session.Status가 오류를 반환하고 앱이 오류를 처리하고 종료해야 합니다.

AR(선택사항)

AR 선택사항 앱에는 선택적 AR 기능이 있습니다. 이 기능은 Google Play AR 서비스가 설치된 기기에서만 활성화됩니다.

  • AR 선택적 앱은 ARCore를 지원하지 않는 기기에 설치하고 실행할 수 있습니다.

  • 사용자가 AR 선택사항 앱을 설치하면 Google Play 스토어에서는 앱과 함께 Google Play AR 서비스를 자동으로 설치하지 않습니다.

앱 AR을 선택사항으로 설정하려면 다음 단계를 따르세요.

Unity 2020

  1. 수정 > 프로젝트 설정을 엽니다. Google ARCore를 선택하고 ARCore 필수를 선택 해제합니다.

  2. Edit > Project Settings > Player를 클릭하고 Android 아이콘이 있는 탭을 선택하여 적절한 Minimum API Level을 설정합니다. Other Settings > Identification에서 Minimum API Level18 이상으로 선택합니다.

Unity 2019

  1. 수정 > 프로젝트 설정을 엽니다. Google ARCore를 선택하고 ARCore 필수를 선택 해제합니다.

  2. Edit > Project Settings > Player를 클릭하고 Android 아이콘이 있는 탭을 선택하여 적절한 Minimum API Level을 설정합니다. Other Settings > Identification에서 Minimum API Level18 이상으로 선택합니다.

Unity 2018

  1. 수정 > 프로젝트 설정을 엽니다. Google ARCore를 선택하고 ARCore 필수를 선택 해제합니다.

  2. Edit > Project Settings > Player를 클릭하고 Android 아이콘이 있는 탭을 선택하여 적절한 Minimum API Level을 설정합니다. Other Settings > Identification에서 Minimum API Level18 이상으로 선택합니다.

Unity 2017

  1. 수정 > 프로젝트 설정 > Google ARCore를 열고 ARCore 필수를 선택 해제합니다.

  2. Edit > Project Settings > Player를 클릭하고 Android 아이콘이 있는 탭을 선택하여 적절한 Minimum API Level을 설정합니다. Other Settings > Identification에서 Minimum API Level18 이상으로 선택합니다.

런타임 검사 실행

앱이 실행되면 Session.CheckApkAvailability()를 호출하여 기기가 ARCore를 지원하는지 확인하고, 지원하는 경우 AR 및 ARCore용 Google Play 서비스 기기 데이터가 설치되었고 최신 상태인지 확인해야 합니다.

앱은 다음과 같은 조건을 처리해야 합니다.

조건 작업
기기가 ARCore를 지원하지 않습니다. AR 관련 기능을 숨깁니다.
기기에서 ARCore를 지원하지만, AR 및/또는 ARCore 기기 프로필 데이터에 대한 Google Play 서비스가 설치되어 있지 않거나 최신 상태가 아닙니다. Session.RequestApkInstallation()를 호출하여 사용자에게 AR 또는 ARCore 기기 프로필 데이터를 위한 Google Play 서비스를 설치하거나 업데이트하라는 메시지를 표시합니다.
기기가 ARCore 및 AR용 Google Play 서비스를 지원하며 ARCore 기기 프로필 데이터가 설치되어 있고 최신 상태입니다. ARCore Session를 만들고 ARCore를 사용하기 시작합니다.

사용자 개인 정보 보호 요구사항

앱이 ARCore의 사용자 개인 정보 보호 요구사항을 준수하는지 확인합니다.

다음 단계

샘플 앱의 코드와 Unity용 ARCore API 참조를 읽어보세요.