К содержимому
← Вернуться в блог

Как составить техническое задание на AR-приложение и проверить отслеживание объектов

Техническое задание на AR-приложение и проверка трекинга — две части одного процесса. Если описать только контент и не зафиксировать условия работы, подрядчик сделает красивую демонстрацию, а на объекте телефон потеряет изображение, подсказка уедет в сторону, пользователь не поймёт, что делать. Ниже разбираем, как составить документ и проверить отслеживание объектов до приёмки.

Материал пригодится заказчикам из Эстонии и других стран, которые готовят проект для музея, магазина, производства, обучения или городской навигации. Локация влияет скорее на язык документации, доступность устройств у аудитории и требования к приватности, чем на саму логику AR. Эти пункты лучше проговорить заранее.

Сначала определите задачу, а не технологию

Начните с вопроса: какую задачу пользователь решает с помощью AR? Сотрудник на производстве ищет нужный узел оборудования, посетитель музея хочет увидеть пояснение к экспонату, покупатель в магазине — сравнить товар на полке, монтажник — проверить последовательность действий. Во всех случаях AR остаётся инструментом, а не целью. Если в задании написано только «нужно AR-приложение с распознаванием объектов», подрядчик сам придумает сценарий, и он может не совпасть с вашим.

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

Отдельно зафиксируйте, что считается успехом. Не «эффектно выглядит», а понятный результат: пользователь находит объект, видит подсказку, завершает действие и может повторить его без инструкции рядом. Чем конкретнее критерий, тем проще потом принимать работу и объяснять подрядчику, что именно нужно доработать.

Техническое задание на AR-приложение и проверка трекинга: рабочая структура

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

Цель, аудитория и пользовательский путь

В первом разделе хватит одного абзаца о цели и описания ролей. Уточните, кто пользователь: клиент, сотрудник, технический специалист, посетитель без опыта. Для каждой роли пропишите начало и конец сценария. Например, сотрудник открывает приложение, наводит камеру на оборудование, получает подсказку, выполняет шаг и возвращается к списку задач. Если предусмотрены роли администратора или контент-редактора, это тоже часть задания, даже если интерфейс для них выглядит проще.

Объекты, маркеры и условия съёмки

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

Условия съёмки лучше описывать словами сценария, а не общими пожеланиями. С какого расстояния пользователь смотрит на объект? Под какими углами? Что попадает в кадр кроме объекта? Есть ли блики, тени, движение людей? Если приложение должно работать на улице, отдельно проговорите свет и погоду. Если в помещении — тип освещения и фон. Это не гарантирует идеальный трекинг, но помогает выбрать реалистичный тест-план.

Интерфейс, контент и обратная связь

Опишите, что видит пользователь до распознавания, в момент распознавания и после него. Нужны ли подсказки, стрелки, таймер, кнопка «показать ещё», звук или вибрация? Что происходит, если объект не найден? Хорошее поведение — понятное сообщение и следующий шаг, а не зависший экран с камерой. Если подсказки должны читаться на ходу, проверьте контраст, размер и расположение элементов: об этом подробнее в материале как спроектировать AR-интерфейс.

Контент тоже требует рамок. Укажите языки интерфейса и подсказок, формат моделей, допустимый вес файлов, необходимость субтитров или текстовых дублей. Если проект делается для Эстонии, заранее согласуйте, на каком языке будет документация и интерфейс, нужен ли русский или английский вариант. Это влияет на объём работы и приёмку.

  1. Название, версия документа и кто утверждает изменения.
  2. Цель, аудитория и критерий успеха.
  3. Роли пользователей и основные сценарии.
  4. Перечень объектов, маркеров и условий съёмки.
  5. Требования к трекингу и обработке ошибок.
  6. Интерфейс, контент, языки и доступность.
  7. Платформы, классы устройств и ограничения.
  8. Приёмочные тесты, передаваемые материалы и поддержка.

Этот каркас можно расширять, но не стоит заменять им проверку. Документ задаёт ожидания, а тесты показывают, выполняются ли они на реальных объектах и устройствах.

Требования к отслеживанию объектов в ТЗ

Трекинг — самая уязвимая часть AR. Формулировка «объект должен стабильно отслеживаться» ничего не проверяет. Нужны параметры, которые можно увидеть и зафиксировать: тип трекинга, условия, поведение при потере, допустимое дрожание, работа на разных устройствах. Ниже — таблица, которую удобно использовать как основу для раздела о трекинге.

Параметр Что зафиксировать в ТЗ Как проверить
Тип трекинга Маркер, изображение, 3D-объект, плоскость или комбинация. Показать на тестовом объекте, что выбранный тип вообще применим.
Объект и маркер Материал, размер, контраст, версия печати, допустимые изменения. Проверить на реальном объекте, а не на экранной картинке.
Дистанция и ракурс С какого расстояния и под какими углами пользователь работает. Обойти объект по сценарию, включая крайние ракурсы.
Освещение Типичный свет, блики, тени, работа на улице и в помещении. Повторить тест при разном свете и с бликующей поверхностью.
Движение Скорость перемещения пользователя и объекта, допустимое дрожание. Пройти сценарий в обычном темпе и быстрее, чем ожидается.
Перекрытия Что считается допустимым перекрытием объекта рукой или оборудованием. Частично закрыть объект и посмотреть на поведение подсказки.
Потеря и возврат Как приложение сообщает о потере и восстанавливает сцену. Убрать объект из кадра, вернуть его и оценить понятность восстановления.
Стабильность картинки Насколько контент не должен «плыть» и дёргаться при удержании. Записать видео и оценить дрейф на ровной поверхности и в движении.
Производительность Допустимые задержки, нагрев, расход батареи, поведение при нехватке ресурсов. Проверить длительную сессию и переключение между задачами.
Устройства Классы устройств и минимальные требования, если они известны. Прогнать тест на нескольких моделях, а не на одном телефоне.

