Table of Contents

AllSamplesLauncher를 사용하여 EasyAR 샘플 빠르게 체험하기

AllSamplesLauncher는 통합 샘플 런처로, EasyAR SDK의 다양한 기능을 빠르게 익히는 데 도움을 줍니다. 이 런처를 통해 단일 Unity 프로젝트에서 모든 공식 샘플 씬을 한 번의 클릭으로 전환하고 실행할 수 있으며, 여러 개별 프로젝트를 수동으로 구성할 필요가 없습니다.

사전 준비

시작하기 전에 다음 사항을 준비했는지 확인하세요:

  1. Unity Hub와 Unity 에디터 설치 완료
  2. 새 Unity 프로젝트 생성
  3. EasyAR Sense Unity Plugin을 가져오고 모든 Samples를 가져옴

빠른 시작의 안내를 참고하여 단계별로 진행하세요.

상세 단계

  1. Samples의 모든 씬을 엽니다.
    All Sample Scenes
  2. 메뉴 바에서 File > Build Settings 또는 Build Profiles > Scene List를 클릭합니다.
  3. 모든 씬을 Scene List로 드래그합니다.
  4. AllSamplesLauncher가 모든 씬 중 첫 번째에 위치하도록 합니다. 그렇지 않은 경우 창 내에서 드래그하여 조정합니다.
    Scene List Order
  5. 메뉴 바에서 File > Build And Run을 클릭하여 빌드 및 실행합니다.
참고

모바일로 빌드할 때 헤드셋 관련 씬은 추가하지 마세요:

  • Combination_BasedOn_AppleVisionPro
  • Combination_BasedOn_Xreal
    Donot Load Headset

빌드 중 문제 발생

컴파일 또는 빌드 과정에서 다음과 같은 오류가 발생할 수 있습니다. 일반적인 문제는 다음과 같습니다:

오류 메시지 원인 해결 방법
FileNotFoundException:EasyAR Settings Asset 라이선스 미입력 메뉴 바에서 EasyAR > Sense > Configuration을 클릭하고, EasyAR Sense License에 License Key를 입력하세요
Missing Prefab Asset: 'XR Interaction Setup' 헤드셋 관련 파일 누락 빌드 씬 목록에서 헤드셋 관련 씬을 삭제하세요. 헤드셋 빌드가 필요한 경우 헤드셋 샘플 사용의 단계를 따르세요

런처 사용

실행 후 간결한 런처 인터페이스가 표시됩니다.

Lanucher Homepage

화면 하단 중앙의 Samples 버튼을 클릭하면 모든 기능의 샘플로 이동합니다.

Lanucher Samplepage

화면 왼쪽은 기능 분류, 오른쪽은 각 기능의 씬 샘플 목록입니다. 다른 샘플 씬을 클릭하면 EasyAR이 제공하는 모든 기능을 체험할 수 있습니다.

화면 하단에는 EasyAR Sense와 EasyAR Mega의 기능 데모 동영상이 제공되어, EasyAR이 제공할 수 있는 기능과 효과를 더 잘 이해하는 데 도움이 됩니다.

샘플 실행 전 필독 사항

특정 샘플을 실행하기 전에 다음 핵심 설정을 반드시 완료해야 합니다. 그렇지 않으면 샘플이 정상 작동하지 않습니다:

  1. API Key 설정

    • 일부 샘플(특히 클라우드 인식, Mega 클라우드 위치 지정 등)은 유효한 API Key가 필요합니다.
    • 메뉴 바에서 EasyAR > Sense > Configuration을 클릭하고, 해당 샘플에 필요한 항목을 찾습니다.
    • EasyAR 개발자 센터에서 신청한 App ID, API Key, API Secret을 입력하세요.
      Key Configuration
    • 중요: 아직 API Key가 없는 경우, 일부 로컬 기능 샘플(예: 이미지 트래킹)은 실행될 수 있지만 클라우드 기능은 실패합니다. 반드시 EasyAR 개발자 센터에서 애플리케이션을 생성하고 Key를 획득하세요.

  2. XR/플랫폼 지원 구성:

    • 헤드셋 관련 샘플을 실행하는 경우 헤드셋 샘플 사용을 참고하세요.
    • 기기(휴대폰 또는 헤드셋)가 올바르게 연결되고 개발자 모드인지 확인하세요.

샘플 심화 탐구

샘플 런처는 학습에 가장 좋은 시작점입니다. 다음을 강력히 권장합니다:

  • 먼저 실행하고, 그 후 분석하세요: 런처를 통해 각 샘플의 효과를 빠르게 체험하여 EasyAR의 기능에 대한 직관적인 인상을 형성하세요.
  • 씬 소스 파일 열기: 각 샘플은 Assets/Samples/EasyAR Sense Unity Plugin/[버전]/__All Samples__/[기능 이름]/[샘플 이름]/Scenes 디렉터리에 있는 독립된 Unity 씬 파일입니다.
  • 스크립트 코드 연구 및 분석: 샘플 씬에서 샘플에 포함된 *.cs 스크립트를 열어 특정 기능을 구현하기 위해 EasyAR API를 호출하는 방법을 확인할 수 있습니다. 이는 API 사용법을 배우는 최적의 방법입니다.

샘플 런처를 통해 EasyAR SDK의 기능을 빠르게 파악할 수 있습니다. 즐거운 탐구 되세요!