Le module v1
Ce qu’est le widget de première génération, ce qu’il prend encore en charge, et en quoi il diffère de Saphere Scan v2.
Une nouvelle intégration devrait utiliser Saphere Scan v2. Cette rubrique existe pour les produits qui font déjà tourner le module v1 en production, et le documente tel qu’il est.
Le module v1 — rjcaducy en interne — est le widget intégrable d’origine. C’est une application React, empaquetée en un fichier unique et servie par le CDN, qui rend tout le parcours de mesure dans un conteneur que vous fournissez.
Il reste servi et il reste fonctionnel. Ce n’est plus là que le travail se fait.
Ce qu’il fait
La même chose que la v2, par un autre chemin : il explique la mesure, recueille le consentement, guide l’utilisateur dans le cadre, capture pendant trente secondes, et affiche un résultat. Il rapporte l’avancement à votre page par une fonction de rappel onEvent.
Il se personnalise par un vaste objet d’options — une palette de onze couleurs, des interrupteurs par écran, et une réécriture complète de chaque chaîne dans dix langues.
En quoi il diffère de la v2
Les deux widgets ne partagent pas d’API. Migrer, c’est réécrire l’intégration, non renommer quelques champs.
v1 (Handler) | v2 (SaphereScan) | |
|---|---|---|
| Point d’entrée | window.Handler, ou l’événement handler-ready | import SaphereScan from … |
| Montage | Handler.load(container, options) | SaphereScan.create(root, options) puis await bootstrap() |
| Habilitation | Votre clé d’API, ou un identifiant de mesure que vous obtenez vous-même | Un jeton d’accès court et cadré |
| Événements | 8 types d’événements | 40, nommés domaine:événement |
| Refuser une transition | onEvent rendant false | Une API hooks distincte, avec un délai de garde |
| Couleurs | 11 emplacements numérotés (color01…color11) | Des options par écran et par variable |
| Isolation | Shadow DOM facultatif (useShadow) | Toujours un shadow root |
Deux différences comptent plus que les autres.
Le modèle d’habilitation a changé. En v1, ou bien vous placiez une clé d’API là où le widget pouvait l’atteindre, ou bien vous créiez la mesure vous-même et remettiez son identifiant au widget. En v2, le widget demande à votre serveur un jeton cadré sur une seule chose, qui expire sous 48 heures, et qu’on peut rendre à usage unique. C’est la principale raison de migrer.
Le canal d’événements ne bloque pas. La v1 attendait votre gestionnaire onEvent et laissait un false rendu annuler une transition d’écran — ce qui signifiait qu’un gestionnaire lent pouvait bloquer une mesure. La v2 n’attend jamais onEvent ; le pouvoir de refuser a migré vers les hooks, où il est borné par un délai.
Ce que contient cette rubrique
Les URL du CDN, les deux variantes de build, et l'API Handler.
L'objet d'options complet, la palette de couleurs, les écrans, et l'union des événements.
Intégration WebViewReact Native et Ionic : le pont, les permissions et les manifestes.
Support
Le module v1 reçoit des correctifs pour les défauts qui cassent les intégrations existantes. Il ne reçoit pas de nouvelles capacités. Tout ce dont vous avez besoin et qu’il ne fait pas déjà est une raison de regarder la v2.