Совместимость Unity
В этой статье описаны версии Unity и требования к конфигурации, совместимые с EasyAR Sense Unity Plugin.
Версии Unity
EasyAR Sense Unity Plugin поддерживает Unity 2021.3 и выше.
Пакет поддержки EasyAR Mega, необходимый для разработки функций Mega, поддерживает Unity 2021.3.30 и выше.
Совет
В целом EasyAR не зависит от большого числа часто меняющихся API Unity, поэтому если Unity выпустит новую версию, EasyAR Sense Unity Plugin обычно продолжит нормально работать.
EasyAR Sense Unity Plugin с версии 4.6.4 поддерживает Unity 6 URP 17+ Render Graph.
Платформы разработки
| ОС | Версия ОС | Архитектура CPU | Примечание |
|---|---|---|---|
| Windows | 7 и выше (7/8.1/10/11) | x86, x86_64 | Для версий Windows N/KN требуется установить Media Feature Pack |
| macOS | 11.0 и выше | x86_64, arm64 |
Кроме того, нужно соответствовать требованиям системы разработки Unity для соответствующей версии.
Платформы публикации
| ОС | Версия ОС | Архитектура CPU | Примечание |
|---|---|---|---|
| Windows | 7 и выше (7/8.1/10/11) | x86, x86_64 | Для версий Windows N/KN требуется установить Media Feature Pack. Функция записи экрана EasyAR не поддерживается. |
| macOS | 11.0 и выше | x86_64, arm64 | Функция записи экрана EasyAR не поддерживается. |
| Android | 5.0 и выше | armv7a, arm64-v8a | Поддержка arm64-v8a требует IL2CPP. Функция записи экрана EasyAR поддерживается только при Graphics API = OpenGLES2 или OpenGLES3. |
| HarmonyOS (мобильный) | 1.0 – 4.x нативная поддержка 5 и выше через слой совместимости Android-приложений1 |
arm64-v8a | |
| iOS | 15.0 и выше | arm64 | Architecture должна быть ARM64; Universal не поддерживается. Функция записи экрана EasyAR не поддерживается. |
| visionOS | 2.0 и выше | arm64 | Функция записи экрана EasyAR не поддерживается. |
Кроме того, нужно соответствовать требованиям платформы публикации Unity для соответствующей версии:
Дополнительные замечания по macOS
Apple silicon
EasyAR Sense Unity Plugin поддерживает нативный запуск на устройствах Apple silicon начиная с версии 4.6.0, а также может нормально использоваться в Unity Editor.
Примечание
Из-за бага поддержки native plugin в Unity в некоторых версиях Unity приложения, собранные для "Apple silicon" или "Intel 64-bit + Apple silicon", могут работать некорректно. Если приложение не работает на Mac и показывает ошибки вроде "Fail to load EasyAR library" или "DllNotFoundException: EasyAR assembly", рекомендуется использовать более новую версию Unity или обратиться за помощью к Unity и сообществу Unity.
Дополнительные замечания по Android
Поддержка размера страницы памяти 16 KB на Android
EasyAR Sense Unity Plugin поддерживает устройства с размером страницы памяти 16 KB начиная с версии 4000.
Совет
Эта функция была введена в Android 15. Подробнее см. в документации Android о поддержке страниц 16 KB.
Предупреждение Google Play о libhuawei_arengine_jni.so, которое может привести к сбою приложения на устройствах 16 KB
При настройках по умолчанию EasyAR Sense Unity Plugin использует на Android AR Engine SDK 3.7.0.3 (включая libhuawei_arengine_jni.so) для поддержки Huawei AR Engine. Поскольку эта библиотека собрана Huawei с помощью старого Android NDK, Google Play может выдавать предупреждение, но на практике это не вызывает проблем.
Your app could crash on 16 KB devices
base/lib/arm64-v8a/libhuawei_arengine_jni.so
О AR Engine SDK:
- Версия 3.7.0.3 была собрана Huawei с помощью старого Android NDK, поэтому Google Play и показывает предупреждение. См. документацию Google о сборке приложений с Android NDK r27 и ниже.
- Версия 3.7.0.3 поддерживает загрузку на устройствах Android с размером страницы памяти 16 KB, поэтому Google Play не запрещает публикацию приложения.
- Версия 4.0.0.5 не поддерживает загрузку на устройствах Android с размером страницы памяти 16 KB. Это последняя общедоступная версия AR Engine SDK в экосистеме Android, поэтому EasyAR Sense Unity Plugin по-прежнему использует 3.7.0.3.
Использование AR Engine SDK 3.7.0.3 вместе с EasyAR Sense Unity Plugin не мешает публикации в Google Play и не вызывает реального сбоя:
- Устройства Huawei не относятся к Android-устройствам 16 KB.
- EasyAR Sense использует белый список, чтобы не запускать AR Engine SDK на не-Huawei устройствах.
Как обрабатывать это предупреждение:
Если вам нужно использовать AR Engine на устройствах Huawei, рекомендуется игнорировать предупреждение.
Если не нужно поддерживать устройства Huawei или можно обойтись без AR Engine, можно отключить AR Engine SDK в Конфигурации EasyAR.
Примечание
На устройствах Huawei даже при выключенном AR Engine остальные функции EasyAR продолжают работать нормально, но результат motion tracking будет отличаться от AR Engine, и другие функции, использующие motion tracking, тоже будут затронуты.
Дополнительные замечания по HarmonyOS
Harmony-система, совместимая с Android
EasyAR Sense Unity Plugin полностью поддерживает HarmonyOS 1.0 – 4.x.
Нативный HarmonyOS / чистый HarmonyOS / HarmonyOS NEXT
EasyAR Sense Unity Plugin скоро начнёт поддерживать нативный HarmonyOS 5.0+; текущая версия пока не поддерживается и может использоваться только через слой совместимости Android-приложений.
Совет
Международная версия Unity не поддерживает нативный HarmonyOS, нужно использовать Tuanjie Engine.
WebGL
EasyAR Sense Unity Plugin не поддерживает Unity WebGL.
Совет
Функции, разработанные напрямую через интерфейсы облачных сервисов EasyAR (например, интерфейс сервиса CRS), можно публиковать на Web-платформе.
Graphics API
EasyAR Sense Unity Plugin напрямую использует render pipeline Unity, поэтому поддерживаются все Graphics API, доступные в Unity.
Scriptable Render Pipeline
EasyAR Sense Unity Plugin поддерживает Universal Render Pipeline (URP) 7.0.0 и выше.
EasyAR Sense Unity Plugin не поддерживает High Definition Render Pipeline (HDRP).
Примечание
Заявление о поддержке Unity 6 URP 17+ render graph
EasyAR поддерживает Unity 6 URP 17+ render graph, но у Unity всё ещё есть некоторые нерешённые проблемы. При нестандартном поведении попробуйте режим совместимости URP, предоставляемый Unity.
Некоторые проблемы уже исправлены в последних версиях Unity, поэтому рекомендуется использовать 6.2 и выше.
Известные проблемы в режиме без совместимости включают:
[Не решено] При получении текстуры камеры из EasyAR (например, в примере ImageTracking_Coloring3D и в примере ARSession workflow (CameraDevice)) на устройствах iOS/Mac могут наблюдаться визуальные сбои и артефакты. Мы воспроизвели проблему в чистом Unity package и сообщили о ней Unity: Glitches on iOS with AR Camera Image Rendering (URP 17 render graph). Ход работ можно отслеживать в Unity Issue UUM-87787 и будущих релиз-нотах Unity.
Для всех версий Unity 6 можно использовать частичные меры смягчения, которые включены по умолчанию.
Для Unity 6.2 и выше можно установить Render Scale в Universal Render Pipeline Asset в значение вне диапазона 0.96-1.05, чтобы обойти проблему.
[Исправлено в Unity 6.2] На Windows DX11 изображение камеры может сделать результат рендера объектов сцены непредсказуемым. В Unity 6.0 - 6.1 EasyAR предоставляет вариант обхода, включённый по умолчанию.
-
Текущая версия пока не поддерживает нативный HarmonyOS / чистый HarmonyOS 5.0.↩