Table of Contents

Release notes плагина EasyAR Sense Unity

Мы рады объявить о выпуске EasyAR Sense Unity Plugin 4000. Этот релиз означает, что EasyAR получил зрелые API и современную поддержку устройств, а новые версии теперь будут выходить чаще, чем раньше.

Скачайте EasyAR Sense Unity Plugin 4000, чтобы воспользоваться этими новыми возможностями и улучшениями.

История версий

Версия 4003.1.1

Дата выпуска: 2026-09-07

  • 🚀 Добавлено расширение EasyAR Sense Unity Plugin Meta XR с поддержкой Meta Quest 3/3S
  • 🐛 Исправлена проблема, из-за которой input extensions нельзя было использовать, когда DeviceOriginType был OriginType.External
  • 🔧 AR session больше не завершается ошибкой запуска, когда облачный сервис Mega настроен как отключенный

Версия 4003.1.0

Дата выпуска: 2026-08-20

  • ✨ Добавлена поддержка Mega Go
  • ✨ Добавлена поддержка интерфейса ARSession.InputFrameUpdate на headset, чтобы получать не realtime camera data во время работы на headset
  • 🐛 Исправлена проблема, из-за которой запуск EIF при старте session мог приводить к сбою позиционирования Mega
  • ⬆️ Обновлен EasyAR Sense до 4.10.0
  • ⬆️ Обновлен EasyAR Sense Unity Plugin PICO Extension до 4000.1.0
    • ✨ Добавлена поддержка пользовательских устройств PICO 4 Ultra, PICO Space Pro и совместимость с будущими устройствами PICO
    • 💥 Интерфейсы enterprise devices PICO заменены интерфейсами пользовательских устройств, поэтому на enterprise устройствах больше не требуется enterprise authorization от PICO

Версия 4003.0.0

Дата выпуска: 2026-07-01

  • 🚀 Полностью новый workflow разработки Mega
    • ✨ Интерфейсы Mega и workflow разработки стали ближе к традиционным AR-функциям, таким как image tracking
    • ✨ Добавлен компонент MegaBlockController, заменяющий прежнюю группу nodes, создаваемую Mega Studio
    • ✨ Session validation tool поддерживает больше практичных опций управления Mega
    • ✨ Включение функций Mega теперь управляется глобальным configuration switch
    • 💥 Runtime больше не требует жесткой зависимости от com.easyar.mega; com.easyar.mega теперь предоставляет только editor и ema функции
    • 🔥 Удалены опции multi block и block root node; каждый block теперь независим
    • 🔥 Удалена editor test area MegaTrackerFrameFilter, поскольку эту функцию полностью заменил session validation tool
  • 🐛 Исправлена проблема более темной scene при использовании sample в Unity 6 и выше
  • 🐛 Исправлены ошибки компиляции некоторых скриптов в Unity 6.4 URP
  • 🐛 Исправлена невозможность сохранить изменения advanced options в MotionTrackerFrameFilter в editor
  • ⬆️ Обновлен пакет поддержки EasyAR Mega до 2.13.0
    • 🚚 Старый com.easyar.mega разделен на два пакета: com.easyar.mega (пакет поддержки Mega) и com.easyar.mega.studio (Mega Studio). Mega Studio больше не поддерживает использование в Unity development
    • 🚚 Часть интерфейсов перенесена из namespace EasyAR.Mega.Scene в EasyAR.Mega
    • ✨ Поддержка международного сервиса Mega
    • ✨ Поддержка функции panorama preview в editor play mode
    • ✨ Поддержка просмотра block data в prefab view
    • ✨ Разрешена свободная rotation block в editor
    • ✨ Обязательный показ gizmo границы mesh при ошибке загрузки
    • 🔥 Удалена поддержка block data, созданных mapping service версии 9.3 и более ранней
    • 🔥 Удалена поддержка localization service версии 2.0 и более ранней
    • 🔥 Удалена поддержка ema 0.3-0.4
    • 🔥 Удалена поддержка annotation node в scene
  • ⬆️ Обновлены EasyAR Sense Unity Plugin Extensions до 4000.0.1
    • 🔧 Настроены Mega-компоненты в sample scene

