Table of Contents

Session 검증 도구 사용

이 문서에서는 세션 검증 도구를 사용하여 에디터에서 세션 워크플로를 빠르게 검증하고 EIF 파일을 사용한 시뮬레이션 실행 방법을 설명합니다.

시작하기 전에

시뮬레이션 실행은 입력으로 EIF 파일을 사용하므로 시작하기 전에 EIF 파일을 녹화해야 합니다:

또한 다음 사항을 이해해야 합니다:

세션 검증 도구

세션 검증 도구는 개발자가 Unity 에디터에서 세션 워크플로를 빠르게 검증하고 EIF 파일을 사용한 시뮬레이션 실행을 돕기 위해 사용됩니다.

기본적으로 AR Session (EasyAR) 게임 오브젝트의 Inspector 창에서 세션 검증 도구를 볼 수 있으며, 이는 DiagnosticsController 에디터의 일부입니다:

alt text

도구 우측 상단의 ↗ 버튼을 클릭하면 도구를 독립적인 창으로 표시하여 보기와 조작이 용이하며, 창을 닫거나 ↘ 버튼을 누르면 도구가 다시 Inspector 창에 표시됩니다.

alt text

도구 실행 효과는 다음 동영상에서 확인할 수 있습니다:

이 동영상은 세션 검증 도구의 사용 효과를 보여주며, Unity 플레이 모드에서 녹화되었습니다. 동영상 상단 왼쪽은 Hierarchy 뷰, 중간은 Scene 뷰, 오른쪽은 Game 뷰이며, 동영상 하단은 세션 검증 도구입니다. Game 뷰의 내용은 현실 세계에서 사용자의 휴대폰에 표시되는 것과 동일합니다.

도구 왼쪽 상단에는 EIF 재생 진행률 표시줄이 표시되며 재생 진행 상황에 따라 지속적으로 변경됩니다. 도구 왼쪽 하단에는 현재 세션 상태가 표시됩니다. 도구 오른쪽에는 세션 구성 요소와 사용 가능한 센터 모드가 표시됩니다.

장면에서 동시에 작동하는 세 가지 AR 기능을 볼 수 있습니다:

  • 모션 트래킹: frame player에 의해 제공되며, 파란색 구체는 XR Origin이고 파란색 원뿔은 사용자 위치를 나타냅니다.
  • 밀집 공간 매핑: 시점 이동에 따라 반투명 메쉬 모델이 지속적으로 생성되는 것을 볼 수 있습니다.
  • 희소 공간 트래킹: 비디오에서 추적 중인 것은 크리스마스 트리이며, 오버레이된 가상 오브젝트는 연한 파란색 포인트 클라우드입니다.

도구 시작

도구 상단의 ▶ 버튼을 클릭하여 도구를 시작할 수 있습니다. 이 버튼을 누르는 효과는 Unity 툴바의 ▶ 버튼을 직접 누르는 것과 동일합니다.

alt text

도구가 이미 시작된 경우 버튼이 ■로 변경되며, 클릭하면 도구가 중지됩니다.

도구가 독립 창으로 표시될 때, ▶ 버튼 오른쪽의 선택 상자에서 도구가 사용할 세션 게임 오브젝트를 선택할 수 있습니다. 창이 재설정되어 세션이 손실된 경우 여기서 다시 선택할 수 있습니다.

EIF 재생 제어

도구의 EIF 재생 기능을 사용하려면 실행 전 도구의 Frame Player 옵션을 선택해야 합니다. 이때 도구는 세션 조립 과정에서 frame source 선택을 관리하며 AssembleOptions.FrameSource 설정 값에 관계없이 frame player 구성 요소가 활성화됩니다.

alt text

따라서 실행 시 현재 세션에서 사용 중인 frame source가 도구에 의해 관리되고 있음을 알리는 팝업이 표시됩니다:

alt text

참고

도구는 Unity 에디터에서만 조립 과정의 frame source 선택을 관리하며, 애플리케이션 빌드 및 실행 시에는 이 옵션이 영향을 미치지 않습니다.

정상 실행 시 EIF 재생 제어 기능은 도구 상단의 그림에서 테두리로 표시된 부분에 나타납니다:

alt text

이 버튼들을 통해 EIF 파일 재생을 제어할 수 있습니다:

  • ▶: 재생, 일시 중지 또는 중지 상태에서 재개
  • ▮▮: 일시 중지
  • ■: 중지
  • ▮◀: 5초 전으로 이동 (파일 지원 시)
  • ◀◀: 재생 속도 감소 (파일 지원 시)
  • ▶▶: 재생 속도 증가 (파일 지원 시)
  • ▶▮: 5초 후로 이동 (파일 지원 시)
  • ▲: 파일 열기
  • 진행률 표시줄: 클릭하여 재생 위치 이동 (파일 지원 시)