В таблице нет универсальных порогов: они зависят от сценария и возможностей выбранной технологии. Но сам подход помогает избежать спора «мне кажется, что дёргается». Если в ТЗ записано, что объект должен оставаться в кадре при определённом ракурсе и освещении, а после перекрытия — показывать подсказку и восстанавливаться, это уже можно проверить.

Отдельно проговорите деградацию. Что происходит, если объект плохо виден? Приложение должно предложить пользователю приблизиться, повернуть камеру, включить свет или выбрать другой объект. Молчаливое зависание — плохой сценарий даже при красивом контенте. Поведение при ошибке стоит включить в приёмочные тесты наравне с успешным распознаванием.

Как проверить отслеживание объектов до приёмки

Проверка трекинга — это не финальная презентация в офисе. Нужен тест-план, который повторяет реальный сценарий: те же объекты, похожее освещение, те же движения и устройства, которые будут у пользователей. Если проверять только на одном телефоне у окна, можно пропустить проблемы, которые проявятся на складе или в зале музея.

Тест-план: сценарии, устройства, условия

Соберите набор проверок заранее и согласуйте его с подрядчиком. В протоколе фиксируйте устройство, версию операционной системы, освещение, расстояние, ракурс, что именно произошло. Полезно записывать видео: оно помогает вернуться к спорному моменту и показать разницу между ожиданием и результатом.

  • Холодный старт: приложение запускается, запрашивает разрешения и объясняет, что делать дальше.
  • Первое распознавание: пользователь наводит камеру на объект без подсказок со стороны.
  • Удержание: контент остаётся привязанным к объекту при медленном обходе и смене ракурса.
  • Движение: проверка в обычном темпе и быстрее, чем предполагает сценарий.
  • Свет и блики: тест при типичном освещении, у окна, под лампой, на улице.
  • Перекрытие: объект частично закрывают рукой, оборудованием или другим предметом.
  • Потеря и возврат: объект убирают из кадра, затем возвращают и смотрят на восстановление.
  • Разные устройства: проверка на нескольких моделях и разных размерах экрана.
  • Ошибки: нет камеры, запрещены разрешения, слабая сеть, если она нужна.
  • Длительная сессия: приложение остаётся открытым, телефон нагревается, пользователь переключается между задачами.

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

Не принимайте работу по одному удачному дублю. Если трекинг срывается через раз, это дефект, даже когда видео для презентации получилось хорошим. Зафиксируйте, какие условия считаются штатными, а какие — выходом за рамки задания. Такой протокол защищает обе стороны от разных трактовок.

Приёмка, документация и запуск

Приёмка должна заканчиваться не устным «вроде работает», а пакетом материалов: протоколом тестов, списком известных ограничений, инструкцией для пользователя или администратора, описанием того, как обновлять контент. Если подрядчик передаёт только сборку без тестов и пояснений, сопровождение усложняется. Заранее договоритесь, что считается дефектом, а что — ограничением, которое можно принять.

Для проекта в Эстонии уточните язык документации и интерфейса, а также формат общения с поддержкой. Это кажется мелочью, но при передаче проекта другой команде именно инструкции и тестовые материалы помогают не начинать с нуля. Если приложение должно работать у разных групп пользователей, проверьте, что подсказки понятны без дополнительного обучения.

Отдельно проверьте разрешения и приватность. Приложение может использовать камеру только для трекинга на устройстве, а может сохранять изображения или отправлять их на сервер — это разные сценарии. В ТЗ зафиксируйте, какие данные собираются, зачем, как долго хранятся и кто имеет к ним доступ. Это не юридическая консультация: итоговые формулировки согласуйте с юристом и проверьте требования в официальных источниках, включая регулятора по защите данных.

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

Что обязательно включить в ТЗ на AR-приложение?

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

Чем отличается трекинг маркера от трекинга объекта?

Трекинг маркера опирается на заранее подготовленный визуальный маркер, а трекинг объекта — на сам предмет или изображение. Маркер проще контролировать, но его нужно размещать в сцене. Трекинг реального объекта удобнее для пользователя, но сильнее зависит от формы, материала, освещения и ракурса.

Сколько устройств нужно для проверки трекинга?

Ориентируйтесь на аудиторию и сценарий. Если приложение должно работать у разных пользователей, одного устройства для проверки недостаточно: нужны несколько моделей и условий. Конкретный набор согласуйте с подрядчиком и зафиксируйте в тест-плане.

Как понять, что трекинг работает достаточно стабильно?

Если приложение удерживает объект в оговорённых условиях, понятно сообщает о потере и быстро восстанавливает сцену, а поведение совпадает на тестовых устройствах. Субъективное «выглядит плавно» лучше заменить протоколом и видеозаписью.

Нужен ли интернет для AR-приложения?

Не обязательно, но зависит от контента и логики. Если приложение загружает модели, обновляет каталог или отправляет события, сеть может понадобиться. Заранее опишите, что должно работать без интернета и как приложение ведёт себя при слабом соединении.

Какие данные камеры можно собирать?

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