Брендирование для корпоративных клиентов

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

callback решает другую задачу: управляемую интеграцию AR-сессии в корпоративные процессы. Через события жизненного цикла можно фиксировать запуск, завершение, отмену и ошибки, автоматически возвращать пользователя в исходное приложение, связывать AR-действия с внутренними системами (BI, журнал работ, сервис-деск, аудит), а также передавать служебные идентификаторы проекта и контекста для сквозной трассировки.

Где поддерживается

Блоки branding и callback поддерживаются в запросах:

POST /api/gip-vision/v1/session/by_plane/
POST /api/gip-vision/v1/session/by_refimage/
POST /api/gip-vision/v1/session/by_scan/

1. Блок branding

branding отвечает за оформление AR-интерфейса под корпоративный стиль.

Поле	Тип	По умолчанию	Описание
`branding.logo_file`	file (PNG/JPG)	-	Логотип клиента (приложения откуда пришел запрос), рекомендуется `200x200`
`branding.company_name`	string (1..100)	-	Название компании в интерфейсе
`branding.primary_color`	string (`#RRGGBB`)	-	Основной цвет интерфейса
`branding.show_powered_by`	boolean	`true`	Показывать `Powered by GIP Vision`

2. Блок callback

callback позволяет получать события жизненного цикла AR-сессии и управлять возвратом в клиентское приложение.

2.1 События AR-сессии

Поле события	Когда вызывается
`callback.on_start_ar_session`	При запуске AR-сессии на устройстве
`callback.on_finish_ar_session`	При успешном завершении AR-сессии
`callback.on_cancel_ar_session`	При отмене AR-сессии пользователем
`callback.on_error_ar_session`	При ошибке AR-сессии
`callback.on_return_to_client`	При возврате пользователя в клиентское приложение

Каждое событие использует структуру CallbackEventRequest:

Поле	Тип	Описание
`url`	string	`https://...` или deep link `myapp://...`
`params`	object	Параметры, которые добавляются к URL при вызове

2.2 Поля возврата в клиентское приложение

Поле	Тип	Описание
`callback.return_from_arsession_url`	string	URL/deeplink возврата после AR-сессии
`callback.return_from_arsession_appname`	string	Отображаемое имя приложения для возврата
`callback.custom_data`	object	Произвольные данные клиента, добавляются ко всем callback

Данные поля детально описаны в полной документации: OpenAPI-спецификация.