Система трекинга

объект Система трекинга; TrackingSystemReactor

Данный объект даёт возможность управлять трекингом меток дополненной реальности в процессе работы приложения.

Трекинг – это сложный процесс, связанный с отслеживанием положения наблюдателя относительно окружающей обстановки. Он является одной из важнейших составляющих в реализации технологий дополненной реальности (подробнее см. Технология трекинга)

Примечание

В первую очередь этот объект предназначен для использования в проектах дополненной реальности (AR), однако при необходимости может использоваться и в проектах виртуальной реальности (VR) при создании проектов, в которых для осуществления трекинга маркеров будут задействованы камеры VR шлема или система с внешними камерами.

Работа с системой трекинга

Свойства объекта Система трекинга

Вводится в Система трекинга (TrackingSystemReactor)

Объект Система трекинга позволяет включать и отключать маркерную и безмаркерную технологии распознавания (подробнее см. Технология трекинга), определять разрешение маркерного детектора, устанавливать интервал возникновения/прекращения трекинга, а также определяет максимальное количество безмаркерных меток в кадре.

../_images/trackingsys1.png
Параметр Описание Примечание
Включить маркерную технологию (dashDotEnabled) Параметр определяет, будет ли автоматически включена маркерная технология распознавания при запуске приложения. По умолчанию маркерная технология включена.
Разрешение маркерного детектора (dashDotResolution) Параметр связан с разрешающей способностью камеры, которая используется для тестирования/работы приложения.

Разрешение маркерного детектора измеряется в пикселях (px).

По умолчанию для параметра задано значение 320px.

Примечание

Рассмотрим пример: у камеры, которую мы используем, разрешение видео 1280x720 px. Если вы, используя такую камеру, установите разрешение маркерного детектора 320px, то детектор – элемент системы трекинга, который занимается поиском маркеров в кадре, будет обрабатывать изображение, то есть искать маркеры в кадре, размером 320x180 px.

Важно

Чем больше будет указано разрешение маркерного детектора, тем больше будет нагрузка на ресурсы ПК, а далее и на ресурсы мобильного устройства, если приложение разрабатывается для мобильных устройств, однако увеличение этого параметра может улучшить качество трекинга, поэтому при его настройке и использовании важно найти оптимальный вариант.

Важно

Нет смысла указывать разрешение маркерного детектора больше, чем разрешающая способность камеры, поскольку все равно будет использована только максимальная разрешающая способность самой камеры.

Примечание

Системы маркерного и безмаркерного трекинга независимы, и в каждый момент времени они могут быть активны как обе, так и только одна из них. Если отключить какую-либо из двух технологий распознавания или обе сразу, то при появлении метки (маркера) в зоне видимости камеры, события, связанные с меткой, происходить не будут.

Примечание

Если отключить какую-либо из двух технологий распознавания или обе сразу, то при появлении метки (маркера) в зоне видимости камеры, события, связанные с меткой, происходить не будут.

События и действия объекта Система трекинга

../_images/trackingsys2.png
Событие Описание
Маркерная технология включена (onDashDotEnabled) Событие будет вызвано после включения маркерного трекинга.
Маркерная технология отключена (onDashDotDisabled) Событие будет вызвано после выключения маркерного трекинга.
Безмаркерная технология включена (onImageEnabled) Событие будет вызвано после включения безмаркерного трекинга.
Безмаркерная технология отключена (onImageDisabled) Событие будет вызвано после выключения безмаркерного трекинга.
Камера запустилась (onVideoInputStart) Событие будет вызвано при начале получения данных с камеры.
Действие Описание
Включить маркерную технологию. (enableDashDot) Включение маркерного трекинга.
Выключить маркерную технологию. (disableDashDot) Выключение безмаркерного трекинга.
Включить безмаркерную технологию. (enableImage) Включение безмаркерного трекинга.
Выключить безмаркерную технологию. (disableImage) Выключение безмаркерного трекинга.
параметр Включить маркерную технологию; dashDotEnabled

Параметр определяет, будет ли автоматически включена маркерная технология распознавания при запуске приложения.

параметр Разрешение маркерного детектора; dashDotResolution

Параметр связан с разрешающей способностью камеры, которая используется для тестирования/работы приложения.

Если у используемой камеры разрешение видео 1280x720 px и при этом в параметре установлено разрешение маркерного детектора 320px, то детектор – элемент системы трекинга, который занимается поиском маркеров в кадре, будет обрабатывать изображение, то есть искать маркеры в кадре, размером 320x180 px.

параметр Размер изображения паттерна маркерной метки; dashDotClassifierPatternSize

Параметр определяет размер изображения паттерна маркерной метки внутри программы.

По умолчанию значение данного параметра задано как 32 px. Это означает, что любые паттерны маркерных меток автоматически будут уменьшены и приведены к размеру 32px на 32px вне зависимости от их исходного размера.

Примечание

При уменьшении больших изображений паттернов происходит потеря качества изображения по аналогии с уменьшением растровых изображений в графических редакторах.

Примечание

Для паттернов маркерных меток нет необходимости в использовании изображений больших размеров, так как такие изображения все равно будут уменьшены. При этом в ресурсах проекта будет содержаться файл изображения исходного размера, что может повлиять на вес конечного собранного приложения (если изображение тяжелое) или повлиять на скорость работы (тяжелые изображения часто непрактичны, например, в мобильных приложениях, поскольку они долго загружаются).

Подробнее см. Технология трекинга

Примечание

Параметр Размер изображения паттерна маркерной метки (dashDotClassifierPatternSize) можно настроить только при использовании версии конструктора EV Toolbox Advanced/Advanced Edu.

параметр Максимальная ошибка сравнения классификатора; dashDotClassifierMaxError

Параметр определяет значение максимальной ошибки сравнения классификатора паттерна маркерной метки.

Значение параметра может быть задано в диапазоне от 0 до 1, где 0 - 0%, а 1 - 100%.

По умолчанию значение параметра задано как 0.05. Это означает, что при сравнении паттерна маркера в кадре с паттерном, заданном в программе допустимо расхождение в 5%. В случае, если паттерн маркера, заданный в программе отличается от паттерна в кадре с камеры более, чем на 5%, трекинг работать не будет, то есть такая маркерная метка не будет распознана.

Примечание

Параметр Максимальная ошибка сравнения классификатора (dashDotClassifierMaxError) можно настроить только при использовании версии конструктора EV Toolbox Advanced/Advanced Edu.

Примечание

Параметры Разрешение маркерного детектора (dashDotResolution), Размер изображения паттерна маркерной метки (dashDotClassifierPatternSize) и Максимальная ошибка сравнения классификатора (dashDotClassifierMaxError) работают в связке друг с другом.

По умолчанию в программе выставлены оптимальные настройки системы трекинга, однако, если вам необходимо увеличить точность распознавания маркерных меток, это можно сделать с использованием данных параметров.

параметр Интервал возникновения трекинга - маркерная технология; dashDotMinPresenceTime

Параметры определяет время, по прошествии которого объект появляется на маркерной метке, когда метка попадает в зону видимости камеры.

Значение параметра измеряется в секундах (с).

параметр Интервал прекращения трекинга - маркерная технология; dashDotMaxAbsenceTime

Параметр определяет время, по прошествии которого объект исчезает, когда маркерная метка пропадает из зоны видимости камеры.

Значение параметра измеряется в секундах (с).

параметр Включить безмаркерную технологию; imageEnabled

Параметр определяет, будет ли автоматически включена безмаркерная технология распознавания при запуске приложения.

параметр Поддержка технологии ARKit; imageUseARKitIfSupported

Параметр отвечает за поддержку работы технологии ARKit для устройств на базе iOS.

Примечание

Технология поддерживается только на устройствах на базе платформ iOS, iPadOS и VisionOS с процессорами Apple A9 и старше.

Значение данного параметра по умолчанию „default = true“. В приложениях, собранных для устройств на базе iOS, по умолчанию автоматически используется трекинг на базе технологии ARKit.

Если для данного параметра значение будет изменено на „default = false“, в приложениях, собранных для устройств на базе iOS будет использоваться трекинг на базе внутренних алгоритмов программы EV Studio

Примечание

Если устройство на базе iOS не поддерживает технологию ARKit, то в приложениях по умолчанию будет использоваться трекинг на базе внутренних алгоритмов программы EV Studio.

Примечание

Параметр Поддержка технологии ARKit (imageUseARKitIfSupported) можно настроить только при использовании версии конструктора EV Toolbox Advanced/Advanced Edu.

параметр Поддержка технологии ARCore; imageUseARCoreIfSupported

Параметр отвечает за поддержку работы технологии ARCore для устройств на базе OS Android.

Значение данного параметра по умолчанию „default = false“.

В приложениях, собранных для устройств на базе OS Android, по умолчанию автоматически используется трекинг на базе внутренних алгоритмов программы EV Studio.

Если для данного параметра значение будет изменено на „default = true“, то при запуске приложения будет использоваться трекинг двумерных объектов на базе технологии ARCore.

Примечание

Данный параметр актуален только для устройств на базе OS Android с поддержкой технологии ARCore.

Со списком устройств с поддержкой технологии ARCore можно ознакомиться на официальном сайте Google Developers

Примечание

При использовании технологии ARCore в конструкторе EV Toolbox возможен только трекинг двумерных изображений (маркеров).

Примечание

Параметр Поддержка технологии ARCore (imageUseARCoreIfSupported) можно настроить только при использовании версии конструктора EV Toolbox Advanced/Advanced Edu.

параметр Максимальное число безмаркерных меток в кадре; imageTrackablesMaxCount

Параметр определяет максимальное количество безмаркерных меток в кадре для одновременного распознавания.

параметр Интервал возникновения трекинга - безмаркерная технология; imageMinPresenceTime

Параметр определяет время, по прошествии которого объект появляется на безмаркерной метке, когда метка попадает в зону видимости камеры.

Значение параметра измеряется в секундах (с).

параметр Интервал прекращения трекинга - безмаркерная технология; imageMaxAbsenceTime

Параметр определяет время, по прошествии которого объект исчезает, когда безмаркерная метка пропадает из зоны видимости камеры.

Значение параметра измеряется в секундах (с).

Примечание

Отключение технологий трекинга ускорит запуск приложения. Тем не менее, если какая-либо из технологий трекинга отключена при запуске приложения, на первый её запуск может потребоваться некоторое время для обработки меток. Последующие её включения будут происходить быстрее.

событие Маркерная технология включена; onDashDotEnabled

Событие будет вызвано после включения маркерной технологии.

событие Маркерная технология отключена; onDashDotDisabled

Событие будет вызвано после отключения маркерной технологии.

событие Безмаркерная технология включена; onImageEnabled

Событие будет вызвано после включения безмаркерной технологии.

событие Безмаркерная технология отключена; onImageDisabled

Событие будет вызвано после отключения безмаркерной технологии.

событие Камера запустилась; onVideoInputStart

Событие будет вызвано после того, как камера запустилась и с нее были получены первые данные.

действие Включить маркерную технологию.; enableDashDot()

Включение маркерного трекинга.

действие Выключить маркерную технологию.; disableDashDot()

Выключение маркерного трекинга.

действие Включить безмаркерную технологию.; enableImage()

Включение безмаркерного трекинга.

действие Выключить безмаркерную технологию.; disableImage()

Выключение безмаркерного трекинга.

Примечание

При отключенной технологии распознавания при появлении маркера в зоне видимости камеры события, связанные с ним, не будут вызваны.