Table of Contents

EasyAR Sense Unity Plugin 릴리스 노트

EasyAR Sense Unity Plugin 4000 출시를 발표하게 되어 기쁩니다. 이 버전은 EasyAR이 완비된 API와 시대에 맞는 디바이스 지원을 갖추었음을 의미하며, 새 버전이 예전보다 더 자주 출시될 것입니다.

이러한 새로운 기능과 개선 사항을 확인하려면 EasyAR Sense Unity Plugin 4000을 다운로드하세요.

이전 버전

버전 4002.0.0

릴리스 날짜: 2026-05-18

  • 🐛 Unity 6.4.4 Android 빌드 실패 문제를 수정했습니다.
  • 🔧 일부 예제 코드를 조정했습니다.
  • ⬆️ EasyAR Sense를 4.9.0으로 업데이트했습니다.

버전 4001.0.0

릴리스 날짜: 2026-03-10

  • 🐛 Native에서 Unity로의 pose 변환에 존재하는 수치 문제를 수정했습니다. 이 문제는 특정 디바이스에서 Mega를 사용할 때 짧은 시간 pose 점프가 발생하여 콘텐츠가 빠르게 깜빡이거나 떨리는 원인이 됩니다. 이 수정으로 다른 유사한 잠재적 문제도 해결될 수 있습니다.
  • 🔧 EasyAR Sense 인터페이스 변경에 맞춰 MegaTrackerFrameFilter의 일부 인터페이스를 조정했습니다.
  • ⬆️ EasyAR Sense를 4.8.0으로 업데이트했습니다.

버전 4000.0.1

릴리스 날짜: 2025-11-14

  • 🐛 수정: minify가 활성화된 Android 빌드에서 누락된 정적 메서드(loadLibraries, setupActivity)로 인해 발생할 수 있는 런타임 AndroidJavaException을 해결했습니다. 이 오류는 EasyAR이 실행되지 않게 만듭니다.

버전 4000.0.0

릴리스 날짜: 2025-10-20

이 버전부터 EasyAR Sense Unity Plugin은 Unity가 요구하는 패키지 버전 관리(Semantic Versioning 사용)를 따르므로, 버전 번호는 EasyAR Sense와 다를 수 있으며 릴리스 빈도도 달라질 수 있습니다. 이 버전의 플러그인에는 EasyAR Sense 4.7.0 정식 버전이 포함되어 있습니다.