Версия 4002.0.0

Дата выпуска: 2026-05-18

  • 🐛 Исправлен сбой Android build в Unity 6.4.4.
  • 🔧 Скорректирован часть sample code.
  • ⬆️ Обновлен EasyAR Sense до 4.9.0

Версия 4001.0.0

Дата выпуска: 2026-03-10

  • 🐛 Исправлена численная проблема в преобразовании pose из native в Unity. Из-за нее на некоторых устройствах при использовании Mega могли возникать кратковременные прыжки pose, что вызывало быстрое мерцание или дрожание контента. Это исправление также может устранить и другие похожие потенциальные проблемы.
  • 🔧 Скорректирована часть интерфейсов MegaTrackerFrameFilter для соответствия изменениям интерфейсов EasyAR Sense
  • ⬆️ Обновлен EasyAR Sense до 4.8.0

Версия 4000.0.1

Дата выпуска: 2025-11-14

  • 🐛 Исправлено: устранена потенциальная runtime ошибка AndroidJavaException в Android build с minify из-за отсутствия static methods (loadLibraries, setupActivity), которая могла приводить к неработоспособности 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 и более новые версии, при этом использование было значительно упрощено. Если в scene добавлены компоненты AR Foundation, независимо от того, будет ли AR Foundation в итоге использоваться во время runtime, конфигурацию scene и код скриптов можно не менять.

  2. Более современная поддержка headset, включая несколько новых OST/VST headset

    После многих лет доработки вместе с рядом компаний отрасли поддержка headset в EasyAR была стандартизирована. Теперь вы можете добавить поддержку сторонних headset через EasyAR Sense Unity Plugin extension (может потребоваться часть data interface от производителя headset). В этот релиз встроена поддержка Apple Vision Pro и XREAL Air2 Ultra, а также поддержка Pico 4 Ultra Enterprise и Rokid AR Studio через EasyAR Sense Unity Plugin extension. Также вы можете получить другие extension packages поддержки устройств от партнеров EasyAR, например Xrany 元霓.

  3. Улучшение Unity component interfaces и значительная оптимизация workflow ARSession

    Этот релиз - первая версия, полностью оборачивающая функции EasyAR Sense через Unity components. ARSession была значительно оптимизирована и переписана, и теперь вы можете легко определять поддержку устройства или функции, а также запускать или останавливать ARSession в зависимости от ситуации, чтобы реализовать runtime switching между ARSession или разными AR-функциями. Вы также можете использовать ARSessionFactory для создания ARSession и связанных компонентов во время runtime. В этот релиз также добавлены inertial navigation и 3DoF camera, в первую очередь для EasyAR Mega, но их можно использовать и отдельно.

  4. Новые инструменты разработки и диагностики

    В этот релиз добавлены совершенно новые EIF recording и playback. Хотя EIF recording и playback можно было использовать и в прошлых версиях, теперь это стало гораздо проще. Теперь в Unity Editor можно использовать Session Validaion Tool для прямого воспроизведения EIF и управления scene, независимо от того, идет ли речь об image tracking, spatial map или EasyAR Mega, чтобы воспроизводить поведение устройства на компьютере. В приложении можно использовать runtime diagnostic panel EasyAR Diagnostics Panel, чтобы легко включать EIF recording или в любой момент включать и выключать ключевую status information ARSession и ее компонентов. Кроме того, sample в этой версии полностью переписан, поэтому при запуске sample сразу видны статус ARSession и кнопки записи EIF, что упрощает использование.

  5. Полностью открыт инструмент EasyAR Mega

    В этот релиз включен Mega Studio 2.12. В дальнейшем обновления плагина будут выходить чаще, а инструменты Mega на стороне Unity будут постепенно объединяться с плагином и выходить вместе с обычными обновлениями. Помимо изменений из предыдущих prerelease версий, в этом релизе inertial navigation включена по умолчанию, что еще сильнее расширяет поддержку устройств EasyAR Mega. Этот релиз также включает поддержку последней версии сервиса Mega Landmark. Подать заявку на использование EasyAR Mega можно через страницу сайта EasyAR.

