Android 빠른 시작

ARCore Unity 앱을 Android로 타겟팅 시작하기

이 가이드에서는 개발 환경을 설정하고 ARCore 샘플 앱을 사용해 보는 방법을 보여줍니다.

요구사항

하드웨어

  • ARCore 지원 기기

  • 기기를 개발 머신에 연결하는 USB 케이블

소프트웨어

Unity용 ARCore SDK 가져오기

  1. Unity용 ARCore SDK 1.25.0 이상을 다운로드합니다.
    SDK가 arcore-unity-sdk-1.25.0.unitypackage로 다운로드됩니다.

새 프로젝트 만들기 및 SDK 가져오기

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

  2. 버전별 패키지 설치

    • Unity 2017 또는 2018: 추가 패키지가 필요하지 않습니다. 다음 단계로 진행합니다.

    • Unity 2019: Window > Package Manager를 선택하고 다음 패키지를 설치합니다.

      • 멀티플레이어 HLAPI (Cloud Anchors 샘플에 필요)
      • XR 레거시 입력 도우미(인스턴트 미리보기에 필요, TrackedPoseDriver 사용)
    • Unity 2020: Window > Package Manager를 선택하고 다음 패키지를 설치합니다.

      • 멀티플레이어 HLAPI (Cloud Anchors 샘플에 필요)
      • XR 플러그인 관리(TrackedPoseDriver를 사용하는 인스턴트 미리보기에 필요)
  3. Unity용 ARCore SDK를 가져옵니다.

    1. Assets > Import Package > Custom Package를 선택합니다.

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

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

샘플 장면 열기

  1. Unity Project 창의
    Assets/GoogleARCore/Examples/HelloAR/Scenes/에서 HelloAR 샘플을 찾을 수 있습니다.

프로젝트 설정값 구성

  1. File > Build Settings로 이동하여 Build Settings 창을 엽니다.
  2. Platform(플랫폼)에서 Android를 선택하고 Switch Platform(플랫폼 전환)을 클릭합니다.
  3. Player Settings(플레이어 설정)를 클릭합니다.
  4. Android 설정 탭에서 다음 설정을 구성합니다.
    섹션 설정 구성
    기타 설정 렌더링 Auto Graphics API를 선택 해제합니다.
    Vulkan APIVulkan이 표시되면 삭제하세요.
    멀티스레드 렌더링 멀티스레드 렌더링을 사용하려면 이 옵션을 선택하세요.

    참고:
    • Android용으로 빌드할 때 멀티스레드 렌더링 옵션은 Unity용 ARCore SDK 1.17.0 이상에서 지원됩니다. 하지만 Unity 2018.1 이하에서 이 옵션을 사용 설정하면 전면 (셀카) 카메라 사용은 지원되지 않습니다.
    • 앱이 렌더링 스레드에 부담을 줄 때 3D 애셋이 항상 올바르게 렌더링되는 것은 아닙니다.
    패키지 이름 자바 패키지 이름 형식을 사용하여 고유한 앱 ID를 만듭니다.
    예를 들어 com.example.helloAR를 사용합니다.
    최소 API 수준 Android 7.0 'Nougat' (API 수준 24) 이상을 선택합니다.
    AR 선택사항 앱의 경우 최소 API 수준은 14입니다.
    백엔드 백엔드 스크립트 64비트 기기를 위해 빌드할 때 스크립팅 백엔드IL2CPP로 설정합니다. 자세한 내용은 ARCore 64비트 요구사항을 참고하세요.
    대상 아키텍처 64비트 기기를 위해 빌드할 때 ARM64를 선택합니다(백엔드 백엔드 스크립팅 필요). IL2CPP에 관한 자세한 내용은 ARCore 64비트 요구사항을 참고하세요.
    XR 설정 ARCore 지원 이 옵션을 사용 설정합니다.

샘플 앱 빌드 및 실행

  1. 기기에서 개발자 옵션과 USB 디버깅을 사용 설정합니다.

  2. 기기를 개발 머신에 연결합니다.

  3. Unity 빌드 설정 창에서 빌드 및 실행을 클릭합니다.
    Unity는 프로젝트를 Android APK로 빌드하고 기기에 설치하고 실행합니다.

  4. ARCore가 평면을 감지하고 시각화하기 시작할 때까지 기기를 움직입니다.

  5. 비행기를 탭하여 앤디 Android 객체를 배치합니다.

  6. (선택사항) Android logcat을 사용하여 로그 메시지를 보거나 Android Device Monitor를 사용하여 기기를 더 자세히 분석할 수 있습니다.

다음 단계