> For the complete documentation index, see [llms.txt](https://doc.ozforensics.com/oz-knowledge-ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.ozforensics.com/oz-knowledge-ru/rukovodstva/rukovodstvo-razrabotchika/sdk/websdk.md).

# Oz Liveness Web SDK

Oz Liveness Web SDK представляет собой модуль съемки и отправки медиаданных на анализы из веб-браузера на клиентском устройстве. Web SDK снимает видео в разрешении [720p HD (1280×720 пикс.)](#user-content-fn-1)[^1].

Поддерживаются все основные браузеры на большинстве устройств. Доступные языки: EN, RU, ES, PT-BR, KK.

Образец кода Oz Liveness Web SDK находится [здесь](https://gitlab.com/oz-forensics/oz-liveness-sample-web/-/blob/master/OzLivenessWebSDKSample.html). Чтобы все работало корректно, нужно заменить `<web-adapter-url>` на полученную от нас ссылку на Web Adapter.

Для Angular и React нужно заменить `https://web-sdk.sandbox.ozforensics.com` в index.html.

* Образец кода для [Angular](https://gitlab.com/oz-forensics/oz-liveness-sample-web-angular)
* Образец кода для [React](https://gitlab.com/oz-forensics/oz-liveness-sample-web-react/-/tree/main)
* Образец кода для [Vue](https://gitlab.com/oz-forensics/oz-liveness-sample-web-vue)
* Образец кода для [Svelte](https://gitlab.com/oz-forensics/oz-liveness-sample-web-svelte)

Web SDK только работает по протоколу HTTPS (с SSL-шифрованием); на localhost и 127.0.01 можно использовать HTTP для проверки доступности ресурсов.

Oz Liveness Web SDK состоит из двух частей:

1. Клиентская — [Oz Liveness Web Plugin](/oz-knowledge-ru/rukovodstva/rukovodstvo-razrabotchika/sdk/websdk/web-plugin.md). Используется в виде подгружаемого JavaScript-файла в Frontend-приложении клиента.
2. Серверная — [Oz Liveness Web Adapter](/oz-knowledge-ru/rukovodstva/rukovodstvo-administratora/web-adapter.md). Устанавливается в виде отдельного серверного модуля с привязкой к [Oz API](/oz-knowledge-ru/rukovodstva/rukovodstvo-razrabotchika/api/oz-api.md).

Руководства по интеграции:

{% content-ref url="/pages/f08036ac9bcc05da1c7457ad4f4980dd012a879b" %}
[Как интегрировать Oz Liveness в ваше веб-приложение](/oz-knowledge-ru/obshaya-informaciya/kratkie-rukovodstva-po-integracii/kak-integrirovat-oz-liveness-v-vashe-veb-prilozhenie.md)
{% endcontent-ref %}

{% content-ref url="/pages/c1cb74aa33300e75c4c3d97124e4097afa2121eb" %}
[Как запустить биометрический анализ (сопоставление лиц)](/oz-knowledge-ru/obshaya-informaciya/kratkie-rukovodstva-po-integracii/kak-zapustit-biometricheskii-analiz-sopostavlenie-lic.md)
{% endcontent-ref %}

<figure><img src="https://2041336905-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHLoHbtSPFA1Ul7oKM5SC%2Fuploads%2FYkmEoCFmVTOaMbVwVQ3z%2Fcomponents-public-websdk.svg?alt=media&amp;token=57afd11e-5ba3-425a-ac38-8c83862dc44c" alt=""><figcaption></figcaption></figure>

Oz Web SDK можно развернуть как [на ваших серверах](/oz-knowledge-ru/rukovodstva/rukovodstvo-administratora/web-adapter/ustanovka-i-licenzirovanie.md), так и на наших (SaaS), в последнем случае разворачиваем и поддерживаем программное обеспечение мы, а вы пользуетесь уже готовым и настроенным продуктом. [Свяжитесь с нами](mailto:info@ozforensics.com) для выбора более удобного варианта.

Для работы Web SDK потребуется информация о доменных именах сайтов, где вы будете его использовать (она необходима для оформления лицензии).

Пошаговая инструкция по использованию Web SDK:

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th data-hidden></th><th data-hidden></th></tr></thead><tbody><tr><td><ol><li>Работа на ваших серверах</li></ol></td><td><ul><li>Установите Web SDK. Вам помогут наши инженеры. Лицензия также будет установлена в этот момент. Когда вам потребуется ее обновить, воспользуйтесь этой статьей.</li><li>Настройте <a href="/oz-knowledge-ru/rukovodstva/rukovodstvo-administratora/web-adapter.md">Web Adapter</a>.</li></ul></td><td></td><td></td></tr><tr><td><ol><li>SaaS</li></ol></td><td><ul><li>Ничего делать не нужно, установку и настройку серверной части обеспечивают инженеры Oz Forensics. Вы получите ссылку для интеграции (см. п. 2).</li></ul></td><td></td><td></td></tr></tbody></table>

2. [Интегрируйте](/oz-knowledge-ru/rukovodstva/rukovodstvo-razrabotchika/sdk/websdk/web-plugin/dobavlenie-plagina-na-web-stranicu.md) плагин в свою страницу.
3. Если вы хотите настроить интерфейс Oz Web SDK под себя, [здесь](/oz-knowledge-ru/rukovodstva/rukovodstvo-razrabotchika/sdk/websdk/web-plugin/nastroika-interfeisa.md) рассказано, как это сделать.

Web SDK поддерживает интеграцию в мобильные приложения через WebView. Однако для сценариев, где безопасность особенно важна, мы рекомендуем использовать Mobile SDK.

[^1]: Если камера не поддерживает это разрешение, браузер переключается на разрешение, которое выберет камера.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://doc.ozforensics.com/oz-knowledge-ru/rukovodstva/rukovodstvo-razrabotchika/sdk/websdk.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
