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

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

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

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

Примечание

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

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

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

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

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

../_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 вне зависимости от их исходного размера.

Примечание

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

Примечание

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

Подробнее см. /articles/tracking

Примечание

Параметр Размер изображения паттерна маркерной метки (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()

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

Примечание

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