EasyAR Sense Unity Plugin 4000.0.0은 큰 변화를 맞이했으며, 주로 다음 몇 가지 사항에 집중되어 있습니다:

  1. Unity 및 AR Foundation 호환성 변경

    이 버전부터 EasyAR Sense Unity Plugin은 Unity 2021.3 이상만 지원하며, Unity 6 지원도 완벽해졌습니다. 동시에 AR Foundation 지원이 플러그인 패키지 내로 병합되었으며, 이 버전은 AR Foundation 5 이상만 지원하고 사용법이 대폭 간소화되었습니다. 장면에 AR Foundation 구성 요소가 추가된 경우, 실행 후 AR Foundation이 최종적으로 사용되는지 여부와 관계없이 장면 구성과 스크립트 코드를 변경할 필요가 없습니다.

  2. 시대에 맞는 헤드셋 지원, 다수의 OST/VST 헤드셋 지원 추가

    업계 내 여러 기업과 수년간의 다듬기를 거쳐 EasyAR의 헤드셋 지원은 표준화되었습니다. 이제 EasyAR Sense Unity Plugin 확장을 통해 타사 헤드셋 디바이스 지원을 구현할 수 있습니다(헤드셋 제조사에서 일부 데이터 인터페이스를 제공해야 할 수 있음). 이 버전에는 Apple Vision Pro 및 XREAL Air2 Ultra 지원이 내장되어 있으며, EasyAR Sense Unity Plugin 확장 패키지를 통해 Pico 4 Ultra Enterprise 및 Rokid AR Studio를 지원합니다. 동시에 EasyAR의 일부 파트너로부터 다른 디바이스의 지원 확장 패키지(예: Xrany 元霓)를 가져올 수 있습니다.

  3. Unity 구성 요소 인터페이스 완비, ARSession 워크플로우 대폭 최적화

    이 버전은 Unity 구성 요소를 통해 EasyAR Sense 기능을 완전히 캡슐화한 첫 번째 버전입니다. ARSession은 대폭 최적화되고 다시 작성되었으며, 이제 디바이스 또는 기능 지원 여부를 쉽게 판단하고, 상황에 따라 ARSession을 시작하거나 중지하여 런타임에 ARSession 또는 다른 AR 기능을 전환할 수 있습니다. 동시에 ARSessionFactory를 사용하여 런타임에 ARSession 및 관련 구성 요소를 생성할 수 있습니다. 이 버전에는 관성 항법과 3DoF 카메라 기능도 추가되었으며, 이 기능은 주로 EasyAR Mega를 위해 설계되었지만 단독으로도 사용할 수 있습니다.

  4. 다수의 개발 및 진단 도구 추가

    이 버전은 완전히 새로운 EIF 녹화 및 재생 기능을 추가했습니다. 과거 버전에서도 EIF 녹화 및 재생이 가능했지만, EIF 사용이 이처럼 간단했던 적은 없습니다. 이제 Unity 에디터에서 진단 도구인 Session Validaion Tool을 사용하여 eif를 직접 재생하고 장면을 구동할 수 있으며, 이미지 추적, 공간 맵, EasyAR Mega 모두 PC에서 디바이스의 실행 효과를 재현할 수 있습니다. 이제 런타임 진단 패널인 EasyAR Diagnostics Panel을 사용하여 앱에서 eif 녹화 기능을 쉽게 켜거나, ARSession 및 해당 구성 요소의 주요 상태 정보 표시를 수시로 켜고 끌 수 있습니다. 동시에 이 버전의 샘플은 모두 다시 작성되었으며, 샘플을 실행하면 ARSession 상태와 eif 녹화 버튼을 바로 볼 수 있어 사용에 편리합니다.

  5. EasyAR Mega 도구 완전 공개

    이 버전은 Mega Studio 2.12을 통합하여 출시했습니다. 향후 플러그인 업데이트는 더욱 빈번해질 것이며, Unity 측 Mega 도구는 점진적으로 플러그인 내부로 병합되어 플러그인 정기 업데이트와 함께 발표될 것입니다. 과거 프리릴리스 버전의 업데이트 외에도, 이 버전은 기본적으로 관성 지원을 활성화하여 EasyAR Mega의 디바이스 지원을 대폭 확장했습니다. 이 버전은 최신 버전의 EasyAR Mega Landmark 서비스 지원도 포함합니다. EasyAR Mega 사용은 EasyAR 웹사이트 페이지를 통해 신청할 수 있습니다.

자세한 업데이트 내용은 다음과 같습니다:

