# General Translation Integrations: API de Replayer
URL: https://generaltranslation.com/es/docs/integrations/rrweb/reference/replayer.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Reproduce un bundle de rrweb con superposiciones de texto localizado y controles de reproducción. Referencia de la API del replayer de gt-rrweb.

Importa los valores del replayer desde `gt-rrweb/replay`. Este entry point exporta el wrapper de React y requiere React, React DOM 18 o una versión posterior, y `@rrweb/types`, incluso cuando solo uses `createGTReplayer`; el reproductor del DOM también requiere la dependencia entre pares opcional `@rrweb/replay`.

## Descripción general [#overview]

| API                                       | Descripción                                                       |
| ----------------------------------------- | ----------------------------------------------------------------- |
| [`createGTReplayer`](#create-gt-replayer) | Monta un reproductor en un elemento del DOM.                      |
| [`GTReplayer`](#gt-replayer)              | wrapper de React para `createGTReplayer`.                         |
| [`GTReplayerProps`](#replayer-props)      | Props que acepta `GTReplayer`.                                    |
| [`GTReplayerBundle`](#replayer-bundle)    | Flujo de eventos y datos de configuración regional opcionales.    |
| [`GTReplayerOptions`](#replayer-options)  | Configuración regional inicial y opciones de cambio y depuración. |
| [`GTReplayerHandle`](#replayer-handle)    | Destruye un reproductor montado.                                  |

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

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

La función monta un reproductor independiente e inicia la reproducción. Incluye un área de reproducción con bandas negras, un cursor que responde a los clics, una barra de progreso, controles de tema claro y oscuro, de pantalla completa y un selector de configuración regional cuando el bundle lo admite.

El contenedor debe dimensionarse mediante su elemento padre. Llame a `destroy()` antes de eliminar o reutilizar el contenedor.

Un bundle con menos de dos eventos muestra un error dentro del reproductor y devuelve un manejador cuyo método `destroy()` no hace nada de forma segura.

## `GTReplayer` [#gt-replayer]

`GTReplayer` monta `createGTReplayer` en un contenedor administrado por React y lo destruye al desmontarse. Vuelve a crear el reproductor cuando cambian `bundle`, `initialLocale`, `switchLocalesAllowed` o `debug`.

## `GTReplayerProps` [#replayer-props]

| Prop                   | Descripción                                                                     | Tipo               | Opcional | Predeterminado      |
| ---------------------- | ------------------------------------------------------------------------------- | ------------------ | -------- | ------------------- |
| `bundle`               | Grabación que se va a reproducir.                                               | `GTReplayerBundle` | No       | —                   |
| `initialLocale`        | Configuración regional renderizada al montar.                                   | `string`           | Sí       | `bundle.locales[0]` |
| `switchLocalesAllowed` | Muestra controles de configuración regional y permite cambiarla en tiempo real. | `boolean`          | Sí       | `true`              |
| `debug`                | Acepta archivos JSON de grabación arrastrados y soltados.                       | `boolean`          | Sí       | `false`             |
| `className`            | Clase aplicada al contenedor host.                                              | `string`           | Sí       | —                   |
| `style`                | Estilo inline aplicado al contenedor host.                                      | `CSSProperties`    | Sí       | —                   |

## `GTReplayerBundle` [#replayer-bundle]

| Campo     | Descripción                                                                 | Tipo                | Opcional | Predeterminado |
| --------- | --------------------------------------------------------------------------- | ------------------- | -------- | -------------- |
| `events`  | Flujo de eventos de rrweb.                                                  | `eventWithTime[]`   | No       | —              |
| `locales` | Locales disponibles, con el de origen primero.                              | `readonly string[]` | Sí       | —              |
| `overlay` | Asigna configuraciones regionales a mapas de texto por ID de nodo de rrweb. | `LocaleTextOverlay` | Sí       | —              |

Un bundle sin procesar que solo contiene eventos se reproduce en la configuración regional de origen registrada. Los eventos emitidos por `gt-rrweb` también pueden incluir metadatos de configuración regional y superposición en el flujo.

## `GTReplayerOptions` [#replayer-options]

| Opción                 | Descripción                                                                                      | Tipo      | Opcional | Predeterminado                   |
| ---------------------- | ------------------------------------------------------------------------------------------------ | --------- | -------- | -------------------------------- |
| `initialLocale`        | Configuración regional que se renderiza al montar; se ignora si no está incluida en el bundle.   | `string`  | Sí       | Configuración regional de origen |
| `switchLocalesAllowed` | Habilita el selector de configuración regional dentro del reproductor.                           | `boolean` | Sí       | `true`                           |
| `debug`                | Habilita el reemplazo del bundle mediante arrastrar y soltar para realizar inspecciones locales. | `boolean` | Sí       | `false`                          |

Al cambiar la configuración regional, el texto se reemplaza en el mismo documento sin volver a generar la reproducción. Si se sueltan archivos no válidos, se muestra un aviso en el reproductor.

## `GTReplayerHandle` [#replayer-handle]

`GTReplayerHandle` expone un método, `destroy(): void`, que elimina el reproductor y sus listeners del contenedor.

## Sitemap

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