chatbotData

Le paramètre chatbotData permet de régler la taille des animations vidéo du chatbot

Nom	Requis	Type	Valeur par défaut	Description
size	Non	number | string | undefined	-	Définit la hauteur des animations. Peut être une valeur en chaîne de caractères représentant un pourcentage (ex: 80%), un rapport à la hauteur de la fenêtre (ex: 50vh), ou un nombre représentant une hauteur fixe en pixels (ex: 1500)
height	Non	number | string | undefined	-	Décalage des animations par rapport au bord supérieur du conteneur principal (équivalent a un padding-top). Peut prendre les même types de valeur que size
fullWidthInDesktopMode	Non	boolean	-	true pour que le conteneur de l'agent prenne toute la largeur disponible (agent centré)
cameraPreset	Non	string parmi les preset	'default'	(depuis v4.0.3, agent 3D uniquement) Détermine la position de la caméra ce qui influence le rendu du personnage
calibration	Non	CalibrationData	-	(depuis v4.0.3, agent 3D uniquement) Paramètre de modification de la hauteur du regard du personnage lorsqu'il est en phase d'écoute ou de parole

preset

  "default"         // personnage coupé aux genoux
  "head"            // gros plan sur la tête
  "neck"            // tête et cou
  "shoulders"       // tête, cou et épaules
  "chest"           // buste du personnage
  "belly"           // coupé au bas du ventre (s'approche d'un plan américain)
  "knees"           // (comme default)
  "feet"            // personnage en plein-pied

calibrationdata

Les données de calibrage de la hauteur du regard permettent de modifier les coordonnées dans l'espace du point vers lequel le regard de l'agent sera fixé lorsqu'il passe en phase d'écoute active (l'utilisateur effectue une reconnaissance vocale) ou de parole. Il existe deux modes disponibles, static et dynamique, qui s'excluent mutuellement.
Le mode statique permet de configurer une hauteur vers laquelle tendra le regard de l'agent, cette hauteur restant figée une fois renseignée.
Le mode Dynamique n'a pas encore été testé intensivement en situation réelle et les paramètres nécessaires à son utilisation doivent être renseignés avec précision pour un fonctionnement correct. Il permet, grâce à la reconnaissance faciale liée à une webcam, de faire suivre la hauteur du regard de l'agent en fonction de la taille de la personne qui se situe face à lui. Les données de calibrage sont stockées dans le local storage une fois renseignées, ou bien peuvent être renseignées manuellement dans la configuration. Si aucune donnée n'est présente, une phase de calibrage apparaîtra au lancement de l'application.

Nom	Requis	Type	Valeur par défaut	Description
static	Non	staticData	-	Mode statique
dynamic	Non	dynamicData	-	Mode dynamique

static

Nom	Requis	Type	Valeur par défaut	Description
enabled	Oui	boolean	false	true pour activer le mode statique
loadStaticTargetFromLocalStorage	Non	boolean	false	true pour tenter de récupérer les données stockées dans le local storage à l'initialisation pour éviter la phase de calibrage
staticTarget	Non	{ x: number, y: number, z: number }	-	Coordonnées d'un point dans l'espace qui sera la cible du regard du personnage. Attention l'espace généré par Three.js utilise des unités métriques mais chaque espace est différente en fonction du personnage 3D utilisé. Il est recommandé de n'utiliser cette option que lorsque des coordonnées ont déjà été récupérées lors d'un calibrage précédent sur le même personnage

dynamic

Nom	Requis	Type	Valeur par défaut	Description
enabled	Oui	boolean	false	true pour activer le mode dynamique
loadStaticTargetFromLocalStorage	Non	boolean	false	true pour tenter de récupérer les données stockées dans le local storage à l'initialisation pour éviter la phase de calibrage
dynamicData	Non	dynamicData	-	Données pour l'utilisation du système dynamique. Il est recommandé de n'utiliser cette option que lorsque des données ont déjà été récupérées lors d'un calibrage précédent sur le même personnage

dynamicdata

Nom	Requis	Type	Valeur par défaut	Description
webcamHeight	Oui	number	-	Hauteur de la webcam (en cm)
ratioPixelToCentimeter	Oui	number	-	Correspondance entre un pixel du rendu de la webcam et une taille en cm
deltaAgentHeightAgentWorldHeightInCentimeters	Oui	number	-	Différence entre la hauteur du sommet du crâne de l'agent sur la borne et celle dans la scène 3D générée par Three.js (en cm)
cameraRotationInDegrees	Oui	number	-	Rotation de la caméra (en degrés). Parfois les webcams sont placés de telle sorte qu'il faut effectuer une rotation de 90° pour récupérer une image correctement orientée
distanceFromAgentToCameraInCentimeters	Oui	number	-	Distance entre la webcam et la position à laquelle l'utilisateur est situé lorsqu'il utilise une borne (en cm)