재생 중에 장면의 내용과 상호작용 로직을 조정하여 컴퓨터에서 대부분의 개발 작업을 수행하고 효과를 직관적으로 볼 수 있습니다.

참고

새 데이터 재생 또는 재생 위치 이동 시 장면의 원본 데이터는 지워지지 않습니다. AR 구성 요소의 상태도 재설정되지 않으며, 카메라 데이터가 이전 프레임에서 새 데이터로 갑자기 이동한 것처럼 동작합니다.

일부 기능에는 큰 영향을 미치지 않을 수 있지만, 모션 트래킹에 의존하는 기능(예: 밀집 공간 맵, Mega 등)의 경우 기능 상태가 비정상적으로 되어 실행 효과에 영향을 줄 수 있습니다.

세션 워크플로 제어

도구의 세션 워크플로 제어 기능을 사용하려면 실행 전 도구의 Session Workflow 옵션을 선택해야 하며, 이 옵션은 기본적으로 선택되어 있습니다.

alt text

정상 실행 시 세션 워크플로 제어 기능은 도구의 재생 제어 아래 그림에서 테두리로 표시된 부분에 나타납니다:

alt text

전체 영역 상단에는 EasyARController.IsReady 및 ARSession.State 두 가지 상태 정보가 표시됩니다.

전체 영역 하단에는 다음 버튼들이 제공되어 세션 워크플로를 제어합니다:

  • Initialize: 세션 초기화, Project Settings에 구성된 라이선스 키 사용 또는 수동 라이선스 키 입력 선택 가능
  • Assemble: 세션 조립(시작 전)
  • StartSession (Assembled): 조립된 세션 시작
  • StartSession: 조립 및 세션 시작
  • StopSession: 세션 중지
  • StopSession (keep image): 세션 중지, 이미지 배경 유지
  • Deinitialize: 세션 초기화 해제
참고

이 제어 기능들은 ARSession 및 EasyARController의 관련 메서드를 직접 호출하므로, 이 버튼들을 통해 콘텐츠에 미치는 세션 상태 변화를 검증할 수 있습니다. 그러나 애플리케이션 스크립트에서도 유사한 메서드를 호출하는 경우, 애플리케이션 실행 흐름이 애플리케이션 자체의 예상을 벗어날 수 있음에 유의해야 합니다.

세션 구성 요소 제어

도구의 세션 구성 요소 제어 기능을 사용하려면 실행 전 도구의 Session Workflow 옵션을 선택해야 하며, 이 옵션은 기본적으로 선택되어 있습니다.

alt text

정상 실행 시 세션 구성 요소 제어는 도구 하단 또는 우측 그림에서 테두리로 표시된 부분에 나타나며, 창 너비에 따라 위치가 변경됩니다:

alt text

이 영역에 표시되는 내용은 특정 세션에 따라 다릅니다. 예를 들어 위 이미지에서 사용된 세션에는 이미지 트래킹, 밀집 공간 매핑 및 희소 공간 트래킹 세 가지 기능 구성 요소가 포함되어 있으므로 도구에 이 세 가지 기능의 제어 선택 상자가 표시됩니다.

일반적으로 이 영역에는 세션에서 사용 가능한 모든 AR 기능 구성 요소가 표시되며 다음 구성 요소의 활성화/비활성화(enabled) 제어를 제공합니다:

  • AR 세션: 세션 자체 활성화/비활성화 제어
  • 이미지 렌더러: 물리적 카메라 이미지 렌더링 활성화/비활성화 제어
  • 카메라: 가상 카메라 활성화/비활성화 제어
  • 프레임 소스: 프레임 소스 활성화/비활성화 제어, frame player가 활성화되지 않은 경우에만 제어 가능. frame player 활성화 시 기능 제어는 EIF 재생 제어 부분으로 대체됨
  • 프레임 필터: 특정 AR 기능 활성화/비활성화 제어
  • 프레임 레코더: EIF 구성 요소 녹화 활성화/비활성화 제어, frame player가 활성화되지 않은 경우에만 표시됨. frame player 활성화 시 이 구성 요소는 세션에 조립되지 않음

또한 영역 내에는 세션에서 사용 가능한 센터 모드 및 세션 보고서가 표시됩니다.

참고

도구에 표시된 사용 가능한 센터 모드 및 세션 보고서는 에디터 하에서 실행된 결과이며, 실제 기기에서 실행 시 다를 수 있습니다.

관련 주제