Unreal의 증강 이미지 개발자 가이드

이 가이드를 따르기 전에 증강 이미지 개요를 참고하여 중요한 고려사항, 실용적인 팁, 권장사항을 확인하세요.

기본 요건

  • 이 가이드에서는 Google ARCore 플러그인 1.2 이상을 사용하여 Unreal Engine 4.19를 이미 설치하고 구성했다고 가정합니다. 그렇지 않은 경우 Unreal용 빠른 시작에서 설치 및 설정 단계를 참고하세요.

샘플 빌드 및 실행

arcore-unreal-sdk를 다운로드하여 증강 이미지 샘플 프로젝트를 가져옵니다.

샘플 프로젝트 빌드 및 실행에 관한 안내는 Unreal 빠른 시작을 참조하세요.

증강 이미지 사용

  1. 증강 이미지 기능을 사용하려면 Unreal 콘텐츠 브라우저에서 GoogleARCoreConfig 데이터 애셋을 만듭니다.

  2. GoogleARCoreAugmentedImageDatabase 데이터 애셋을 만듭니다.

  3. 이전 단계에서 만든 GoogleARCoreAugmentedImageDatabase 애셋을 열고 ARCore에서 감지한 다음 추적할 이미지를 AugmentedImages 항목에 추가합니다.

    1. 질감과 실제 이미지의 이미지 예상 너비(선택사항)를 선택적으로 제공해야 합니다. 너비를 모르거나 알 수 없는 경우 너비 필드에 0.0을 입력할 수 있습니다. ARCore는 이미지를 감지하면 크기를 예측하려고 하지만 사용자가 이미지를 감지하기 전에 병렬 모션을 실행해야 할 수 있습니다.

  4. 증강 이미지 데이터베이스 구성을 완료한 후 GoogleARCoreConfig 애셋을 열고 AugmentedImageDatabase에서 방금 만든 데이터베이스 애셋을 선택합니다. 해당 세션에서 아무 것도 선택하지 않으면 ARCore 세션에서 증강된 이미지 기능이 사용 중지됩니다.

  5. BluePrint 또는 C++에서 GoogleARCoreConfig를 사용하여 ARSession를 시작합니다. 증강 이미지를 감지하도록 AR 앱을 모두 설정해야 합니다.

프로젝트에서 Unreal's증강 현실 모듈의 Blueprints 또는 C++ 함수를 사용하여 추적된 모든 도형을 가져오고 GoogleARCoreAugmentedImage type으로 변환할 수 있습니다. ARCore에서 이미지를 감지하면 이 GoogleARCoreAugmentedImage type의 인스턴스를 가져올 수 있습니다. 그런 다음 Blueprints 또는 C++ 함수를 사용하여 이름, 색인, 변환, 범위 등을 쿼리할 수 있습니다. 자세한 내용은 샘플 프로젝트의 증강 이미지 맵에서 수준 청사진을 확인하세요.