Unity 및 AR Foundation 호환성 변경사항:

  • 🔧 Unity: Unity 2021.3 이상 버전 지원 (Unity 2022.x/Unity 6.x 포함)
    • 🔥 Unity 2019/Unity 2020 지원 중단
    • 🔥 Unity 2019용 gradle 버전 감지 기능 제거
    • 🔥 Unity 2019용 옵션 DisableARCoreAREngine 제거
  • ✨ Unity 6: Unity 6 완전 지원
    • ✨ URP 17+ 및 Render Graph 지원
    • 🐛 수정됨: Unity 6에서 ClassLoader 동작 변경으로 인한 ARCore 실패 문제
    • 🐛 수정됨: Render Scale이 1이 아닐 때 카메라 렌더링 실패 문제
    • 🐛 Unity 6 자체 BUG: iOS/Mac 기기에서 카메라 텍스처를 가져올 필요가 있는 경우 시각적 오류 및 아티팩트가 관찰될 수 있음. 이 문제를 부분적으로 완화하는 조치를 추가했으나 완전히 제거할 수 없음. Unity에 보고됨 - Unity Issue UUM-87787 참조. Unity 6.2 이상에서는 Universal Render Pipeline Asset의 Render Scale을 0.96-1.05 범위 밖의 값으로 설정하여 이 문제를 회피할 수 있음.
    • 🐛 Unity 6 자체 BUG: Windows DX11에서 렌더링이 올바르지 않음. Unity 6.0-6.1에서 완화 조치를 추가함. 테스트 결과 Unity 6.2에서 수정됨.
  • ✨ AR Foundation: AR Foundation 5 이상 버전 지원, 사용이 크게 간소화됨
    • ✨ AR Foundation 지원이 플러그인 패키지 내부로 통합됨. 별도 패키지 임포트 불필요 (특별한 경우 구성 옵션으로 비활성화 가능)
    • ✨ Unity.XR.CoreUtils.XROrigin을 ARSession의 원점으로 재사용 지원, XROrigin의 카메라 재사용 지원
    • ✨ Unity XR Auto Switch 구성 옵션 추가. 기본적으로 Unity XR (AR Foundation 포함) 객체 전환 처리
    • ✨ EasyAR 메뉴로 생성된 ARSession은 자동으로 AR Foundation 지원을 포함하고 기본적으로 활성화됨
    • ✨ 대부분의 샘플에 AR Foundation 지원 추가됨 (AR Foundation 자체는 수동 임포트 및 올바른 구성 필요)
    • 🔧 ARCore 및 ARKit을 개별적으로 제어 가능. EasyAR 내장 ARCore/ARKit과 AR Foundation의 ARCore/ARKit 간 우선순위 제어 가능
    • 🔥 AR Foundation 4 지원 중단
    • 🔥 ARSessionOrigin 지원 중단, XROrigin만 지원
    • 🔥 AR Foundation의 ARCore 설치 절차를 대행하는 기능 제거
  • ✨ Input System Package 완전 호환

최신 헤드셋 지원을 통한 진화, 다양한 OST/VST 헤드셋 지원 추가:

  • 🚀 헤드 마운트 디스플레이(HMD) 인터페이스 안정화, 제3자 접근 지원
    • ✨ 제3자 기기 접근 지원 (헤드셋 제조사별 특정 데이터 인터페이스 필요)
    • ✨ XROrigin 및 XR Interaction Toolkit 지원
    • ✨ 모든 헤드셋 예제 단순화 및 통일, 코드 제로, 기능 전환 지원
    • ✨ 어안 렌즈(fisheye) 카메라 입력 지원
    • ✨ 사용자 정의 카메라 입력 3DOF 데이터 지원
    • ✨ 메뉴 기능 추가: Extensions, 모든 확장 메뉴 항목 통합
    • 🐛 특정 헤드셋에서 DenseSpatialMap 실행 시 발생하던 렌더링 오류 수정
    • 🔥 ActionOne 및 BT350 등 구형 안경 샘플 제거
  • ✨ Apple Vision Pro 내장 지원
    • ✨ Metal, RealityKit 및 Hybrid 모드 지원
    • ✨ visionOS >= 2.0 지원, visionOS 26 지원
  • ✨ XREAL Air2 Ultra 내장 지원 (XREAL SDK >= 3.1 필요)
    • ✨ 별도의 지원 패키지 임포트 불필요
    • ⚡ XREAL에서의 실행 성능 최적화
    • 🔥 XREAL Light 지원 중단
  • ✨ EasyAR Sense Unity Plugin 확장 배포를 통한 Pico, Rokid 등 기타 기기 지원
    • ✨ 제3자 기기 접근 참조 템플릿 제공 com.easyar.sense.ext.hmdtemplate
    • ✨ Pico 4 Ultra Enterprise 지원 (PICO Unity Integration SDK >= 3.1 필요)
    • ✨ Rokid AR Studio 지원 (Rokid Unity OpenXR Plugin >= 3.0.3 필요)
    • ✨ 이 확장들은 향후 여러 버전의 EasyAR Sense Unity Plugin을 지원할 예정
  • ✨ EasyAR XR License 지원
    • 🔧 헤드셋에서 EasyAR 사용 시 EasyAR XR License 필요 및 최초 인터넷 연결 보장 (체험판은 매번 연결 필요)

