Unreal용 빠른 시작

개발 환경 설정

  • 다음 단계에 따라 소스 코드에서 ARARCore 플러그인을 사용하여 Unreal Engine 4.20을 빌드합니다.

    • Epic Games 조직에 가입하여 Epic&#39의 GitHub 저장소에 액세스하세요.

    • 다음 명령어를 사용하여 google-ar-unreal 저장소를 클론합니다.

      git clone -b 4.21-arcore \
      https://github.com/google-ar-unreal/UnrealEngine.git

      또는 기존 Unreal Engine 4.20 저장소를 사용하는 개발자는 다음 명령어를 사용하여 4.21-arcore 분기를 자체 분기에 병합할 수 있습니다.

      # Checkout your target branch, which must be based on Unreal 4.20
      git checkout <target-branch>
      
      # Add google-ar-unreal as a remote
      git remote add google-ar-unreal https://github.com/google-ar-unreal/UnrealEngine.git
      
      # Fetch and merge the arcore branch
      git fetch google-ar-unreal 4.21-arcore
      git merge google-ar-unreal/4.21-arcore
    • 소스에서 Unreal Engine 빌드.

      • 첫 번째 단계에서 운영체제를 선택하세요.
      • 포함된 Google ARCore 바이너리 파일을 Epic에서 제공한 이전 파일로 덮어쓰지 않도록 설정합니다. Would you like to overwrite your changes (y/n)?가 표시되면 n를 선택합니다.
  • Android 빠른 시작에 따라 Android 개발을 위한 Unreal 편집기를 설정합니다. Android SDK 플랫폼 버전 7.0 (API 수준 24) 이상을 설치해야 합니다.

  • Unreal HelloAR 샘플 프로젝트를 가져와야 합니다. 다음 중 원하는 방법을 선택하면 됩니다.

    • 샘플 프로젝트 저장소를 다운로드하여 압축을 풉니다.

      -또는-

    • 다음 명령어를 사용하여 저장소를 클론합니다.

      git clone https://github.com/google-ar/arcore-unreal-sdk.git

  • 지원되는 Android 기기가 필요합니다.

기기 준비

지원되는 기기를 준비하려면 개발자 옵션과 USB 디버깅을 사용 설정하세요.

샘플 프로젝트 열기

Unreal 편집기에서 HelloAR 샘플 프로젝트를 엽니다.

Android 개발 설정

  1. 메뉴 바에서 Edit > Project Settings를 클릭합니다.

  2. 프로젝트 설정의 Android SDK 플랫폼에서 모든 경로가 Android SDK 및 Android NDK 설치로 올바르게 설정되었는지 확인합니다. SDK API 수준을 'matchndk'로 설정합니다. 그런 다음 NDK API 수준을 android-24 이상으로 설정합니다.

샘플 앱 빌드 및 실행

  1. HelloAR 프로젝트를 패키징합니다. 메뉴 바에서 File > Package Project > Android > Android (ASTC)를 선택합니다.

    대화상자가 나타납니다. 상자에서 Builds라는 이름의 새 폴더를 만들고 Select를 클릭합니다.

  2. Unreal에서는 프로젝트 패키징을 시작하고 진행률 창 (오른쪽 하단)에 진행 상황을 표시합니다. 패키징 프로세스에 관한 자세한 내용은 출력 로그 창을 참조하세요.

  3. 프로젝트가 패키징되면 기기가 시스템에 연결되어 있는지 확인합니다. Builds 폴더를 열고 Install_HelloARUnreal_Development-armv7-es2.bat (Windows를 사용하는 경우) 또는 Install_HelloARUnreal_Development-armv7-es2.command (Mac을 사용하는 경우) 파일을 더블클릭하여 Android 스마트폰에 프로젝트를 설치합니다.

  4. 설치가 완료되면 기기에서 HelloAR UE4라는 앱을 찾아 실행합니다.

기기를 움직이면 앱이 자동으로 평평한 표면을 감지하고 다이아몬드 그리드를 그립니다. 그리드를 탭하여 Android 로봇을 표면에 배치합니다.

다음 단계