---
title: Инициализация
canonical: https://developer.unico.io/ru/dual-api/developers/sdks-and-tools/web/web-sdk/initialization
locale: ru
generated_by: markdown-export
---

## Когда инициализировать

Инициализируйте SDK как можно раньше — как правило, при загрузке страницы или компонента, содержащего рамку захвата. Подробнее о том, почему не следует инициализировать по нажатию кнопки захвата, см. в разделе [Лучшие практики](/dual-api/developers/sdks-and-tools/web/web-sdk/resources).

## Встраивание учётных данных

Реализуйте класс `UnicoConfig` с учётными данными, предоставленными командой onboarding:

```javascript
import { UnicoConfig } from "unico-webframe"

const config = new UnicoConfig()
  .setHostname("<YOUR_HOSTNAME>")
  .setHostKey("<YOUR_HOST_KEY>");
```

## Создание экземпляра builder

Создайте новый экземпляр `UnicoCheckBuilder`:

```javascript
const unicoCameraBuilder = new UnicoCheckBuilder();
```

## Настройка путей к ресурсам

Укажите путь к дополнительным файлам (если они добавлены в ваш проект):

```javascript
unicoCameraBuilder.setResourceDirectory("/resources");
```

Укажите путь к файлам моделей ИИ (требуется только для умного режима камеры):

```javascript
unicoCameraBuilder.setModelsPath("https://yoursite.com/models");
```

:::info[Автозагрузка с версии 3.18.0]
Начиная с версии 3.18.0, SDK может автоматически загружать дополнительные ресурсы — просто не реализуйте `setResourceDirectory` и убедитесь, что [конфигурация CSP](/dual-api/developers/sdks-and-tools/web/web-sdk/installation) применена корректно.
:::

## Настройка CSS Reset (необязательно)

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

```javascript
unicoCameraBuilder.disableCssReset();
```

## Выбор среды

Выбор между **sandbox** и **production** осуществляется во время инициализации. Используйте перечисление `SDKEnvironmentTypes`:

- `SDKEnvironmentTypes.PROD` — производственная среда
- `SDKEnvironmentTypes.UAT` — среда тестирования

```javascript
import {
  UnicoCheckBuilder,
  SDKEnvironmentTypes
} from "unico-webframe"

unicoCameraBuilder.setEnvironment(SDKEnvironmentTypes.UAT);
```

:::info
Если настройка не выполнена, Web SDK использует производственную среду по умолчанию.
:::

Полный список доступных типов среды см. в разделе [Справочник API > API инициализации](/dual-api/developers/sdks-and-tools/web/web-sdk/api-reference/initialization-api).

## Жизненный цикл

Аутентификация SDK с бэкендом занимает несколько секунд. **Инициализируйте заблаговременно**, а не по нажатию пользователем кнопки захвата — иначе пользователь ощутит задержку между нажатием и открытием камеры.