Unity 컴포넌트 인터페이스 개선, ARSession 워크플로우 대폭 최적화:

  • 🚀 Unity 컴포넌트 레이어 캡슐화 개선
    • ✨ 장면 컴포넌트 개선, 모든 EasyAR Sense 기능 제공
    • 🔥 컴포넌트를 통해 캡슐화된 모든 EasyAR Sense 레이어 인터페이스 제거
    • 🔥 모든 내부 인터페이스 제거
  • ✨ ARSession: 재작성 및 워크플로우 대폭 최적화
    • ✨ 언제든지 세션 시작 및 중지 지원
    • ✨ 세션 자동 시작 제어 지원
    • ✨ 화면이 검게 변하지 않고 세션 기능 및 입력 소스 전환 지원
    • ✨ 장치 지원 판단 단순화, 일관된 인터페이스로 제공
    • ✨ 시작 시 MotionTracker, ARCore, AR Engine의 장치 지원 목록 업데이트
    • ✨ 장치 목록 업데이트 후 세션 자동 재시작 지원
    • ✨ 상세 세션 손상 정보 획득 지원
    • ✨ 세션 내부 상태 자체 진단 추가
    • 🔥 ARComponentPicker 제거, 해당 기능은 다른 세션 워크플로우로 대체
    • 🔥 다중 ARSession 동시 실행 금지
  • ✨ ARSessionFactory: 런타임에 ARSession 및 관련 컴포넌트 생성 기능 제공
    • ✨ ARSessionFactory를 통해 에디터 메뉴와 동일한 세션을 런타임에 생성 지원
    • ✨ 프레임 소스 정렬 기능 추가 (메뉴 항목 포함)
  • ✨ FrameSource: 관성 내비게이션 및 3DoF 지원 추가
    • ✨ 관성 내비게이션 지원을 위한 InertialCameraDeviceFrameSource 추가
    • ✨ 3DoF 카메라 지원을 위한 ThreeDofCameraDeviceFrameSource 추가
    • ✨ 메뉴 기능 추가: Frame Source by Transform Type, 모든 내장 프레임 소스 목록 제공
    • ⚡ 인스펙터 옵션 최적화
  • ✨ 기타 인터페이스 조정 및 기능 업데이트
    • ✨ Texture2D를 사용하여 ImageTarget 생성 기능 추가
    • ✨ 이미지 유형 데이터(카메라 이미지 또는 타겟 이미지 등) 렌더링을 위한 ImageMaterial 추가
    • ✨ GameObject의 active를 제어하고 관련 로직을 통합하는 ActiveController 추가
    • ✨ 데스크톱에서 화면 회전 시뮬레이션 기능 추가
    • ✨ XROriginChildController 추가, 세션 원점 아래 오브젝트의 동작 제어
    • 🔥 WorldRootController 제거
    • 🔧 스파스 공간 맵 인터페이스를 Builder와 Tracker 두 개의 기능 컴포넌트로 분할
    • 🔧 EasyARController 조정, 애플리케이션/시스템 수준 정적 기능 제공
    • 🔧 타겟 컴포넌트 인터페이스 통일
    • 🔧 서비스 데이터 접근 인터페이스 통일

