Aller au contenu
Livstick Développeurs

Prérequis

Un message existant et le conteneur auquel il appartient. Conteneurs et messages.

Installer le package

Le Viewer est distribué dans son propre package npm, distinct de celui du Recorder.

npm install
npm install @livstick/widget-viewer

Monter le Viewer

Affichez LivstickViewer avec l’urid du conteneur du message et votre clé d’API publique.

TSX page du message
import { LivstickViewer } from "@livstick/widget-viewer";

<LivstickViewer uid="code" domain="example.com" />

Vérifier que le message est libéré

Le Viewer affiche tout ce qu’on lui transmet — il ne vérifie pas l’état du message à votre place. Assurez-vous que state vaut released sur le conteneur avant de monter le Viewer, pour qu’un destinataire ne tombe jamais sur un lecteur vide ou en attente.

GET /containers/{crid}
curl https://client-api.v5.livstick.com/api/v3/containers/{crid} \
  -H "Authorization: Bearer {ACCESS_TOKEN}"

Gérer onLoaded et onError

onLoaded se déclenche une fois le message affiché ; onError se déclenche quand l’affichage a échoué. Utilisez-les pour piloter un état de chargement ou une solution de repli dans la page qui entoure le Viewer.

TSX page du message
<LivstickViewer
  uid="code"
  domain="example.com"
  onLoaded={() => setLoaded(true)}
  onError={(error) => setFailed(error)}
/>

Étapes suivantes

La liste complète des props du Viewer est volontairement courte : uid, lang, apiKey, domain, apiUrl, className, style, styleOverrides, onLoaded, onError. Il n’y a ni Custom Element, ni editKey, ni événements composés — cette surface est propre au Recorder.