Table of Contents

EasyAR Sense Unity Plugin примечания к выпуску

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

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

Предыдущие версии

Версия 4002.0.0

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

  • 🐛 Исправлена проблема сбоя сборки Android для Unity 6.4.4.
  • 🔧 Настройка части примера кода.
  • ⬆️ Обновление EasyAR Sense до 4.9.0

Версия 4001.0.0

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

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

Версия 4000.0.1

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

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

  2. Актуальная поддержка гарнитур, добавлена поддержка нескольких гарнитур OST/VST

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

  3. Совершенствование интерфейсов компонентов Unity, значительная оптимизация рабочего процесса ARSession

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

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

    Эта версия добавила совершенно новые функции записи и воспроизведения EIF. Хотя запись и воспроизведение EIF были доступны в предыдущих версиях, использование EIF никогда не было таким простым. Теперь вы можете использовать инструмент диагностики Session Validation Tool в редакторе Unity для прямого воспроизведения eif и управления вашей сценой, будь то отслеживание изображений, пространственные карты или EasyAR Mega, вы можете восстановить эффект работы на устройстве на компьютере. Теперь вы можете использовать панель диагностики во время выполнения EasyAR Diagnostics Panel в приложении, чтобы легко включить функцию записи eif или переключить отображение ключевой информации о состоянии ARSession и его компонентов в любое время. В то же время, примеры (samples) этой версии были полностью переписаны, при запуске примера вы можете сразу увидеть состояние ARSession и кнопку записи eif для удобства использования.

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

    Эта версия включает в себя выпущенный Mega Studio 2.12. В будущем обновления плагина будут выходить чаще, инструменты Mega на стороне Unity будут постепенно объединены внутрь плагина и выпускаться вместе с обычными обновлениями плагина. Помимо обновлений из предыдущих предварительных версий, эта версия по умолчанию включает поддержку инерциальной навигации, что еще больше значительно расширит поддержку устройств 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
    • 🔥 Удалена проверка версии gradle для Unity 2019
    • 🔥 Удалена опция DisableARCoreAREngine для Unity 2019
  • ✨ Unity 6: Полная поддержка Unity 6
    • ✨ Поддержка URP 17+ и Render Graph
    • 🐛 Исправлено: Изменения в поведении ClassLoader в Unity 6 приводили к неработоспособности ARCore
    • 🐛 Исправлено: Сбой рендеринга камеры при значении 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, поддержка повторного использования камеры XROrigin
    • ✨ Добавлена опция конфигурации Unity XR Auto Switch, по умолчанию обрабатывающая переключение объектов Unity XR (включая AR Foundation)
    • ✨ ARSession, созданный через меню EasyAR, автоматически включает поддержку AR Foundation и активирует её по умолчанию
    • ✨ Большинство примеров (samples) теперь имеют поддержку AR Foundation (сам AR Foundation необходимо импортировать вручную и правильно настроить)
    • 🔧 ARCore и ARKit можно контролировать отдельно, включая управление приоритетом между встроенными в EasyAR ARCore/ARKit и ARCore/ARKit из AR Foundation
    • 🔥 Удалена поддержка AR Foundation 4
    • 🔥 Удалена поддержка ARSessionOrigin, поддерживается только XROrigin
    • 🔥 Удален прокси-процесс установки ARCore для AR Foundation
  • ✨ Полная совместимость с Input System Package

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

  • 🚀 Интерфейс гарнитур стабилизирован, поддерживается интеграция сторонних устройств
    • ✨ Поддержка интеграции сторонних устройств (требуется предоставление производителем гарнитуры специфического интерфейса данных)
    • ✨ Поддержка XROrigin и XR Interaction Toolkit
    • ✨ Упрощение и унификация всех примеров для гарнитур, нулевой код, поддержка переключения функций
    • ✨ Поддержка ввода данных с фишай-камеры
    • ✨ Поддержка пользовательского ввода данных 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
  • ✨ Поддержка других устройств, таких как Pico и Rokid, через расширение EasyAR Sense Unity Plugin
    • ✨ Предоставлен референсный шаблон 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
    • ✨ Добавление функции сортировки источников кадров (Frame Source) (включая пункт меню)
  • ✨ FrameSource: добавление поддержки инерциальной навигации и 3DoF
    • ✨ Добавление InertialCameraDeviceFrameSource для поддержки инерциальной навигации
    • ✨ Добавление ThreeDofCameraDeviceFrameSource для поддержки 3DoF камеры
    • ✨ Добавление функции меню: Frame Source by Transform Type, предоставляющей список всех встроенных FrameSource
    • ⚡ Оптимизация опций Inspector
  • ✨ Прочие настройки интерфейсов и обновления функциональности
    • ✨ Добавление возможности создания ImageTarget из Texture2D
    • ✨ Добавление ImageMaterial для рендеринга данных типа Image (изображение с камеры, изображение цели и т.д.)
    • ✨ Добавление ActiveController для управления active состояния GameObject, унификация связанной логики управления
    • ✨ Добавление функции симуляции вращения экрана на десктопе
    • ✨ Добавление XROriginChildController для управления поведением объектов под началом (origin) сессии
    • 🔥 Удаление WorldRootController
    • 🔧 Разделение интерфейсов разреженных карт пространства (sparse spatial map) на два разных компонента: Builder и Tracker
    • 🔧 Настройка EasyARController, предоставление статических функций уровня приложения/системы
    • 🔧 Унификация интерфейсов компонентов Target
    • 🔧 Унификация интерфейсов доступа к данным сервисов

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

  • 🚀 Добавлен инструмент диагностики при редактировании: Session Validation Tool
    • ✨ Упрощено воспроизведение eif в любых сценариях
    • ✨ Поддержка управления процессом воспроизведения eif
    • ✨ Поддержка управления сессионным процессом
  • 🚀 Добавлена панель диагностики времени выполнения: EasyAR Diagnostics Panel
    • ✨ Добавлен переключатель Developer Mode (по умолчанию активируется/деактивируется 8-кратным нажатием на экран), упрощающий запись eif и обратную связь в онлайн-приложениях
    • ✨ Поддержка кастомного переключателя Developer Mode для активации Diagnostics Panel
    • ✨ Поддержка управления записью eif
    • ✨ Поддержка управления отображением информации о сессии
    • ✨ Поддержка управления записью eed
  • ✨ Добавлены новые функции записи и воспроизведения EIF
    • ✨ FrameRecorder автоматически интегрируется в ARSession, больше не требует ручного выбора
    • ✨ FrameRecorder по умолчанию автоматически генерирует имена файлов для использования без скриптов
    • ✨ FramePlayer поддерживает перемотку и регулировку скорости для данных, записанных в новом формате; уменьшен размер файлов
    • 🔧 Поддержка использования eif для управления сценами и AR-функциями на ПК (не новая функция)
  • ✨ Добавлен DiagnosticsController для унификации и оптимизации диагностических функций
    • ✨ Добавлено отображение информации по уровням и управление им; по умолчанию все ошибки и предупреждения отображаются через UI
    • ✨ Добавлено отображение ключевой информации о состоянии ARSession и его компонентов; по умолчанию обновляется каждый кадр через UI
    • 🔧 Упрощено получение информации для обратной связи по проблемам с помощью диагностических функций
    • 🔥 Удален GUIPopup
  • 🔧 Оптимизировано поведение при аномальных состояниях и отображение сообщений об ошибках
    • 🔧 Улучшены сообщения об ошибках при отсутствии доступного источника кадров (frame source)
    • 🔧 В среде URP при использовании EasyAR (не AR Foundation или рендеринга камеры гарнитуры) неправильная конфигурация RendererFeature вызывает ошибку и прерывает выполнение ARSession
    • 🔧 Изменена стратегия управления Active по умолчанию для Origin: при потере трекинга контент прилипает к экрану, а не исчезает
    • 🔧 При использовании пробных продуктов на кастомных камерах или гарнитурах по истечении лимита времени весь контент скрывается во избежание ошибочной оценки
  • 🔧 Оптимизировано содержимое и опции страницы конфигурации
    • ✨ Поддержка выбора вариантов библиотеки EasyAR Sense
    • 🔒 Разрешения приложения (кроме разрешения камеры) больше не изменяются; определяются вариантом библиотеки EasyAR Sense и статусом активации Mega
    • 🔧 Конфигурация функций и серверов сгруппирована по функционалу EasyAR
    • 🔧 Централизованное управление конфигурацией сторонних AR SDK
    • 🔧 Централизованное управление конфигурацией обходных решений (Workaround) для Unity

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

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

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

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

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

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

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