추가된 여러 개발 및 진단 도구:

  • 🚀 편집 시 진단 도구 추가: Session Validation Tool
    • ✨ 어느 시나리오에서든 eif 재생 간소화
    • ✨ eif 재생 흐름 제어 지원
    • ✨ 세션 흐름 제어 지원
  • 🚀 런타임 진단 패널 추가: EasyAR Diagnostics Panel
    • ✨ Developer Mode 스위치 추가, 기본적으로 화면 8회 탭으로 Diagnostics Panel 켜기/끄기 가능, 온라인 앱에서 eif 녹화 및 문제 피드백 간소화
    • ✨ 커스텀 Developer Mode 스위치 지원, 사용자 정의 상호작용으로 Diagnostics Panel 제어
    • ✨ eif 녹화 제어 지원
    • ✨ 세션 정보 표시 제어 지원
    • ✨ eed 녹화 제어 지원
  • ✨ 완전히 새로운 EIF 녹화 및 재생 기능 추가
    • ✨ FrameRecorder가 자동으로 ARSession에 조립되어 수동 선택 불필요
    • ✨ FrameRecorder가 기본적으로 자동 파일명 생성하여 스크립트 없이 사용 지원
    • ✨ 새로운 형식으로 녹화된 데이터를 사용하는 FramePlayer는 재생 건너뛰기 및 속도 조절 지원, 파일 크기 감소
    • 🔧 컴퓨터에서 eif를 사용하여 장면 및 AR 기능 구동 지원 (신규 기능 아님)
  • ✨ DiagnosticsController 추가, 진단 기능 통합 및 최적화
    • ✨ 정보 등급별 표시 및 제어 추가, 기본적으로 모든 오류 및 경고 메시지가 UI 통해 표시됨
    • ✨ ARSession 및 그 구성 요소의 핵심 상태 정보 표시 기능 추가, 기본적으로 UI 통해 표시되며 매 프레임 업데이트됨
    • 🔧 진단 기능을 사용하여 문제 피드백 정보 획득 간소화
    • 🔥 GUIPopup 삭제
  • 🔧 예외 상태 동작 및 오류 메시지 표시 최적화
    • 🔧 사용 가능한 frame source 없음 시 오류 메시지 최적화
    • 🔧 URP 환경에서 AR Foundation 또는 헤드셋 렌더링 카메라 대신 EasyAR 사용 시, RendererFeature가 올바르게 구성되지 않으면 오류 발생 및 ARSession 실행 중단
    • 🔧 Origin의 기본 Active 제어 전략 수정, 트래킹 손실 시 콘텐츠가 사라지지 않고 화면에 고정됨
    • 🔧 커스텀 카메라 또는 헤드셋에서 평가판 제품 사용 시, 제한 시간 도달 시 효과 오판 방지를 위해 모든 콘텐츠 숨김
  • 🔧 구성 페이지 내용 및 옵션 최적화
    • ✨ EasyAR Sense 라이브러리 변종 선택 지원
    • 🔒 애플리케이션 권한 부분에서 카메라 권한 외 나머지 권한은 변경 불가, EasyAR Sense 라이브러리 변종 및 Mega 활성화 여부에 따라 결정됨
    • 🔧 기능 및 서버 구성이 EasyAR 기능별로 그룹화됨
    • 🔧 타사 AR SDK 구성 통합 관리
    • 🔧 Unity용 Workaround 구성 통합 관리

EasyAR Mega 도구 전체 공개:

  • 🚀 전체 공개, 동기화 업데이트
    • ✨ 통합 릴리스 Mega Studio 2.12
    • 🔧 Unity 측 Mega 도구는 점진적으로 플러그인 내부로 병합되며, 향후에도 최신 버전의 통합 패키지만 제공될 예정이지만, EasyAR Sense Unity Plugin의 정기 업데이트와 병합되어 릴리스됩니다.
    • 🔧 EasyAR Mega는 여전히 EasyAR 웹사이트 페이지를 통해 신청하고 승인을 받아야 사용 가능합니다.
  • ✨ 새로운 지원 EasyAR Mega Landmark
  • ✨ 새로운 지원 5DOF 관성 내비게이션 및 기본 활성화, EasyAR Mega의 장치 지원 범위를 더욱 크게 확장
  • ✨ 새로운 지원 API Token을 통한 Mega 서비스 접근
  • 🔧 Mega 효과 및 개발 경험 최적화 (과거 업데이트된 4.7.x 버전 내 포함)
    • ✨ 지원 3DOF 순수 회전 모드 및 0DOF 모드 (기본 비활성화)
    • ✨ 에디터 진단을 위한 EditorCameraDeviceFrameSource 추가, 불완전한 샘플 복사로 인한 휴대폰에서의 오작동 방지
    • ✨ Mega 사용 시 구버전 eif 데이터 녹화 시, FrameRecorder가 자동으로 .eif.json 파일 생성
    • 🔧 원격 디버깅의 퇴화 옵션 대신 LocationInputMode 사용
    • 🔧 트래킹 없는 모드를 독립 컴포넌트로 분리, 일반적으로 더 이상 사용하거나 주의할 필요 없음
    • 🔧 BlockRootSource 옵션 추가, 기본 구성에서 BlockRoot 설정을 잊어버리면 오류 발생
    • 🔧 다중 block에 위치할 때의 기본 동작 조정, 다중 block이 기본적으로 사용되지 않도록 보장
    • 🔧 일부 인터페이스 명칭 조정
    • 🔧 세션에 Mega가 포함되어 있으나 사용할 수 없을 때 더 명확한 예외 발생
    • 🔧 Mega가 지원하는 MotionTracker의 최소 QualityLevel을 Limited로 조정
    • 🐛 CloudLocalizerStatus.WakingUp 상태가 올바르게 이스케이프되지 않아 발생하던 런타임 오류 수정
    • 🔧 일부 최적화 및 수정 사항은 EasyAR Sense의 업데이트 로그 참조

