이 가이드는 언리얼 엔진에서 빈 프로젝트를 새로 생성하고 필요한 블루프린트 및 환경설정을 추가하여 AR 환경으로 변환하는 방법을 보여줍니다.
이미 구성된 AR 프로젝트를 시작하려는 경우 다음 AR 템플릿을 참조하세요.
다음 단계를 따라 새 언리얼 프로젝트와 최소한의 렌더링 기능이 활성화된 레벨을 생성합니다. 디폴트 레벨이 있는 빈 프로젝트에는 기본적으로 스카이 구체(Sky Sphere) 및 애트머스피어 포그(Atmosphere Fog) 오브젝트가 포함되어 있습니다. 이러한 오브젝트는 AR에서 모든 것을 지속적으로 오버레이하므로 AR 환경을 생성할 때 빈 레벨로 시작하여 표시할 항목을 제어하는 것이 유용합니다.
에픽게임즈 런처에서 언리얼 엔진을 실행합니다.
언리얼 프로젝트 브라우저 창에서 게임(Games)을 선택합니다.
이미지를 클릭하면 확대됩니다. 기본 템플릿(Blank Template)을 선택합니다.
이미지를 클릭하면 확대됩니다. 프로젝트 디폴트(Project Defaults)에서 다음을 선택합니다.
블루프린트
Scalable
레이 트레이싱 비활성화됨
Mobile
시작 콘텐츠 없음
이미지를 클릭하면 확대됩니다.
메인 메뉴에서 편집(Edit) > 플러그인(Plugins)을 선택하고 플러그인(Plugins) 창에서 AR 유틸리티(AR Utilities) 플러그인을 검색하여 활성화합니다. 지금 재시작(Restart Now)을 클릭하고 언리얼 엔진이 재시작될 때까지 기다립니다.
에디터에서 파일(File) > 새 레벨...(New Level...)을 선택하고 빈 레벨(Empty Level)을 선택합니다. 레벨 이름을 지정하고 저장합니다. 이 예시에서 레벨의 이름은 Main입니다.
메인 내비게이션에서 편집 > 프로젝트 세팅(Project Settings)을 선택합니다.
'프로젝트 세팅' 창에서 프로젝트(Project) 섹션에 있는 맵 & 모드(Maps & Modes)를 선택합니다. 에디터 스타트업 맵(Editor Startup Map) 및 게임 디폴트 맵(Game Default Map)을 새 레벨인 Main으로 설정합니다.
이미지를 클릭하면 확대됩니다.
폰 및 게임 모드 추가하기
언리얼 엔진에서 폰은 사용자를 물리적으로 표현한 것으로, 사용자가 월드와 인터랙션하는 방식을 정의합니다. 게임 모드 오브젝트는 사용할 폰 오브젝트 등 경험의 규칙을 정의합니다. 새 AR 프로젝트를 빌드하려면 앱 실행 시 환경과 인터랙션할 수 있도록 폰을 구성해야 합니다.
다음 단계를 따라 AR 프로젝트를 위한 폰과 게임 모드를 생성합니다.
콘텐츠 드로어에서 우클릭하고 목록에서 블루프린트 클래스(Blueprint Class)를 선택합니다. 부모 클래스 선택(Pick Parent Class) 창에서 폰(Pawn)을 선택합니다. 에셋 이름을 ARPawn으로 지정합니다.
콘텐츠 드로어에서 ARPawn 오브젝트를 더블클릭하여 블루프린트 에디터에서 엽니다. 블루프린트 에디터에서 컴포넌트 추가(Add Component)를 선택하고 Camera를 검색합니다.
카메라(Camera) 컴포넌트의 부모가 DefaultSceneRoot여야 합니다.
콘텐츠 드로어에서 우클릭하고 목록에서 블루프린트 클래스(Blueprint Class)를 선택합니다. 부모 클래스 선택(Pick Parent Class) 창에서 게임 모드 베이스(Game Mode Base)를 선택합니다. 에셋 이름을 ARGameMode로 지정합니다.
ARGameMode를 더블클릭하고 세팅을 편집합니다. 디폴트 폰 클래스(Default Pawn Class)를 ARPawn으로 설정합니다.
이미지를 클릭하면 확대됩니다. 메인 내비게이션에서 편집 > 프로젝트 세팅을 선택하여 프로젝트 세팅 창을 엽니다.
프로젝트 세팅 창에서 왼쪽의 프로젝트 섹션에 있는 맵 & 모드를 선택합니다.
디폴트 게임 모드(Default GameMode)를 ARGameMode로 설정합니다.
디폴트 폰 클래스를 ARPawn으로 설정합니다.
이미지를 클릭하면 확대됩니다.
AR 세션 생성하기
Start AR Session 함수에는 프로젝트의 AR 기능을 정의하는 ARSessionConfig 오브젝트가 필요합니다. 각 세팅에 대한 자세한 내용은 UARSessionConfig를 참고하세요.
아래의 단계를 따라 프로젝트에 AR 세션을 추가합니다.
콘텐츠 드로어에서 우클릭합니다. 기타(Miscellaneous) > 데이터 에셋(Data Asset)을 선택하여 데이터 에셋 클래스 선택(Pick Data Asset Class) 창을 엽니다.
데이터 에셋 클래스 선택 창에서 ARSessionConfig를 선택합니다. 데이터 에셋 이름을 ARSessionConfig로 지정합니다. 에셋을 열고 저장(Save)을 선택하여 디폴트 AR 옵션을 확정합니다.
ARPawn 에셋을 더블클릭하여 블루프린트 에디터에서 엽니다. Set Tracking Origin 함수를 추가합니다. 원점(Origin) 값을 바닥 레벨(Floor Level)로 설정합니다.
Start AR Session 함수를 추가합니다. 세션 환경설정(Session Config) 에셋을 ARSessionConfig로 설정합니다.
Stop AR Session 함수를 추가합니다.
이제 디바이스에서 프로젝트를 실행하면 AR 환경을 탐색할 수 있습니다. 디바이스에서 언리얼 프로젝트를 실행하는 방법에 대한 구체적인 단계를 보려면 해당 AR 플랫폼 관련 문서를 참고하세요.
직접 해보기
이 가이드에서는 새 AR 프로젝트를 생성하고, 필요한 블루프린트를 추가하여 AR 앱 빌드를 시작하는 방법을 알아보았습니다.