# Локализация: добавление собственного языкового пакета

Для добавления нового языкового пакета или модификации существующего следует воспользоваться методом `add_lang(lang_id, lang_obj)`.

Параметры:

* `lang_id` – строковое значение, которое далее можно использовать в качестве параметра `lang` метода `open()`;
* `lang_obj`– объект, ключами которого являются идентификаторы строк перевода, а значениями – сами строки перевода.

Список идентификаторов языков:

| lang\_id   | Язык                        |
| ---------- | --------------------------- |
| en         | Английский                  |
| ru         | Русский                     |
| es         | Испанский                   |
| pt-br[^1]  | Португальский (бразильский) |
| kz, kk[^2] | Казахский                   |

Пример использования:

`OzLiveness.add_lang('ru', ruTranslation)`, где`ruTranslation` – объект JSON.

```javascript
// Редактируем текст кнопки
OzLiveness.add_lang('ru', {
  action_photo_button: 'Сделать фото'
});
```

Для установки нужного языка укажите его идентификатор в `lang`:

```javascript
OzLiveness.open({
    lang: 'es', // идентификатор нужного языка
    ...
});
```

Вы можете запросить, какие языковые пакеты установлены в Web SDK, с помощью метода `ozLiveness.get_langs()`. Добавленные вручную локали также отобразятся.

Список всех строковых идентификаторов:

{% file src="/files/JtcW80vepnxNXypzrMFy" %}

Ключи вида `oz_action_*_go` относятся к соответствующим жестам. `oz_tutorial_camera_*` – к подсказкам, как включить камеру для различных браузеров. Остальные – к подсказкам для всех жестов, информационным сообщениям или ошибкам.

Если какие-либо из ключей в вашем языковом пакете отсутствуют, соответствующие строки будут отображаться на английском языке.

<details>

<summary>Для версий до 1.5.0</summary>

Если какие-либо из ключей в вашем языковом пакете отсутствуют, соответствующие строки отображаться не будут.

</details>

[^1]: До версии 1.3.1 назывался `pt`

[^2]: Поддерживается с версии 1.9.2


---

# 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/web-plugin/lokalizaciya-dobavlenie-sobstvennogo-yazykovogo-paketa.md?ask=<question>
```

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.