Подробности обновлений ниже:

Изменения совместимости Unity и AR Foundation:

  • 🔧 Unity: поддерживается Unity 2021.3 и новее, включая Unity 2022.x/Unity 6.x
    • 🔥 Удалена поддержка Unity 2019/Unity 2020
    • 🔥 Удалена проверка версии gradle для Unity 2019
    • 🔥 Удалена опция DisableARCoreAREngine для Unity 2019
  • ✨ Unity 6: полная поддержка Unity 6
    • ✨ Поддерживаются URP 17+ и Render Graph
    • 🐛 Исправлено: сбой ARCore из-за изменения поведения ClassLoader в Unity 6
    • 🐛 Исправлено: сбой рендеринга камеры, когда Render Scale не равен 1
    • 🐛 Ошибка Unity 6: на устройствах iOS/Mac могут наблюдаться визуальные сбои и артефакты. Проблема возникает только при необходимости получать текстуры камеры. Мы добавили частичные меры обхода, но не можем полностью устранить ее. Проблема отправлена в Unity, см. Unity Issue UUM-87787. В Unity 6.2 и выше ее можно обойти, установив Render Scale в Universal Render Pipeline Asset в значение вне диапазона 0.96-1.05.
    • 🐛 Ошибка Unity 6: некорректный рендеринг на Windows DX11. Мы добавили меры обхода в Unity 6.0-6.1. По тестам Unity 6.2 исправляет эту проблему.
  • ✨ AR Foundation: поддерживается AR Foundation 5 и новее, использование значительно упрощено
    • ✨ Поддержка AR Foundation объединена в пакет плагина, отдельный импорт пакета больше не нужен. При особых требованиях ее можно отключить в настройках.
    • ✨ Поддерживается повторное использование Unity.XR.CoreUtils.XROrigin как начала ARSession и повторное использование Camera из XROrigin
    • ✨ Добавлена опция конфигурации Unity XR Auto Switch, которая по умолчанию обрабатывает переключение объектов Unity XR, включая AR Foundation
    • ✨ ARSession, созданный через меню EasyAR, автоматически включает поддержку AR Foundation и включает ее по умолчанию
    • ✨ Большинство sample теперь имеют поддержку AR Foundation, при этом сам AR Foundation нужно импортировать и корректно настроить вручную
    • 🔧 ARCore и ARKit можно управлять отдельно, а также управлять приоритетом между встроенными EasyAR ARCore/ARKit и AR Foundation ARCore/ARKit
    • 🔥 Удалена поддержка AR Foundation 4
    • 🔥 Удалена поддержка ARSessionOrigin, поддерживается только XROrigin
    • 🔥 Удалено прокси-выполнение процесса установки ARCore из AR Foundation
  • ✨ Полная совместимость с Input System Package

Поддержка гарнитур развивается, добавлена поддержка нескольких OST/VST-гарнитур:

  • 🚀 Интерфейс head-mounted display device стабилен и поддерживает стороннюю интеграцию
    • ✨ Поддерживает интеграцию сторонних устройств, requiring headset manufacturers to provide specific data interfaces
    • ✨ Supports XROrigin and XR Interaction Toolkit
    • ✨ Simplified and unified all headset samples, zero code, with feature switching support
    • ✨ Supports fisheye camera input
    • ✨ Supports custom camera input 3DOF data
    • ✨ Added menu feature: Extensions, integrating all extension menu items
    • 🐛 Fixed rendering anomalies when running DenseSpatialMap on some headsets
    • 🔥 Removed old glasses samples such as ActionOne and BT350
  • ✨ Built-in support for Apple Vision Pro
    • ✨ Supports Metal, RealityKit, and Hybrid modes
    • ✨ Supports visionOS >= 2.0 and visionOS 26
  • ✨ Built-in support for XREAL Air2 Ultra, requiring XREAL SDK >= 3.1
    • ✨ No need to import a separate support package
    • ⚡ Optimized runtime effects on XREAL
    • 🔥 Removed XREAL Light support
  • ✨ Distributes support for other devices such as Pico and Rokid through EasyAR Sense Unity Plugin extensions
    • ✨ Provides a reference template for third-party device integration, com.easyar.sense.ext.hmdtemplate
    • ✨ Supports Pico 4 Ultra Enterprise, requiring PICO Unity Integration SDK >= 3.1
    • ✨ Supports Rokid AR Studio, requiring Rokid Unity OpenXR Plugin >= 3.0.3
    • ✨ These extensions will support multiple future versions of EasyAR Sense Unity Plugin
  • ✨ Поддерживает EasyAR XR License
    • 🔧 Using EasyAR on headsets requires EasyAR XR License and the first network connection must be available. The trial requires network access every time

