# General Translation Integrations: API Replayer
URL: https://generaltranslation.com/fr/docs/integrations/rrweb/reference/replayer.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Lire un bundle rrweb avec des superpositions de texte localisé et des commandes de lecture. Référence d’API du replayer gt-rrweb.

Importez les valeurs du replayer depuis `gt-rrweb/replay`. Ce point d’entrée exporte le wrapper React et nécessite React, React DOM 18 ou une version ultérieure, ainsi que `@rrweb/types`, même si vous n’utilisez que `createGTReplayer` ; le lecteur DOM nécessite également la dépendance pair facultative `@rrweb/replay`.

## Vue d’ensemble [#overview]

| API                                       | Description                                                         |
| ----------------------------------------- | ------------------------------------------------------------------- |
| [`createGTReplayer`](#create-gt-replayer) | Monte un lecteur dans un élément du DOM.                            |
| [`GTReplayer`](#gt-replayer)              | Wrapper React autour de `createGTReplayer`.                         |
| [`GTReplayerProps`](#replayer-props)      | Props acceptées par `GTReplayer`.                                   |
| [`GTReplayerBundle`](#replayer-bundle)    | Flux d’événements et données de paramètres régionaux facultatives.  |
| [`GTReplayerOptions`](#replayer-options)  | Paramètre régional initial et options de changement et de débogage. |
| [`GTReplayerHandle`](#replayer-handle)    | Détruit un lecteur monté.                                           |

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

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

La fonction monte un lecteur autonome et lance la lecture. Il inclut une zone d’affichage avec bandes noires, un curseur cliquable, une barre de défilement, un sélecteur de thème clair ou sombre, un contrôle plein écran et un sélecteur de paramètre régional lorsque le bundle le permet.

Le conteneur doit être dimensionné par son parent. Appelez `destroy()` avant de supprimer ou de réutiliser le conteneur.

Un bundle comportant moins de deux événements affiche une erreur dans le lecteur et renvoie un handle dont la méthode `destroy()` ne fait rien, sans risque.

## `GTReplayer` [#gt-replayer]

`GTReplayer` monte `createGTReplayer` dans un conteneur géré par React et le détruit lors du démontage. Il recrée le lecteur lorsque `bundle`, `initialLocale`, `switchLocalesAllowed` ou `debug` change.

## `GTReplayerProps` [#replayer-props]

| Prop                   | Description                                                                                         | Type               | Facultatif | Par défaut          |
| ---------------------- | --------------------------------------------------------------------------------------------------- | ------------------ | ---------- | ------------------- |
| `bundle`               | Enregistrement à lire.                                                                              | `GTReplayerBundle` | Non        | —                   |
| `initialLocale`        | Paramètre régional affiché lors du montage.                                                         | `string`           | Oui        | `bundle.locales[0]` |
| `switchLocalesAllowed` | Affiche les contrôles de paramètres régionaux et permet de changer de paramètre régional en direct. | `boolean`          | Oui        | `true`              |
| `debug`                | Accepte les fichiers JSON d’enregistrement déposés.                                                 | `boolean`          | Oui        | `false`             |
| `className`            | Classe appliquée au conteneur hôte.                                                                 | `string`           | Oui        | —                   |
| `style`                | Style en ligne appliqué au conteneur hôte.                                                          | `CSSProperties`    | Oui        | —                   |

## `GTReplayerBundle` [#replayer-bundle]

| Champ     | Description                                                                    | Type                | Facultatif | Par défaut |
| --------- | ------------------------------------------------------------------------------ | ------------------- | ---------- | ---------- |
| `events`  | Flux d’événements rrweb.                                                       | `eventWithTime[]`   | Non        | —          |
| `locales` | Paramètres régionaux disponibles, le paramètre régional source en premier.     | `readonly string[]` | Oui        | —          |
| `overlay` | Mappage des paramètres régionaux vers le texte des identifiants de nœud rrweb. | `LocaleTextOverlay` | Oui        | —          |

Un bundle brut contenant uniquement des événements est rejoué dans le paramètre régional source enregistré. Les événements émis par `gt-rrweb` peuvent également contenir des métadonnées de paramètre régional et de superposition dans le flux.

## `GTReplayerOptions` [#replayer-options]

| Option                 | Description                                                                      | Type      | Facultatif | Par défaut                |
| ---------------------- | -------------------------------------------------------------------------------- | --------- | ---------- | ------------------------- |
| `initialLocale`        | Paramètre régional affiché au montage ; ignoré s’il est absent du bundle.        | `string`  | Oui        | Paramètre régional source |
| `switchLocalesAllowed` | Active le sélecteur de paramètre régional du lecteur.                            | `boolean` | Oui        | `true`                    |
| `debug`                | Active le remplacement du bundle par glisser-déposer pour une inspection locale. | `boolean` | Oui        | `false`                   |

La modification du paramètre régional remplace le texte sur place sans recréer la lecture. Les fichiers déposés non valides génèrent une notification dans le lecteur.

## `GTReplayerHandle` [#replayer-handle]

`GTReplayerHandle` expose une méthode, `destroy(): void`, qui supprime le lecteur et ses écouteurs du conteneur.

## Sitemap

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