Как составить техническое задание на AR-приложение и проверить отслеживание объектов
Техническое задание на AR-приложение и проверка трекинга — две части одного процесса. Если описать только контент и не зафиксировать условия работы, подрядчик сделает красивую демонстрацию, а на объекте телефон потеряет изображение, подсказка уедет в сторону, пользователь не поймёт, что делать. Ниже разбираем, как составить документ и проверить отслеживание объектов до приёмки.
Материал пригодится заказчикам из Эстонии и других стран, которые готовят проект для музея, магазина, производства, обучения или городской навигации. Локация влияет скорее на язык документации, доступность устройств у аудитории и требования к приватности, чем на саму логику AR. Эти пункты лучше проговорить заранее.
Сначала определите задачу, а не технологию
Начните с вопроса: какую задачу пользователь решает с помощью AR? Сотрудник на производстве ищет нужный узел оборудования, посетитель музея хочет увидеть пояснение к экспонату, покупатель в магазине — сравнить товар на полке, монтажник — проверить последовательность действий. Во всех случаях AR остаётся инструментом, а не целью. Если в задании написано только «нужно AR-приложение с распознаванием объектов», подрядчик сам придумает сценарий, и он может не совпасть с вашим.
Опишите среду: помещение или улица, освещение, шум, движение, свободные руки, наличие сети. Представим ситуацию: приложение должно помогать на складе, где часть помещений плохо освещена, а сотрудник держит телефон одной рукой и коробку другой. Для такого сценария требования к трекингу, интерфейсу и обработке ошибок будут отличаться от музейного приложения, где посетитель стоит перед экспонатом и никуда не спешит.
Отдельно зафиксируйте, что считается успехом. Не «эффектно выглядит», а понятный результат: пользователь находит объект, видит подсказку, завершает действие и может повторить его без инструкции рядом. Чем конкретнее критерий, тем проще потом принимать работу и объяснять подрядчику, что именно нужно доработать.
Техническое задание на AR-приложение и проверка трекинга: рабочая структура
Техническое задание — не описание мечты, а документ для проверки. Его удобно строить от пользовательского пути: что человек делает до запуска, что видит в приложении, какие действия совершает и что происходит при сбое. Ниже — каркас, который можно адаптировать под проект, не превращая документ в роман.
Цель, аудитория и пользовательский путь
В первом разделе хватит одного абзаца о цели и описания ролей. Уточните, кто пользователь: клиент, сотрудник, технический специалист, посетитель без опыта. Для каждой роли пропишите начало и конец сценария. Например, сотрудник открывает приложение, наводит камеру на оборудование, получает подсказку, выполняет шаг и возвращается к списку задач. Если предусмотрены роли администратора или контент-редактора, это тоже часть задания, даже если интерфейс для них выглядит проще.
Объекты, маркеры и условия съёмки
Перечислите объекты, которые приложение должно распознавать: печатный маркер, изображение, реальный предмет, поверхность или их комбинацию. Для каждого объекта укажите то, что влияет на распознавание: материал, размер, контраст, версию печати, допустимые изменения внешнего вида. Если у товара меняется упаковка или на оборудование наклеивают новый шильдик, это нужно отразить в задании. Иначе подрядчик протестирует одну версию объекта, а в работе окажется другая.
Условия съёмки лучше описывать словами сценария, а не общими пожеланиями. С какого расстояния пользователь смотрит на объект? Под какими углами? Что попадает в кадр кроме объекта? Есть ли блики, тени, движение людей? Если приложение должно работать на улице, отдельно проговорите свет и погоду. Если в помещении — тип освещения и фон. Это не гарантирует идеальный трекинг, но помогает выбрать реалистичный тест-план.
Интерфейс, контент и обратная связь
Опишите, что видит пользователь до распознавания, в момент распознавания и после него. Нужны ли подсказки, стрелки, таймер, кнопка «показать ещё», звук или вибрация? Что происходит, если объект не найден? Хорошее поведение — понятное сообщение и следующий шаг, а не зависший экран с камерой. Если подсказки должны читаться на ходу, проверьте контраст, размер и расположение элементов: об этом подробнее в материале как спроектировать AR-интерфейс.
Контент тоже требует рамок. Укажите языки интерфейса и подсказок, формат моделей, допустимый вес файлов, необходимость субтитров или текстовых дублей. Если проект делается для Эстонии, заранее согласуйте, на каком языке будет документация и интерфейс, нужен ли русский или английский вариант. Это влияет на объём работы и приёмку.
- Название, версия документа и кто утверждает изменения.
- Цель, аудитория и критерий успеха.
- Роли пользователей и основные сценарии.
- Перечень объектов, маркеров и условий съёмки.
- Требования к трекингу и обработке ошибок.
- Интерфейс, контент, языки и доступность.
- Платформы, классы устройств и ограничения.
- Приёмочные тесты, передаваемые материалы и поддержка.
Этот каркас можно расширять, но не стоит заменять им проверку. Документ задаёт ожидания, а тесты показывают, выполняются ли они на реальных объектах и устройствах.
Требования к отслеживанию объектов в ТЗ
Трекинг — самая уязвимая часть AR. Формулировка «объект должен стабильно отслеживаться» ничего не проверяет. Нужны параметры, которые можно увидеть и зафиксировать: тип трекинга, условия, поведение при потере, допустимое дрожание, работа на разных устройствах. Ниже — таблица, которую удобно использовать как основу для раздела о трекинге.
| Параметр | Что зафиксировать в ТЗ | Как проверить |
|---|---|---|
| Тип трекинга | Маркер, изображение, 3D-объект, плоскость или комбинация. | Показать на тестовом объекте, что выбранный тип вообще применим. |
| Объект и маркер | Материал, размер, контраст, версия печати, допустимые изменения. | Проверить на реальном объекте, а не на экранной картинке. |
| Дистанция и ракурс | С какого расстояния и под какими углами пользователь работает. | Обойти объект по сценарию, включая крайние ракурсы. |
| Освещение | Типичный свет, блики, тени, работа на улице и в помещении. | Повторить тест при разном свете и с бликующей поверхностью. |
| Движение | Скорость перемещения пользователя и объекта, допустимое дрожание. | Пройти сценарий в обычном темпе и быстрее, чем ожидается. |
| Перекрытия | Что считается допустимым перекрытием объекта рукой или оборудованием. | Частично закрыть объект и посмотреть на поведение подсказки. |
| Потеря и возврат | Как приложение сообщает о потере и восстанавливает сцену. | Убрать объект из кадра, вернуть его и оценить понятность восстановления. |
| Стабильность картинки | Насколько контент не должен «плыть» и дёргаться при удержании. | Записать видео и оценить дрейф на ровной поверхности и в движении. |
| Производительность | Допустимые задержки, нагрев, расход батареи, поведение при нехватке ресурсов. | Проверить длительную сессию и переключение между задачами. |
| Устройства | Классы устройств и минимальные требования, если они известны. | Прогнать тест на нескольких моделях, а не на одном телефоне. |
В таблице нет универсальных порогов: они зависят от сценария и возможностей выбранной технологии. Но сам подход помогает избежать спора «мне кажется, что дёргается». Если в ТЗ записано, что объект должен оставаться в кадре при определённом ракурсе и освещении, а после перекрытия — показывать подсказку и восстанавливаться, это уже можно проверить.
Отдельно проговорите деградацию. Что происходит, если объект плохо виден? Приложение должно предложить пользователю приблизиться, повернуть камеру, включить свет или выбрать другой объект. Молчаливое зависание — плохой сценарий даже при красивом контенте. Поведение при ошибке стоит включить в приёмочные тесты наравне с успешным распознаванием.
Как проверить отслеживание объектов до приёмки
Проверка трекинга — это не финальная презентация в офисе. Нужен тест-план, который повторяет реальный сценарий: те же объекты, похожее освещение, те же движения и устройства, которые будут у пользователей. Если проверять только на одном телефоне у окна, можно пропустить проблемы, которые проявятся на складе или в зале музея.
Тест-план: сценарии, устройства, условия
Соберите набор проверок заранее и согласуйте его с подрядчиком. В протоколе фиксируйте устройство, версию операционной системы, освещение, расстояние, ракурс, что именно произошло. Полезно записывать видео: оно помогает вернуться к спорному моменту и показать разницу между ожиданием и результатом.
- Холодный старт: приложение запускается, запрашивает разрешения и объясняет, что делать дальше.
- Первое распознавание: пользователь наводит камеру на объект без подсказок со стороны.
- Удержание: контент остаётся привязанным к объекту при медленном обходе и смене ракурса.
- Движение: проверка в обычном темпе и быстрее, чем предполагает сценарий.
- Свет и блики: тест при типичном освещении, у окна, под лампой, на улице.
- Перекрытие: объект частично закрывают рукой, оборудованием или другим предметом.
- Потеря и возврат: объект убирают из кадра, затем возвращают и смотрят на восстановление.
- Разные устройства: проверка на нескольких моделях и разных размерах экрана.
- Ошибки: нет камеры, запрещены разрешения, слабая сеть, если она нужна.
- Длительная сессия: приложение остаётся открытым, телефон нагревается, пользователь переключается между задачами.
Для внутреннего контроля определите метрики: время до первого распознавания, число успешных удержаний, частота потери, время восстановления, понятность сообщений об ошибке. Пороговые значения согласуйте заранее — они зависят от сценария. Для демонстрации в музее и для работы на производстве допустимые задержки и требования к стабильности могут различаться.
Не принимайте работу по одному удачному дублю. Если трекинг срывается через раз, это дефект, даже когда видео для презентации получилось хорошим. Зафиксируйте, какие условия считаются штатными, а какие — выходом за рамки задания. Такой протокол защищает обе стороны от разных трактовок.
Приёмка, документация и запуск
Приёмка должна заканчиваться не устным «вроде работает», а пакетом материалов: протоколом тестов, списком известных ограничений, инструкцией для пользователя или администратора, описанием того, как обновлять контент. Если подрядчик передаёт только сборку без тестов и пояснений, сопровождение усложняется. Заранее договоритесь, что считается дефектом, а что — ограничением, которое можно принять.
Для проекта в Эстонии уточните язык документации и интерфейса, а также формат общения с поддержкой. Это кажется мелочью, но при передаче проекта другой команде именно инструкции и тестовые материалы помогают не начинать с нуля. Если приложение должно работать у разных групп пользователей, проверьте, что подсказки понятны без дополнительного обучения.
Отдельно проверьте разрешения и приватность. Приложение может использовать камеру только для трекинга на устройстве, а может сохранять изображения или отправлять их на сервер — это разные сценарии. В ТЗ зафиксируйте, какие данные собираются, зачем, как долго хранятся и кто имеет к ним доступ. Это не юридическая консультация: итоговые формулировки согласуйте с юристом и проверьте требования в официальных источниках, включая регулятора по защите данных.
Если AR используется в рекламной кампании, заранее определите события и способ измерения. Иначе после запуска будет сложно понять, что именно сработало: сам AR-контент, подсказка на экране или переход по ссылке. Полезные ориентиры есть в материале как подготовить AR-кампанию и измерить взаимодействие с рекламным материалом.
Что обязательно включить в ТЗ на AR-приложение?
Цель и критерий успеха, роли пользователей, сценарии, перечень объектов и маркеров, требования к трекингу, условия съёмки, интерфейс и контент, поддерживаемые устройства, порядок приёмки и передаваемые материалы. Чем конкретнее описаны проверяемые параметры, тем меньше пространства для разных трактовок.
Чем отличается трекинг маркера от трекинга объекта?
Трекинг маркера опирается на заранее подготовленный визуальный маркер, а трекинг объекта — на сам предмет или изображение. Маркер проще контролировать, но его нужно размещать в сцене. Трекинг реального объекта удобнее для пользователя, но сильнее зависит от формы, материала, освещения и ракурса.
Сколько устройств нужно для проверки трекинга?
Ориентируйтесь на аудиторию и сценарий. Если приложение должно работать у разных пользователей, одного устройства для проверки недостаточно: нужны несколько моделей и условий. Конкретный набор согласуйте с подрядчиком и зафиксируйте в тест-плане.
Как понять, что трекинг работает достаточно стабильно?
Если приложение удерживает объект в оговорённых условиях, понятно сообщает о потере и быстро восстанавливает сцену, а поведение совпадает на тестовых устройствах. Субъективное «выглядит плавно» лучше заменить протоколом и видеозаписью.
Нужен ли интернет для AR-приложения?
Не обязательно, но зависит от контента и логики. Если приложение загружает модели, обновляет каталог или отправляет события, сеть может понадобиться. Заранее опишите, что должно работать без интернета и как приложение ведёт себя при слабом соединении.
Какие данные камеры можно собирать?
Зависит от того, какие данные вы собираете и зачем. Камера может использоваться только для трекинга на устройстве, а может передавать изображения на сервер — это разные сценарии. Проверьте требования к приватности у юриста и в официальных источниках, а в ТЗ зафиксируйте, какие данные сохраняются, как долго и кто имеет к ним доступ.