Улучшены Unity component interfaces и значительно оптимизирован workflow ARSession:

  • 🚀 Улучшена инкапсуляция Unity component layer
    • ✨ Улучшены scene components, предоставляющие все EasyAR Sense features
    • 🔥 Удалены все EasyAR Sense layer interfaces, инкапсулированные через components
    • 🔥 Удалены все internal interfaces
  • ✨ ARSession: workflow переписан и значительно оптимизирован
    • ✨ Поддерживает запуск и остановку session в любой момент
    • ✨ Поддерживает automatic session startup control
    • ✨ Поддерживает переключение session features и input sources без black screen
    • ✨ Упрощает device support judgment и предоставляет его через единый interface
    • ✨ При startup обновляет device support lists для MotionTracker, ARCore и AR Engine
    • ✨ Поддерживает automatic session restart после обновления device list
    • ✨ Поддерживает получение detailed session corruption information
    • ✨ Добавлен session internal state self-check
    • 🔥 Удален ARComponentPicker. Его функции заменены другими session flows
    • 🔥 Запрещен одновременный запуск нескольких ARSession
  • ✨ ARSessionFactory: предоставляет runtime creation для ARSession и связанных components
    • ✨ Поддерживает создание такой же session, как в editor menu, во время runtime через ARSessionFactory
    • ✨ Добавлена Frame Source sorting feature, включая menu item
  • ✨ FrameSource: добавлена поддержка inertial navigation и 3DoF
    • ✨ Добавлен InertialCameraDeviceFrameSource для поддержки inertial navigation
    • ✨ Добавлен ThreeDofCameraDeviceFrameSource для cameras с поддержкой 3DoF
    • ✨ Добавлена menu feature: Frame Source by Transform Type, предоставляющая список всех встроенных FrameSource
    • ⚡ Оптимизированы Inspector options
  • ✨ Другие изменения interfaces и feature updates
    • ✨ Добавлена feature создания ImageTarget с использованием Texture2D
    • ✨ Добавлен ImageMaterial для рендеринга данных типа Image, например camera images или Target images
    • ✨ Добавлен ActiveController для управления GameObject active и унификации связанной control logic
    • ✨ Добавлена feature симуляции screen rotation на desktop
    • ✨ Добавлен XROriginChildController для управления behavior объектов под Session origin
    • 🔥 Удален WorldRootController
    • 🔧 Sparse spatial map interfaces разделены на два разных functional components: Builder и Tracker
    • 🔧 Изменен EasyARController, предоставляя application/system-level static features
    • 🔧 Унифицированы Target component interfaces
    • 🔧 Унифицированы service access data interfaces

