# General Translation Integrations: API Replayer
URL: https://generaltranslation.com/ru/docs/integrations/rrweb/reference/replayer.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Воспроизведение бандла rrweb с наложениями локализованного текста и элементами управления воспроизведением. Справочник по API для replayer из gt-rrweb.

Импортируйте значения replayer из `gt-rrweb/replay`. Эта точка входа экспортирует React-обёртку и требует React, React DOM 18 или более поздней версии и `@rrweb/types`, даже если вы используете только `createGTReplayer`; DOM-проигрывателю также требуется необязательная peer-зависимость `@rrweb/replay`.

## Обзор [#overview]

| API                                       | Описание                                            |
| ----------------------------------------- | --------------------------------------------------- |
| [`createGTReplayer`](#create-gt-replayer) | Монтирует проигрыватель в элемент DOM.              |
| [`GTReplayer`](#gt-replayer)              | React-обёртка для `createGTReplayer`.               |
| [`GTReplayerProps`](#replayer-props)      | Пропсы, принимаемые `GTReplayer`.                   |
| [`GTReplayerBundle`](#replayer-bundle)    | Поток событий и необязательные данные локали.       |
| [`GTReplayerOptions`](#replayer-options)  | Параметры начальной локали, переключения и отладки. |
| [`GTReplayerHandle`](#replayer-handle)    | Удаляет смонтированный проигрыватель.               |

## `createGTReplayer` [#create-gt-replayer]

```ts
function createGTReplayer(
  container: HTMLElement,
  bundle: GTReplayerBundle,
  options?: GTReplayerOptions
): GTReplayerHandle;
```

Функция монтирует автономный проигрыватель и запускает воспроизведение. В нём предусмотрены сцена с сохранением пропорций, управление курсором щелчками, ползунок перемотки, переключатель светлой и тёмной тем, полноэкранный режим и переключатель локалей, если бандл их поддерживает.

Размер контейнера должен определяться его родительским элементом. Вызовите `destroy()` перед удалением или повторным использованием контейнера.

Если в бандле меньше двух событий, проигрыватель показывает ошибку и возвращает обработчик, метод `destroy()` которого безопасно ничего не делает.

## `GTReplayer` [#gt-replayer]

`GTReplayer` монтирует `createGTReplayer` в контейнер под управлением React и удаляет его при размонтировании. При изменении `bundle`, `initialLocale`, `switchLocalesAllowed` или `debug` проигрыватель создаётся заново.

## `GTReplayerProps` [#replayer-props]

| Prop                   | Описание                                                                               | Тип                | Необязательно | По умолчанию        |
| ---------------------- | -------------------------------------------------------------------------------------- | ------------------ | ------------- | ------------------- |
| `bundle`               | Запись для воспроизведения.                                                            | `GTReplayerBundle` | Нет           | —                   |
| `initialLocale`        | Локаль, отображаемая при монтировании.                                                 | `string`           | Да            | `bundle.locales[0]` |
| `switchLocalesAllowed` | Отображает элементы управления локалями и позволяет переключать их в реальном времени. | `boolean`          | Да            | `true`              |
| `debug`                | Принимает JSON-файлы записей, перетаскиваемые в интерфейс.                             | `boolean`          | Да            | `false`             |
| `className`            | Класс, применяемый к контейнеру-хосту.                                                 | `string`           | Да            | —                   |
| `style`                | Встроенный стиль, применяемый к контейнеру-хосту.                                      | `CSSProperties`    | Да            | —                   |

## `GTReplayerBundle` [#replayer-bundle]

| Поле      | Описание                                                        | Тип                 | Необязательно | По умолчанию |
| --------- | --------------------------------------------------------------- | ------------------- | ------------- | ------------ |
| `events`  | Поток событий rrweb.                                            | `eventWithTime[]`   | Нет           | —            |
| `locales` | Доступные локали, начиная с исходной.                           | `readonly string[]` | Да            | —            |
| `overlay` | Сопоставление идентификаторов узлов rrweb с текстом для локали. | `LocaleTextOverlay` | Да            | —            |

Необработанный бандл, содержащий только события, воспроизводится в записанной исходной локали. События, генерируемые `gt-rrweb`, также могут содержать в потоке метаданные локали и наложения.

## `GTReplayerOptions` [#replayer-options]

| Параметр               | Описание                                                                   | Тип       | Необязательно | По умолчанию    |
| ---------------------- | -------------------------------------------------------------------------- | --------- | ------------- | --------------- |
| `initialLocale`        | Локаль, отображаемая при монтировании; игнорируется, если её нет в бандле. | `string`  | Да            | Исходная локаль |
| `switchLocalesAllowed` | Включает переключатель локалей в проигрывателе.                            | `boolean` | Да            | `true`          |
| `debug`                | Включает замену бандла перетаскиванием для локальной проверки.             | `boolean` | Да            | `false`         |

При смене локали текст заменяется на месте без перезапуска воспроизведения. При перетаскивании некорректного файла в проигрывателе отображается уведомление.

## `GTReplayerHandle` [#replayer-handle]

`GTReplayerHandle` предоставляет единственный метод — `destroy(): void`, который удаляет проигрыватель и его обработчики событий из контейнера.

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.