# General Translation Integrations: API Replayer
URL: https://generaltranslation.com/it/docs/integrations/rrweb/reference/replayer.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Riproduce un bundle rrweb con sovrapposizioni di testo localizzato e controlli di riproduzione. Riferimento API del replayer di gt-rrweb.

Importa i valori del replayer da `gt-rrweb/replay`. Questo entry point esporta il wrapper React e richiede React, React DOM 18 o versioni successive e `@rrweb/types`, anche quando usi solo `createGTReplayer`; il player DOM richiede inoltre la dipendenza peer facoltativa `@rrweb/replay`.

## Panoramica [#overview]

| API                                       | Descrizione                                                                  |
| ----------------------------------------- | ---------------------------------------------------------------------------- |
| [`createGTReplayer`](#create-gt-replayer) | Monta un player in un elemento DOM.                                          |
| [`GTReplayer`](#gt-replayer)              | Wrapper React di `createGTReplayer`.                                         |
| [`GTReplayerProps`](#replayer-props)      | Props accettate da `GTReplayer`.                                             |
| [`GTReplayerBundle`](#replayer-bundle)    | Flusso di eventi e dati relativi all'impostazione regionale facoltativi. |
| [`GTReplayerOptions`](#replayer-options)  | Impostazione regionale iniziale, opzioni di cambio e debug.                  |
| [`GTReplayerHandle`](#replayer-handle)    | Distrugge un player montato.                                                 |

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

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

La funzione monta un player autonomo e avvia la riproduzione. Include un'area con bande nere, un cursore cliccabile, una barra di avanzamento, controlli per i temi chiaro e scuro, un controllo per la modalità a schermo intero e un selettore dell'impostazione regionale, se supportato dal bundle.

Il contenitore deve essere dimensionato dal relativo elemento padre. Chiama `destroy()` prima di rimuovere o riutilizzare il contenitore.

Un bundle con meno di due eventi mostra un errore all'interno del player e restituisce un handle il cui metodo `destroy()` non esegue alcuna operazione in modo sicuro.

## `GTReplayer` [#gt-replayer]

`GTReplayer` monta `createGTReplayer` in un contenitore gestito da React e lo distrugge quando viene smontato. Ricrea il player quando cambiano `bundle`, `initialLocale`, `switchLocalesAllowed` o `debug`.

## `GTReplayerProps` [#replayer-props]

| Prop                   | Descrizione                                                                                | Tipo               | Facoltativo | Predefinito         |
| ---------------------- | ------------------------------------------------------------------------------------------ | ------------------ | ----------- | ------------------- |
| `bundle`               | Registrazione da riprodurre.                                                               | `GTReplayerBundle` | No          | —                   |
| `initialLocale`        | Impostazione regionale renderizzata al montaggio.                                          | `string`           | Sì          | `bundle.locales[0]` |
| `switchLocalesAllowed` | Mostra i controlli dell'impostazione regionale e consente di cambiarla in tempo reale. | `boolean`          | Sì          | `true`              |
| `debug`                | Accetta file JSON di registrazione trascinati.                                             | `boolean`          | Sì          | `false`             |
| `className`            | Classe applicata al contenitore host.                                                      | `string`           | Sì          | —                   |
| `style`                | Stile inline applicato al contenitore host.                                                | `CSSProperties`    | Sì          | —                   |

## `GTReplayerBundle` [#replayer-bundle]

| Campo     | Descrizione                                                       | Tipo                | Facoltativo | Predefinito |
| --------- | ----------------------------------------------------------------- | ------------------- | ----------- | ----------- |
| `events`  | Flusso di eventi rrweb.                                           | `eventWithTime[]`   | No          | —           |
| `locales` | Impostazioni regionali disponibili, con la sorgente per prima.    | `readonly string[]` | Sì          | —           |
| `overlay` | Mappa dalle impostazioni regionali al testo dei node ID di rrweb. | `LocaleTextOverlay` | Sì          | —           |

Un bundle non elaborato contenente solo eventi viene riprodotto nell'impostazione regionale sorgente registrata. Gli eventi emessi da `gt-rrweb` possono anche includere nel flusso metadati relativi all'impostazione regionale e all'overlay.

## `GTReplayerOptions` [#replayer-options]

| Opzione                | Descrizione                                                                              | Tipo      | Facoltativo | Predefinito                     |
| ---------------------- | ---------------------------------------------------------------------------------------- | --------- | ----------- | ------------------------------- |
| `initialLocale`        | Impostazione regionale renderizzata al montaggio; ignorata se non è presente nel bundle. | `string`  | Sì          | Impostazione regionale sorgente |
| `switchLocalesAllowed` | Abilita il selettore dell'impostazione regionale nel player.                         | `boolean` | Sì          | `true`                          |
| `debug`                | Abilita la sostituzione del bundle tramite trascinamento per l'ispezione locale.     | `boolean` | Sì          | `false`                         |

La modifica dell'impostazione regionale sostituisce il testo in-place senza ricreare la riproduzione. I file non validi rilasciati generano un avviso nel player.

## `GTReplayerHandle` [#replayer-handle]

`GTReplayerHandle` espone un unico metodo, `destroy(): void`, che rimuove il player e i relativi listener dal contenitore.

## Sitemap

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