Добавлено несколько инструментов разработки и диагностики:

  • 🚀 Добавлен edit-time diagnostic tool: Session Validaion Tool
    • ✨ Упрощает воспроизведение eif в любой scene
    • ✨ Поддерживает управление потоком playback eif
    • ✨ Поддерживает управление потоком session
  • 🚀 Добавлена runtime diagnostic panel: EasyAR Diagnostics Panel
    • ✨ Добавлен переключатель Developer Mode. По умолчанию 8 нажатий на экран включают и выключают Diagnostics Panel, упрощая recording eif и issue feedback для online apps
    • ✨ Поддерживает custom Developer Mode switch, используя пользовательское взаимодействие для переключения Diagnostics Panel
    • ✨ Поддерживает управление recording eif
    • ✨ Поддерживает управление отображением информации session
    • ✨ Поддерживает управление recording eed
  • ✨ Добавлены совершенно новые функции recording и playback EIF
    • ✨ FrameRecorder автоматически собирается в ARSession и больше не требует ручного выбора
    • ✨ FrameRecorder по умолчанию автоматически генерирует file names для использования без script
    • ✨ FramePlayer поддерживает переходы playback и регулировку скорости для данных, записанных в новом формате, с уменьшенным размером файла
    • 🔧 Поддерживает использование eif на компьютере для управления scenes и AR features, не новая функция
  • ✨ Добавлен DiagnosticsController, унифицирующий и оптимизирующий diagnostic features
    • ✨ Добавлены отображение и управление информацией по уровням. По умолчанию вся информация об error и warning отображается через UI
    • ✨ Добавлено отображение ключевой информации о состоянии ARSession и его компонентов. По умолчанию она отображается через UI и обновляется каждый frame
    • 🔧 Diagnostic features используются для упрощения сбора информации issue feedback
    • 🔥 Удален GUIPopup
  • 🔧 Оптимизированы поведение abnormal state и отображение информации об error
    • 🔧 Оптимизирована информация об error, когда нет доступного frame source
    • 🔧 В средах URP, когда EasyAR используется вместо AR Foundation или headset rendering для рендеринга camera images, неправильно настроенный RendererFeature сообщает об error и прерывает выполнение ARSession
    • 🔧 Изменена default Active control policy для Origin: при потере tracking content прикрепляется к экрану, а не исчезает
    • 🔧 При использовании trial products на custom cameras или headsets весь content скрывается по достижении time limit, чтобы избежать неправильной оценки эффекта
  • 🔧 Оптимизированы content и options страницы конфигурации
    • ✨ Поддерживается выбор variants библиотеки EasyAR Sense
    • 🔒 В разделе application permissions permissions, кроме camera permission, больше нельзя изменять; они определяются variant библиотеки EasyAR Sense и тем, включена ли Mega
    • 🔧 Function и server configurations сгруппированы по EasyAR feature
    • 🔧 Централизованно управляются third-party AR SDK configurations
    • 🔧 Централизованно управляются Workaround configurations для Unity

Инструменты EasyAR Mega полностью открыты:

  • 🚀 Полностью открыты, обновляются синхронно
    • ✨ Интегрированный выпуск Mega Studio 2.12
    • 🔧 Mega-инструменты на стороне Unity будут постепенно объединяться с plugin. В дальнейшем будет предоставляться только последний интегрированный пакет, но он будет выпускаться вместе с обычными обновлениями EasyAR Sense Unity Plugin
    • 🔧 EasyAR Mega по-прежнему нужно запрашивать через страницу сайта EasyAR, использовать можно только после одобрения
  • ✨ Добавлена поддержка EasyAR Mega Landmark
  • ✨ Добавлена поддержка 5DOF inertial navigation и включена по умолчанию, что значительно расширяет поддержку устройств EasyAR Mega
  • ✨ Добавлена поддержка доступа к сервисам Mega с помощью API Token
  • 🔧 Оптимизированы эффекты Mega и опыт разработки, включая изменения из предыдущих обновлений 4.7.x
    • ✨ Поддерживаются режим чистого вращения 3DOF и режим 0DOF, по умолчанию не включены
    • ✨ Добавлен EditorCameraDeviceFrameSource для диагностики в редакторе, чтобы избежать неправильного запуска на телефоне из-за неполного копирования sample
    • ✨ При записи eif-данных старой версии с Mega FrameRecorder автоматически создает файл .eif.json
    • 🔧 Опция деградации удаленной отладки заменена на LocationInputMode
    • 🔧 Режим без tracking разделен в отдельный компонент, обычно его больше не нужно использовать или учитывать
    • 🔧 Добавлена опция BlockRootSource. В конфигурации по умолчанию отсутствие BlockRoot вызовет ошибку
    • 🔧 Скорректировано поведение по умолчанию при локализации на несколько blocks, чтобы несколько blocks не использовались по умолчанию
    • 🔧 Скорректированы некоторые имена interfaces
    • 🔧 Выбрасываются более понятные исключения, когда Session содержит Mega, но не может его использовать
    • 🔧 Минимальный MotionTracker QualityLevel, поддерживаемый Mega, изменен на Limited
    • 🐛 Исправлена ошибка выполнения из-за неправильного экранирования CloudLocalizerStatus.WakingUp
    • 🔧 Некоторые оптимизации и изменения см. в changelog EasyAR Sense

