Session 검증 도구 사용

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

시작하기 전에

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

• EIF 파일 기록을 참조하여 EIF 파일을 기록하세요.

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

• EIF 파일 기록 및 시뮬레이션 실행에 사용의 기본 개념을 이해하세요.
• AR Session의 기본 개념, 구성 및 워크플로를 이해하세요.

Session 검증 도구

Session 검증 도구는 개발자가 Unity 에디터에서 session 워크플로를 빠르게 검증하고 EIF 파일을 사용하여 시뮬레이션 실행하는 데 도움이 됩니다.

기본적으로 AR Session (EasyAR) 오브젝트의 Inspector 창에서 session 검증 도구를 볼 수 있습니다. 이 도구는 DiagnosticsController 에디터의 일부입니다.

도구 오른쪽 상단의 ↗ 버튼을 클릭하면 도구를 독립된 창으로 팝업하여 보기 및 조작이 편리합니다. 창을 닫거나 ↘ 버튼을 누르면 도구가 다시 Inspector 창에 표시됩니다.

도구가 실행될 때의 효과는 다음 비디오와 같습니다.

이 비디오는 session 검증 도구의 사용 효과를 보여주며, Unity의 play 모드에서 녹화되었습니다. 비디오 상단 왼쪽은 Hierarchy 뷰, 중간은 Scene 뷰, 오른쪽은 Game 뷰입니다. 비디오 하단은 session 검증 도구입니다. Game 뷰의 내용은 사용자가 현실 세계에서 휴대폰으로 볼 수 있는 내용과 동일합니다.

도구 왼쪽 상단 부분에는 EIF 재생 진행률 바가 표시되며, 재생 진행에 따라 계속 변경되는 것을 볼 수 있습니다. 도구 왼쪽 하단 부분에는 현재 session의 상태가 표시됩니다. 도구 오른쪽에는 session의 구성 요소와 사용 가능한 중심 모드가 표시됩니다.

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

• 모션 추적: frame player에서 제공하며, 파란색 구체는 XR Origin이고, 파란색 원뿔은 사용자 위치를 나타냅니다.
• 밀집 공간 구축: 시야가 이동함에 따라 반투명 그리드 모델이 계속 생성되는 것을 볼 수 있습니다.
• 희소 공간 추적: 비디오에서 추적되는 것은 크리스마스 트리이며, 중첩된 가상 물체는 연한 파란색 포인트 클라우드입니다.

도구 시작

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

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

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

EIF 재생 제어

도구의 EIF 재생 기능을 사용하려면 실행 전에 도구의 Frame Player 옵션을 선택해야 합니다. 이 경우 도구가 session 조립 과정에서 frame source의 선택을 관리하며, AssembleOptions.FrameSource이 어떤 값으로 설정되든 frame player 구성 요소가 활성화됩니다.

따라서 실행 시 현재 session이 사용하는 frame source가 도구에 의해 관리된다는 팝업 경고가 표시됩니다.

참고

도구는 Unity 에디터에서만 조립 과정에서 frame source의 선택을 관리하며, 애플리케이션을 패키징하여 실행할 때 이 옵션은 아무 영향을 미치지 않습니다.

정상적으로 실행될 때 EIF 재생 제어 기능은 도구 상단의 그림에 표시된 부분에 표시됩니다.

이러한 버튼을 통해 EIF 파일의 재생을 제어할 수 있습니다.

• ▶：재생, 일시 중지 또는 중지 상태에서 재생을 재개합니다.
• ▮▮：일시 중지
• ■：중지
• ▮◀：5초 전으로 이동합니다(파일이 지원하는 경우).
• ◀◀：재생 속도를 낮춥니다(파일이 지원하는 경우).
• ▶▶：재생 속도를 높입니다(파일이 지원하는 경우).
• ▶▮：5초 후로 이동합니다(파일이 지원하는 경우).
• ▲：파일 열기
• 진행률 바：클릭하면 재생 위치를 이동할 수 있습니다(파일이 지원하는 경우).

재생하는 동안 장면의 내용과 상호 작용 논리를 조정할 수 있으므로 대부분의 개발 작업을 컴퓨터에서 수행하고 직관적으로 효과를 확인할 수 있습니다.