샘플 재작성 및 최적화:

  • ✨ 모든 샘플 다시 작성
    • ✨ 다양한 Input System 구성과 호환
    • ✨ URP17+와 호환
    • ✨ AR Foundation 사용과 호환
    • 🔧 AR Foundation 미사용과 호환
    • 🔧 AR Foundation 지원이 없는 소량의 샘플 유지
    • ⚡ 스크립트 및 인터페이스 호출 최적화
    • 🚚 일부 샘플 이름 변경
    • 🔧 샘플 내 모델 및 비디오 등 리소스 교체
    • ⚡ streaming assets 사용 감소, 특정 기능을 보여주는 샘플에서만 사용 및 임포트
    • ✨ Texture2D를 사용하여 ImageTarget 생성
  • ✨ 새로운 기능 및 인터페이스 데모 추가
    • ✨ Workflow_ARSession 샘플 추가: session 기본 워크플로우 및 디바이스 지원 학습용
    • ✨ Workflow_FrameSource_ExternalImageStream 샘플 추가: 비디오를 커스텀 카메라로 사용 (헤드셋에는 사용 불가)
    • ✨ Combination_BasedOn_MotionTracking 샘플 추가: 모션 트래킹 사용 가능 시 다양한 기능 사용, 전환 및 AR Foundation 전환 학습용
    • ✨ Combination_BasedOn_AppleVisionPro 샘플 추가: Apple Vision Pro에서 다양한 기능 사용 및 전환 데모
    • ✨ Combination_BasedOn_Xreal 샘플 추가: XREAL 디바이스에서 다양한 기능 사용 및 전환 데모
    • ✨ 여러 Mega 샘플 추가 (과거 4.7.x 업데이트에 포함됨)
    • ✨ Workflow_FrameSource_CameraDevice에 카메라 해상도 전환 및 토치 모드 기능 추가
    • 🔥 별도의 AR Foundation 샘플 제거: 기능이 다른 샘플에 포함됨
    • 🔥 FrameRecording 샘플 제거: 기능이 다른 샘플에 포함됨
    • 🔥 MotionTracking_Fusion 샘플 제거: 기능이 Combination_BasedOn_MotionTracking에 포함됨
    • 🔥 SurfaceTracking_ImageTarget 샘플 제거: 기능 조합은 여전히 쉽게 구현 가능
    • 🔥 Camera_CustomCamera 샘플 제거: 필요 시 직접 구현 가능
    • 🔥 ActionOne 및 BT350 등 구형 안경 샘플 제거
  • ✨ eif 녹화 및 재생 사용 간소화
    • ✨ 모든 샘플에 eif 녹화 버튼 추가, 녹화된 eif 파일은 에디터 내에서 사용 가능
  • ✨ 런처 재작성, 샘플 설명 포함
    • 🐛 런처를 통해 샘플 씬 로드 시 어두워지는 문제 수정

EasyAR 및 서드파티 AR 기능 통합:

  • ⬆️ EasyAR Sense 4.7.0 정식 버전으로 업데이트
  • ⬆️ EasyAR AR Engine Interop 업데이트
  • ⬆️ ARCore SDK 1.46.0으로 업데이트
  • 🔧 AR Engine을 합리적으로 실행할 수 없는 일부 폰에서 AR Engine 비활성화
  • 🐛 Unity 6에서 ClassLoader 동작 변경으로 인한 ARCore 실패 문제 수정

관련 주제