Переписывание и оптимизация sample:

  • ✨ Переписаны все sample
    • ✨ Совместимость с разными конфигурациями Input System
    • ✨ Совместимость с URP17+
    • ✨ Совместимость с использованием AR Foundation
    • 🔧 Совместимость без использования AR Foundation
    • 🔧 Сохранено небольшое количество sample без поддержки AR Foundation
    • ⚡ Оптимизированы скрипты и вызовы интерфейсов
    • 🚚 Некоторые sample переименованы
    • 🔧 Заменены ресурсы, такие как модели и видео, внутри sample
    • ⚡ Сокращено использование streaming assets; они используются и импортируются только в sample, демонстрирующих конкретные функции
    • ✨ Используется Texture2D для создания ImageTarget
  • ✨ Добавлены демонстрации новых функций и API
    • ✨ Добавлен sample Workflow_ARSession для изучения базового процесса session, поддержки устройств и т. д.
    • ✨ Добавлен sample Workflow_FrameSource_ExternalImageStream, использующий видео как пользовательскую камеру, не для гарнитур
    • ✨ Добавлен sample Combination_BasedOn_MotionTracking для изучения использования и переключения разных функций при доступном motion tracking, а также переключения AR Foundation
    • ✨ Добавлен sample Combination_BasedOn_AppleVisionPro для демонстрации использования и переключения функций на Apple Visio Pro
    • ✨ Добавлен sample Combination_BasedOn_Xreal для демонстрации использования и переключения функций на устройствах XREAL
    • ✨ Добавлено несколько Mega sample, включенных в предыдущие обновления 4.7.x
    • ✨ Добавлены функции переключения размера камеры и torch mode в Workflow_FrameSource_CameraDevice
    • 🔥 Удален отдельный sample AR Foundation, его функции уже включены в другие sample
    • 🔥 Удален sample FrameRecording, его функции уже включены в другие sample
    • 🔥 Удален sample MotionTracking_Fusion, его функции уже включены в Combination_BasedOn_MotionTracking
    • 🔥 Удален sample SurfaceTracking_ImageTarget; эта комбинация функций по-прежнему легко реализуется
    • 🔥 Удален sample Camera_CustomCamera, при необходимости его можно реализовать самостоятельно
    • 🔥 Удалены старые sample очков, такие как ActionOne и BT350
  • ✨ Упрощено использование записи и воспроизведения eif
    • ✨ Во все sample добавлена кнопка записи eif, записанные eif-файлы можно использовать в редакторе
  • ✨ Переписан launcher и добавлены описания sample
    • 🐛 Исправлена проблема слишком темных сцен sample, загруженных через launcher

Интеграция EasyAR и сторонних AR-функций:

  • ⬆️ EasyAR Sense обновлен до официальной версии 4.7.0
  • ⬆️ Обновлен EasyAR AR Engine Interop
  • ⬆️ ARCore SDK обновлен до 1.46.0
  • 🔧 AR Engine отключен на некоторых телефонах, где AR Engine не может нормально работать
  • 🐛 Исправлен сбой ARCore из-за изменения поведения ClassLoader в Unity 6

Связанные темы