Workflow_ARSession 예제 상세 설명
Workflow_ARSession은 경량형 AR 세션 관리 예제로, 최소한의 의존성으로 완전한 AR 애플리케이션 워크플로를 구축하는 방법을 보여줍니다. 이 예제는 AR Foundation 호환 모드와 간단한 모드를 동시에 지원하며, 프로젝트 요구에 따라 유연하게 선택할 수 있습니다.
사용 방법
씬 선택 (2중 1택)
Unity 에디터에서 Workflow_ARSession 씬은 상호 배타적인 두 개의 설정 루트 오브젝트를 포함합니다. 반드시 한 그룹만 활성화하세요(다른 그룹은 비활성 상태 유지):
| 설정 이름 | 적용 시나리오 | 의존성 |
|---|---|---|
ARFoundationCompatibleSceneSetup |
AR Foundation을 사용 중이거나 통합 예정인 프로젝트 | AR Foundation 설정 완료 필요 |
SimpleSceneSetup |
AR Foundation에 의존하지 않고 EasyAR 네이티브 기능 직접 사용 | 추가 의존성 없음, 경량 AR 앱에 적합 |
빌드 및 실행
Workflow_ARSession을 메뉴 바File>Build Settings또는Build Profiles>Scene List에 추가합니다.- 선택한 대상 플랫폼(Android 또는 iOS)에 따라
Project Settings>Player에서 빌드 옵션을 확인합니다. - 실제 기기로 빌드 후 실행합니다.
앱 실행 시 카메라가 자동 초기화되며 타겟 인식을 기다립니다.
타겟 인식 및 설정 방법
본 예제는 기본적으로 이미지 인식(Image Tracking) 기능을 시연하지만, 오브젝트 트래킹이나 클라우드 인식 등 다른 모드로 쉽게 확장 가능한 아키텍처를 가집니다.
기본 타겟: namecard.jpg
- 타겟 유형: 2D 이미지(권장 인쇄 크기 ≥ 90mm × 54mm)
- 다운로드 주소: 🔗 namecard
타겟 교체 방법?
- 이미지(JPG/PNG)를
Assets/Samples/EasyAR Sense Unity Plugin/[버전]/__All Samples__/Workflow/Workflow_ARSession/Targets에 넣습니다. - 씬의
ImageTarget-namecard컴포넌트를 선택한 후, Inspector의Image Target Controller (Script)에서Texture를 사용자 이미지로 변경합니다. Name과Scale을 수정합니다.Scale은 타겟의 물리적 크기(단위: 미터)로, 이미지의 긴 변을 기준으로 합니다.
- 저장 후 재빌드합니다.
예상 효과
카메라가 타겟 이미지에 정렬될 때 시스템은 다음을 수행합니다:
- 실시간으로 이미지를 감지 및 추적;
- 이미지 평면에 3D 팬더를 오버레이;
팬더의 위치, 방향, 스케일은 이미지 타겟의 포즈에 엄격히 결합됩니다. 이미지가 움직이거나 부분 가려짐, 조명 변화가 있어도 안정적으로 추적됩니다.
확장 제안
- 오브젝트 트래킹 추가:
ImageTracker를ObjectTracker로 교체하고.obj모델 파일 로드; - 클라우드 인식 연동: 로컬 타겟 목록 대신
CloudRecognizer사용; - 다중 타겟 지원: 단일 이미지 타겟에서 다중 이미지로 확장, 시스템이 자동으로 동시 추적 처리.
팁
더 많은 기능 컴포넌트는 AR 기능 컴포넌트를 참조하세요.
Workflow_ARSession을 통해 EasyAR의 핵심 워크플로를 빠르게 익히고 프로덕션급 AR 애플리케이션 구축의 기초로 활용할 수 있습니다.