Session 검증 도구를 사용하여 Mega 기능을 활용하는 AR 프로젝트 시뮬레이션 실행
이 문서는 Unity 에디터에서 session 검증 도구를 사용하여 녹화된 EIF 데이터를 로드하고, Mega 기능을 사용하는 AR 프로젝트를 시뮬레이션 실행하는 방법을 개발자에게 안내합니다.
시작하기 전에
- 빠른 시작을 완료하여 Mega 기능을 포함한 Unity 애플리케이션 실행 방법을 이해하세요.
- EIF가 무엇인지 학습하세요.
- 시뮬레이션 실행 데이터 수집 방법을 숙지하세요.
Session 검증 도구로 시뮬레이션 실행이 유용한 이유
원격 개발: 현장에 머무르지 않고도 EIF 데이터를 활용하여 대규모 지리 공간 기반 AR 애플리케이션을 사무실에서 개발할 수 있습니다.
크로스 플랫폼 디버깅: 다양한 모바일 기기를 자주 연결할 필요 없이 Windows PC에서 스마트폰, 헤드셋 등 다양한 단말기의 위치 추적 효과를 시뮬레이션할 수 있습니다.
문제 보고의 "골드 스탠더드": 오류를 재현할 수 있는 EIF 파일은 EasyAR 팀이 위치 추적 문제를 해결하는 데 핵심적인 근거가 됩니다.
참고
EIF 데이터가 정밀하게 기록되었더라도 시뮬레이션 효과와 실제 사용 효과에는 차이가 있을 수 있습니다.
또한 시뮬레이션 데이터는 현장 커버리지가 제한적이므로 최종 배포 전 반드시 현장 테스트를 수행해야 합니다.
작업 단계
다음 단계에 따라 session 검증 도구로 시뮬레이션을 실행하세요.
현장에서 녹화한 EIF 파일 준비
선택한 녹화 형식에 따라 녹화된 EIF 데이터는 .mkveif 파일(또는 .eif 파일과 .eif.json 파일, 이 두 파일이 모두 필요함)이어야 합니다.
.eif 및 .eif.json:
.mkveif:
Block 고밀도 모델 또는 파노라마에 맞춰 3D 콘텐츠 배치
Session 검증 도구 활성화
씬의 AR Session (EasyAR) > Inspector 패널에서 Frame Player가 활성화되었는지 확인하세요.
실행
툴바 버튼을 클릭하거나 Session Validation Tool의 실행 버튼을 눌러 Unity 에디터에서 프로젝트를 실행하세요.
실행 후 팝업이 나타납니다. 이는 정상입니다. Frame Player 사용 중임을 알리는 메시지일 뿐입니다.
도구의 버튼을 클릭해 EIF 파일을 엽니다.
정상적으로 열리면 자동 재생됩니다. 툴바로 일시 정지/재개 등을 제어할 수 있으며, 일부 새 형식의 EIF는 진행률 표시줄 점프도 지원합니다.
실행 효과:
도구 EasyAR.Mega.BlockViewer (Dev)에서 Block 고밀도 모델을 로드한 경우, Block 고밀도 모델도 계속 표시됩니다. 위치 비교나 모델이 배치되지 않은 영역에서의 위치 추적 효과를 확인할 때 유용합니다.
일반적으로 도구 EasyAR.Mega.BlockViewer (Dev)를 닫고(active를 false로 설정하거나 씬 노드 삭제), 실행하면 현실 환경에 가상 객체가 오버레이된 효과를 볼 수 있습니다.
중요
사용 시 화면이나 시야 전방에 표시되는 진단 정보 텍스트를 반드시 확인하세요. UI 메시지 출력을 꼼꼼히 읽고, 개발 단계, 테스트 단계, 애플리케이션 출시 후 어떤 구성을 적용할지, 어떤 제어 스위치를 유지할지 신중하게 고려하세요. EasyAR과의 소통은 보통 이 정보 제공이 필요하므로, 바로 닫지 말고 적극 활용하는 것을 권장합니다.
기본 설정에서 시작 후 처음으로 Block을 위치 추적하기 전까지는 MegaBlocks와 그 하위 노드들의 active가 모두 false로, 콘텐츠가 표시되지 않습니다.
위치 추적 후에는 해당 노드들의 active가 true로 변경되어 콘텐츠가 표시되고 위치가 지속적으로 업데이트됩니다.
관련 동작을 변경하거나 active 상태를 더 자유롭게 제어하려면 BlockRootController 컴포넌트 참조 및 BlockController 컴포넌트 참조를 참조하세요.
[선택 사항] LCC 3D Gaussian Splatting 사용
참고
본 항목은 기기 도메인 수집 및 매핑 완료 후 사용 시나리오에 적용됩니다. 다른 기기의 매핑 결과에는 LCC 3DGS 데이터가 포함되지 않습니다.
LCC 3D Gaussian Splatting(기기 도메인 LCC) 기능을 사용하는 경우, 시뮬레이션 실행 시 3DGS 결과를 동시에 렌더링하여 모델과 3DGS의 정렬 효과를 확인할 수 있습니다.
먼저 LCC 데이터 로드 및 Mesh 정렬이 필요합니다.
Camera에 SceneGameCameraSync 스크립트가 있다면 비활성화하세요.
EIF 파일 재생과 동시에 3DGS를 렌더링하는 시뮬레이션 실행 효과는 다음과 같습니다: