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

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

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

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

Примечание

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

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

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

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

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

../_images/trackingsys1.png

Параметр

Описание

Примечание

Включить маркерную технологию (dashDotEnabled)

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

По умолчанию маркерная технология включена.

Разрешение маркерного детектора (dashDotResolution)

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

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

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

Примечание

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

Важно

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

Важно

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

Параметр

Описание

Примечание

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Примечание

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

Примечание

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

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

../_images/trackingsys2.png

Событие

Описание

Маркерная технология включена (onDashDotEnabled)

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

Маркерная технология отключена (onDashDotDisabled)

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

Безмаркерная технология включена (onImageEnabled)

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

Безмаркерная технология отключена (onImageDisabled)

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

Действие

Описание

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

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

Выключить безмаркерную технологию. (disableDashDot)

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

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

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

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

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

параметр Включить маркерную технологию
параметр dashDotEnabled

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

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

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

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

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

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

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

Примечание

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

Примечание

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

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

Примечание

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

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

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

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

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

Примечание

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

Примечание

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Примечание

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

Если устройство на базе 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()

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

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

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

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

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

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

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

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

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

Примечание

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