참고

새 데이터를 재생하거나 재생 위치를 이동할 때 장면에 있는 기존 데이터는 지워지지 않습니다. AR 구성 요소의 상태도 초기화되지 않으며, 카메라 데이터가 이전 프레임 데이터에서 새 데이터로 갑자기 변경된 것처럼 동작합니다.

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

Session 워크플로 제어

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

정상적으로 실행될 때 session 워크플로 제어 기능은 도구의 재생 제어 아래 그림에 표시된 부분에 표시됩니다.

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

전체 영역의 하단에는 session의 워크플로를 제어하는 ​​다음 버튼이 제공됩니다.

• Initialize：session을 초기화합니다. Project Settings에 구성된 license key를 사용하거나 수동으로 license key를 입력할 수 있습니다.
• Assemble：session을 조립하지만 시작하지 않습니다.
• StartSession (Assembled)：조립된 session을 시작합니다.
• StartSession：session을 조립하고 시작합니다.
• StopSession：session을 중지합니다.
• StopSession (keep image)：session을 중지하지만 이미지 배경을 유지합니다.
• Deinitialize：session을 역초기화합니다.

참고

이러한 제어 기능은 ARSession 및 EasyARController의 관련 메서드를 직접 호출하므로 이러한 버튼을 통해 session 상태 변경이 내용에 미치는 영향을 검증할 수 있지만 애플리케이션 스크립트에서도 유사한 메서드를 호출하는 경우 애플리케이션의 실행 흐름이 애플리케이션 자체의 예상과 달라질 수 있으므로 주의해야 합니다.

Session 구성 요소 제어

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

정상적으로 실행될 때 session 구성 요소 제어는 도구의 하단 또는 오른쪽 그림에 표시된 부분에 표시되며, 구체적인 위치는 창 너비에 따라 다릅니다.

이 영역에 표시되는 내용은 구체적인 session에 따라 다릅니다. 예를 들어 위 그림에서 사용한 session에는 이미지 추적, 밀집 공간 구축 및 희소 공간 추적 세 가지 기능 구성 요소가 포함되어 있으므로 도구에 이 세 가지 기능의 제어 선택 상자가 표시됩니다.

일반적으로 이 영역에는 session에서 사용 가능한 모든 AR 기능 구성 요소가 표시되며, 이러한 구성 요소의 활성화/비활성화(enabled) 제어가 제공됩니다.

• AR Session：session 자체의 활성화/비활성화를 제어합니다.
• Image Renderer：물리 카메라 이미지 렌더링의 활성화/비활성화를 제어합니다.
• Camera：가상 카메라의 활성화/비활성화를 제어합니다.
• Frame Source：frame source의 활성화/비활성화를 제어합니다. frame player가 활성화되지 않은 경우에만 제어할 수 있으며, frame player가 활성화되면 기능 제어는 EIF 재생 제어 부분으로 대체됩니다.
• Frame Filter：구체적인 AR 기능의 활성화/비활성화를 제어합니다.
• Frame Recorder：EIF 기록 구성 요소의 활성화/비활성화를 제어합니다. frame player가 활성화되지 않은 경우에만 표시되며, frame player가 활성화되면 이 구성 요소는 session에 조립되지 않습니다.

동시에 이 영역에는 session에서 사용 가능한 중심 모드와 session 보고서가 표시됩니다.

참고

도구에 표시된 사용 가능한 중심 모드와 session 보고서는 에디터에서 실행한 결과이며, 실제 기기에서 실행할 때는 다를 수 있습니다.

Mega 기능을 사용할 때 도구에 Mega 기능 구성 요소 제어가 표시됩니다.

관련 주제

• EIF 파일을 사용하여 시뮬레이션 실행을 시도하여 스크립트로 EIF 파일의 재생을 제어하세요.
• 스크립트에서 session 실행 제어를 시도하세요.
• 스크립트에서 AR 기능 구성 요소에 액세스를 시도하세요.
• 스크립트에서 session의 실행 결과 가져오기를 시도하세요.
• 스크립트에서 초기화를 시도하세요.
• 스크립트에서 session 보고서 가져오기 및 기기 지원 여부 판단을 시도하세요.
• session 검증 도구 Mega 제어 참조