# Журнал изменений
#### 1.9.7 – 24.04.2026
* Добавили возможность настройки кнопки закрытия: `closeButtonSlot` (HTML-строка или HTMLElement).
* Добавили возможность настраивать положение логотипа: `options.position` (слева или по центру).
* Решили проблему с появлением лишних ошибок `error_recorder_face_detector` и `camera_preparation_error`.
* Решили проблему с повышенным количеством отказов в режиме инкогнито в Safari.
* Исправили ошибку с race condition в `add_lang()`, теперь во время инициализации язык больше не сбрасывается случайным образом на английский.
* SDK теперь корректно выводит ошибки потери сетевого соединения (`error_connection_lost`) и недоступности сервера (`error_service_unavailable`).
* Web SDK теперь не запускает экран плагина повторно, если несколько раз нажать кнопку выбора жеста во время загрузки.
* Исправили ошибку `plugin_already_running` при повторных вызовах `open()` после завершения сессии (SPA, страницы с длительным жизненным циклом) или её аварийного завершения (ошибки сети, выгрузка страницы, ошибки инициализации).
* В Safari исправили ошибки загрузки ресурсов, из-за которых экран плагина не запускался, а камера при этом оставалась активной.
* Web SDK больше не вылетает при повторной загрузке скрипта loader.
* Web SDK больше не зависает, если запустить его во второй раз сразу после первого.
* Повысили стабильность и безопасность.
#### 1.9.2-15 – 30.12.2025
* Теперь можно менять внешний вид овала: добавили класс [`.ozliveness_face_stroke`](/oz-knowledge-ru/rukovodstva/rukovodstvo-razrabotchika/sdk/websdk/web-plugin/nastroika-interfeisa.md#ozliveness_face_stroke) . Поддерживаются все стандартные инструменты CSS.
* Добавили поддержку для `kk` как кода для казахского языка дополнительно к `kz`. `OzLiveness.set_lang('kk')` и `OzLiveness.set_lang('kz')` применяются одинаково.
* Состояние методов `OzLiveness.hide()` и `show()` теперь сохраняется между сессиями, больше не нужно вызывать их каждый раз.
* Добавили коллбэки:
* `on_media_stream_start` вызывается при успешном завершении `getUserMedia`,
* `on_media_stream_stop` вызывается после окончания захвата видео.
* Promise `ready()` теперь инициализирует плагин. Добавили методы:
* `OzLiveness.ready(): Promise` возвращает Promise, который выполняется после загрузки всех ресурсов плагина,
* `OzLiveness.isReady(): Boolean` проверяет статус инициализации.
* Исправили ошибку, из-за которой на экране между обработкой данных и загрузкой возникал пустой loader.
* При вводе неправильного кода языка SDK теперь показывает ошибку корректно.
* Локализация теперь работает корректно и при первом вызове `open()`.
* Повысили безопасность.
#### 1.8.1 – 09.10.2025
* Web SDK больше не вылетает с ошибкой, когда вы вызываете метод `OzLiveness.hide()` сразу после запуска плагина.
* Улучшили производительность.
* Повысили безопасность.
#### 1.8.0 – 26.09.2025
* Web Plugin теперь можно запустить в оконном режиме. Установите нужное значение `parent_container` в `OpenOptions`: `parent_container: string | HTMLElement`.
* Добавили возможность настройки переходов для loader. Соответствующие настройки приведены [здесь](/oz-knowledge-ru/rukovodstva/rukovodstvo-razrabotchika/sdk/websdk/web-plugin/nastroika-interfeisa.md#loadertransition).
* SDK теперь лучше работает с жестами наклона и подъема головы.
* Исправлена проблема с чрезмерным количеством сообщений об ошибках в консоли.
* Обновили телеметрию.
* Повысили безопасность.
#### 1.7.15 – 12.08.2025
* Вы можете настроить собственный loader вместо используемого по умолчанию. Соответствующие настройки приведены [здесь](/oz-knowledge-ru/rukovodstva/rukovodstvo-razrabotchika/sdk/websdk/web-plugin/nastroika-interfeisa.md#loaderslot).
* Вы можете управлять поведением SDK, если получение доступа к камере занимает слишком много времени. Воспользуйтесь настройками `get_user_media_promise_timeout_*`, приведенными [здесь](/oz-knowledge-ru/rukovodstva/rukovodstvo-razrabotchika/sdk/websdk/web-plugin/zapusk-plagina.md).
* Повысили безопасность и улучшили телеметрию.
#### 1.7.14-89-1 – 09.07.2025
* **Критические изменения**: мы больше не передаем в коллбэках значения оценок. `confidence_spoofing` нужно заменить на 0 для SUCCESS и на 1 для других статусов.
* Исправили ошибку чтения свойств `image_data_tensor`.
* Исправили ошибку, из-за которой OzLiveness иногда вызывался позже, чем нужно.
* Обновление безопасности.
#### 1.7.14 – 13.06.2025
* Добавили поддержку API 6.0.
* При настройке конфигурации сервера [переменные в заголовках CORS](/oz-knowledge-ru/rukovodstva/rukovodstvo-administratora/web-adapter/nastroika-servera-cherez-peremennye-okruzheniya.md) теперь указываются без кавычек.
* Добавили новый параметр `auth` , который указывает, используется ли авторизация, и если да, то каким способом:
* `true` (по умолчанию) – включена авторизация на базе генерируемого ключа доступа;
* `user:pass` – включена авторизация на базе логина и пароля;
* `false` – авторизация выключена.
* Добавили возможность [скрыть кнопку переключения камеры](/oz-knowledge-ru/rukovodstva/rukovodstvo-razrabotchika/sdk/websdk/web-plugin/nastroika-interfeisa.md#switchcamerabuttoncustomization).
* Настройки цвета для 3D-маски теперь работают корректно.
* Зеркалирование при отключенном `use_for_liveness` теперь также работает корректно.
* Поправили ошибку, из-за которой не выполнялось сканирование документа в плагине.
* Улучшили работу озвучки SDK: экранные дикторы читают подсказки по мере прохождения проверок (доступ к камере, загрузка и обработка данных, запрос результата) правильнее и при переключении подсказок реагируют быстрее.
* Добавили возможность проверки лицензии: \[GET] /check\_license.php.
* Уменьшили размер загружаемых компонентов.
* Результаты анализа в коллбэке `on_complete` при `result_mode: full` теперь передаются корректно.
* Исправили ошибку, из-за которой кнопка переключения камеры могла не отображаться.
* Передняя камера больше не отзеркаливает действия пользователя.
* Улучшили обработку ошибок.
* SDK теперь лучше работает на устройствах с низкой производительностью.
* Добавили проверку на закрытые глаза для жеста **Scan**.
* Исправили ошибки, повысили безопасность, обновили телеметрию и улучшили работу SDK в целом.
#### 1.6.15 – 27.12.2024
* Упрощены проверки, требующие от пользователя движения головы: актуально для жестов поворота головы влево или вправо, наклона головы вперед или назад.
* Пороговая дистанция для жестов, связанных с движением головы, была снижена: актуально для жестов поворота головы влево или вправо, наклона головы вперед или назад.
* Поведением приложения при обнаружении открытых инструментов разработчика теперь можно управлять.
* Теперь можно настроить сигнатуры методов с помощью контрольной суммы измененной функции, чтобы сделать их доверенными.
* Исправлена ошибка, из-за которой на экране съёмки после захвата жестов с движением головы неверно отображалась стрелка.
* Исправлена ошибка, из-за которой на экране съёмки при отображении фразы "Отлично!" исчезал овал.
* Улучшен поиск [лучшего кадра](https://doc.ozforensics.com/oz-knowledge-ru/rukovodstva/rukovodstvo-razrabotchika/api/oz-api/use-cases/best-shot).
* Обновления безопасности.
#### 1.6.12 – 18.10.2024
* Обновления безопасности.
* Исправили ошибку, из-за которой видео могло некорректно создаваться из последовательности кадров.
#### 1.6.0 – 24.06.2024
* Коллбэк-функция `on_complete` теперь вызывается после изменения общего статуса папки (заявки).
* Обновили инструкции по доступу к камере для браузеров Android Chrome и Facebook. Новые ключи:
* `error_no_camera_access`,
* `oz_tutorial_camera_android_chrome_with_screens_title`,
* `oz_tutorial_camera_android_chrome_instruction_screen_click_settings`,
* `oz_tutorial_camera_android_chrome_instruction_screen_permissions`,
* `oz_tutorial_camera_android_chrome_instruction_screen_allow_access`,
* `try_again`,
* `oz_tutorial_camera_external_browser_button`,
* `oz_tutorial_camera_external_browser_manual_open_link`,
* `oz_tutorial_camera_external_browser_title`.
* Добавили метод `get_langs()` – с его помощью можно узнать, какие языковые пакеты установлены в Web SDK.
* Добавили ошибку для ситуации, когда происходит обращение к несуществующему языковому пакету.
* Добавили ошибку для ситуации, когда не удалось загрузить необходимые ресурсы. Новый ключ: unable\_load\_resource.
* Обновили тексты ошибок `error_connection_lost` и `error_service_unavailable`.
* Обновили языковые файлы для Web SDK.
* Функция обрезки больше не добавляет полосы к кадрам c разрешением менее 512×512.
#### 1.5.3 – 28.05.2024
* Если доступ к камере отсутствует в течение длительного времени, пользователям теперь показывается инструкция, как его включить. Для всех браузеров, кроме Facebook, отображается инструкция по умолчанию, для Facebook – отдельная.
* Добавили несколько записей в файл локализации Web SDK. Новые ключи локализации:
* `accessing_camera_switch_to_another_browser`,
* `error_camera_timeout_instruction`,
* `error_camera_timeout_title`,
* `error_camera_timeout_android_facebook_instruction`.
#### 1.5.0 – 05.05.2024
* Улучшили работу с картоматами: расстояние, на котором может распознаваться лицо пользователя, увеличено.
* Добавили в Web Plugin параметр `disable_adaptive_aspect_ratio`. Этот параметр выключает подстройку соотношения сторон видео под окно съемки.
* Добавили в Web Plugin параметр `get_user_media_timeout`: когда SDK не может получить доступ к камере, по истечении этого таймаута появится подсказка, как решить проблему.
* Добавили несколько записей в файл локализации Web SDK. Новые ключи:
* `oz_tutorial_camera_android_edge_browser`
* `oz_tutorial_camera_android_edge_instruction`
* `oz_tutorial_camera_android_edge_title`
* `error_camera_timeout_instruction`
* `error_camera_timeout_title`
* Если SDK не может найти перевод для какого-либо из имеющихся ключей, соответствующее сообщение будет показываться на английском.
* Бессерверный Web SDK теперь можно распространять через Node Package Manager.
* Демонстрацию ошибок API в модальном окне теперь можно отключить. Установите параметру `disable_adapter_errors_on_screen` значение `True`.
* Мобильные браузеры теперь используют основную (заднюю) камеру для съемки документов.
* Обновили образцы кода.
* Исправили ошибку, когда при повторной попытке пользователя пройти сценарий после неудачи 3D-маска не реагировала на лицо.
* Обновления безопасности и журналирования.
#### 1.4.3 – 15.04.2024
* Исправили ошибку, из-за которой при съемке лица в горизонтальной ориентации на мобильных устройствах не показывалось предупреждение о необходимости поворота устройства вертикально.
* У некоторых пользователей ранее наблюдались зависания при использовании WebView. Теперь в этих случаях пользователь может нажать кнопку, чтобы продолжить работу с приложением. В связи с этим обновили файл со строками в [разделе локализации](/oz-knowledge-ru/rukovodstva/rukovodstvo-razrabotchika/sdk/websdk/web-plugin/lokalizaciya-dobavlenie-sobstvennogo-yazykovogo-paketa.md). Ключ: `tap_to_continue`.
#### 1.4.2 – 14.03.2024
* Расширили возможности отладки.
#### 1.4.1 – 27.02.2024
* Крупные обновления безопасности: улучшили защиту от виртуальных камер и модификации JavaScript-кода.
* Улучшили поддержку WebView:
* Добавили инструкции для неизвестных WebView-браузеров на платформах Android и iOS. Соответствующие события записываются при журналировании.
* Улучшили интеграцию с React Native: добавили атрибут `webkit-playsinline`, чтобы запуск камеры в полноэкранном режиме для iOS WebView работал корректно.
* Ошибка работы с iFrame при параметре `iframe_allowed` = `False` теперь отображается корректно.
* Новые ключи локализации:
* `oz_tutorial_camera_android_webview_browser`
* `oz_tutorial_camera_android_webview_instruction`
* `oz_tutorial_camera_android_webview_title`
#### 1.4.0 – 07.02.2024
* Web SDK теперь работает и с [черным списком](/oz-knowledge-ru/rukovodstva/rukovodstvo-razrabotchika/api/oz-api/use-cases/collection.md): вы можете сравнить лицо из снятого Liveness-медиафайла с лицами из вашей базы данных. Создайте коллекцию (или коллекции) с нужными фотографиями через [API](/oz-knowledge-ru/rukovodstva/rukovodstvo-razrabotchika/api/oz-api/use-cases/collection/rabota-s-kollekciei-v-oz-api.md) или [веб-интерфейс](/oz-knowledge-ru/rukovodstva/rukovodstvo-polzovatelya/oz-webui/blacklist.md) и добавьте соответствующий идентификатор (или идентификаторы) в массив `analyses.collection_ids` в файле конфигурации веб-адаптера.
* Мы вернули поддержку iframe: установите для параметра `iframe_allowed` в файле конфигурации Web Adapter значение `True`.
* Интервал опроса для получения результатов анализов теперь можно настраивать. При необходимости измените его в параметре `results_polling_interval` файла конфигурации Web Adapter.
* Теперь вы можете выбрать, какую камеру использовать, переднюю или заднюю, и через веб-плагин. В методе `OzLiveness.open()` установите для `cameraFacingMode` значение `user` для передней камеры и `environment` для задней. Этот параметр работает только в том случае, если для параметра `use_for_liveness` в файле конфигурации веб-адаптера не установлено значение.
* Стили плагина теперь добавляются автоматически. **Обратите внимание: удалите стили, которые вы ранее применили к странице клиента вручную** (строка ``), чтобы избежать конфликтов.
* Исправлены некоторые ошибки и улучшено журналирование.
#### 1.3.1 – 12.01.2024
* Улучшили защиту против инъекционных атак.
* Заменили идентификатор языка для бразильского португальского с `pt` на `pt-br` согласно стандарту ISO.
* Удалили конфигурационный параметр `lang_default`.
* Прозрачность 3D-маски теперь можно настраивать.
* Добавили возможность использования мастер-лицензии, которая работает без ограничений по домену.
* Добавили параметр master\_license\_signature в параметры конфигурации Web Adapter.
* Исправили ошибки.
#### 1.2.2 – 15.12.2024
* Улучшили работу SDK.
#### 1.2.1 – 04.11.2023
* Добавили 3D-маску, которая заменяет овал при съемке видео нашим SDK. Для включения маски установите [конфигурационному параметру](/oz-knowledge-ru/rukovodstva/rukovodstvo-administratora/web-adapter/nastroiki-faila-konfiguracii.md) `load_3d_mask` значение `true`.
* Обновили телеметрию (журналирование).
#### 1.1.5 – 27.10.2023
* Обновления журналирования.
#### 1.1.4 – 10.2023
* Обновления безопасности.
#### 1.1.3 – 29.09.2023
* Улучшили работу SDK.
#### 1.1.2 – 21.09.2023
* Улучшили работу SDK.
#### 1.1.1 – 29.08.2023
* Исправили ошибки.
#### 1.1.0 – 24.08.2023
* Изменили сигнатуру коллбэка `on_error():` теперь он возвращает не только код ошибки, но и сообщение, а также идентификатор телеметрии для журналирования.
* Добавили параметр конфигурации для режима debug. Если он принимает значение True, в Web SDK можно открыть страницу /debug.php, на которой размещена информация о текущих конфигурации и лицензии.
* Исправили несколько ошибок и улучшили журналирование.
#### 1.0.2 – 06.07.2023
* Добавили возможность выбора камеры при запуске плагина (если на устройстве их несколько).
#### 1.0.1 – 01.07.2023
* Полностью переделали дизайн для SDK и демо, в том числе добавили настройки защиты от мошенников: при включении опции во время записи видео появляется дополнительное сообщение. Новые возможности настройки интерфейса описаны [здесь](/oz-knowledge-ru/rukovodstva/rukovodstvo-razrabotchika/sdk/websdk/web-plugin/nastroika-interfeisa.md).
* Перевели SDK на португальский, испанский и казахский языки.
* Добавили жест **Комбо**.
* Добавили шкалу прогресса для загрузки медиа.
* Жесты **Zoom in** и **Zoom out** больше не поддерживаются.
* Съемка видео в альбомной ориентации теперь работает корректно для планшетов.
* Убрали опцию `lang_allow` из файла конфигурации Web Adapter.
#### 0.9.1 – 01.03.2023
* В архитектуре `capture` при обнаружении виртуальной камеры параметр `additional_info` теперь отображается внутри списка `from_virtual_camera`.
* Добавили возможность обрезать кадр с лицом без потери качества.
* Координаты "ориентиров" лица для архитектуры capture теперь передаются корректно.
#### 0.9.0 – 20.02.2023
* Улучшили качество съемки;
* Значительно переработали [лицензирование](https://doc.ozforensics.com/oz-knowledge-ru/rukovodstva/rukovodstvo-razrabotchika/sdk/websdk/pages/VqxBRlAW9cwkwAUjCRTt#h.ybr487kg4ab4):
* добавили описание ошибок, теперь понятно, что и почему произошло;
* теперь можно указывать лицензию в JS в процессе работы;
* при применении в `OzLiveness.open()` лицензия переписывает предыдущую;
* лицензия теперь не требует указания порта и протокола;
* в URL лицензии можно указывать поддомены;
* информация о лицензии выводится в лог Docker при запуске плагина на сервере;
* при использовании на localhost и 127.0.01 лицензия больше не запрашивается;
* Коллбэк `on_capture_complete` вызывается на всех архитектурах по завершении съемки видео и содержит информацию о жестах на этом видео;
* При запуске Oz Web Liveness и Oz Web Adapter их версии теперь выводятся в лог Docker;
* [Добавили параметры](/oz-knowledge-ru/rukovodstva/rukovodstvo-razrabotchika/sdk/websdk/web-plugin/zapusk-plagina/semka-video-i-opisanie-kollbeka-on_capture_complete.md) для передачи при съемке информации о прямоугольнике, в который вписано лицо;
* Убрали неиспользуемое поле adapter\_version из метаданных заявки;
* Починили кнопку переключения камер в Google Chrome;
* При старте Web SDK в лог Docker выводятся фактические параметры конфигурации.
#### 0.7.6 – 27.09.2022
* Изменили расширение некоторых файлов системы Oz Forensics с .bin на .dat.
#### 0.7.5
* Ссылки на дополнительные скрипты теперь формируются с использованием адреса основного скрипта.
#### 0.7.4
* Добавили возможность распространять Web SDK только статическими файлами, без адаптера (в режиме capture).
* Web SDK теперь может работать с CDN.
* Теперь можно запускать несколько экземпляров Oz Liveness Web Plugin на разных страницах, в этом случае необходимо указать на этих страницах путь для загрузки скриптов.
{% hint style="info" %}
При обновлении с **0.4.0** лицензию необходимо также обновить.
{% endhint %}
#### 0.4.1
* Исправили ошибку экрана съемки.
#### 0.4.0
* Добавили лицензирование, для получения лицензии необходим origin.
* Внешний вид Web SDK теперь можно [настраивать](/oz-knowledge-ru/rukovodstva/rukovodstvo-razrabotchika/sdk/websdk/web-plugin.md#nastroika-interfeisa).
#### 0.3.2044
* Исправили ошибки интеграции с Angular.
#### 0.3.2043
* Исправили ошибку с отсутствием секции IMAGE\_FOLDER в JSON-ответе при включенном lossless-кадре.
#### 0.3.2042
* Исправили ошибки работы с библиотекой ravenjs.
#### 0.3.2041
* Рамку для фото документов теперь можно настроить.
#### 0.3.2012
* Повысили безопасность SDK.
#### 0.3.2009 (0.4.8)
* Названия всех доступных пользователю камер теперь добавляем в метаинформацию.
#### 0.3.2005 (0.4.8)
* В формате видео / режиме zip теперь можно загружать lossless-кадр.
* Best Shot теперь работает корректно.
#### 0.3.2004 (0.4.8)
* В ответах сервера код ошибки и расшифровка теперь передаются раздельно.
#### 0.3.2001 (0.4.6)
* Если режим для SDK настроен в переменных окружения `architecture`, `api_url`, то он применяется в настройках автоматически.
* В режиме lite можно выбрать best frame для любого действия.
* В режиме lite фото, отправленное через API, получает статус `on_complete` только при успешном liveness.
* Можно управлять cors из переменных окружения (по умолчанию заголовки cors не добавляются).
#### 0.3.1999
* Добавили значение `folder` для `result_mode`: оно возвращает тот же ответ, что и значение `status`, но с `folder_id`.
#### 0.3.1997 (0.4.5)
* Оптимизировали шифрование: теперь шифруем только метаданные, необходимые для расшифровки объекта.
* Оптимизировали отправку данных: теперь изображения отправляются в отдельных полях формы, а не в одном JSON-объекте.
* Добавили проверку поддерживаемых параметров камеры.
#### 0.3.1992 (0.4.4)
* Включили новый метод шифрования изображений.
* Оптимизировали формат отправки изображений.
#### 0.3.1991
* Добавили опцию `use_for_liveness`: при съемке лица на мобильных устройствах выбирается тыловая камера, а на десктопе отключаются флип и обводка овала. По умолчанию опция отключена.
#### 0.3.1990 (0.4.3)
* Уменьшили время видео video\_selfie\_best (жест Selfie) с 1 до 0,2 сек.
* Оптимизировали загрузку скриптов – теперь ее можно настраивать.
* Повысили точность работы алгоритмов.
#### 0.3.1988 (0.4.2)
* Добавили казахский язык.
* Добавили инструкцию по доступу к камере для десктопа.
* Дополнили журналирование – пишутся запросы к plugin\_liveness.php и user-agent в лог сервера.
* Добавили возможность работы с режимом Lite.
#### 0.3.1987 (0.4.1)
* Добавили шифрование.
* Обновили библиотеки.
#### 0.3.1986 (0.3.91)
* Добавили возможность скрывать логотип Oz Forensics.
#### 0.3.1984
* Дополнили руководства для некоторых браузеров и социальных сетей.
* Добавили обработку неизвестных и руководство для "неизвестных" браузеров.
#### 0.3.1983
* Оптимизировали потребление памяти для рамки.
* Добавили руководство по включению камер в различных браузерах под Android.
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://doc.ozforensics.com/oz-knowledge-ru/rukovodstva/rukovodstvo-razrabotchika/sdk/websdk/zhurnal-izmenenii.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.