La_Syl Studio
Guide des widgets

Accueil des chatteurs

Salue chaque spectateur avec sa photo quand il arrive dans le chat — à son premier message du stream, ou dès qu'il le rejoint — avec des accueils personnalisés, un son et un message dans le chat.

Dit bonjour à chaque spectateur qui arrive. La première fois que quelqu'un écrit dans votre chat, une bulle apparaît avec sa photo de profil et votre message d'accueil — PixelPanda is in the chat!. Avec Accueillir les lurkers activé, les spectateurs qui arrivent sans écrire sont salués aussi. Chaque accueil peut aussi jouer un son et poster un message dans le chat, et des accueils personnalisés saluent autrement les nouveaux venus, les membres de vos groupes et ceux qui reviennent.

Plateformes : Twitch, YouTube, Kick

Pack d'actions : Stream UI - Get Profile Pic pour les photos Twitch, Stream UI - Sounds pour les fichiers son, Stream UI - Backend pour les accueils de groupes et « De retour après » et pour la pause → Pause et reprise. Sans le pack, les accueils s'affichent quand même, sans les photos Twitch. Voir Qui a besoin de quoi.

Fonctionnement

  • Une fois par spectateur. Un spectateur est salué la première fois qu'il écrit (l'événement First Words de Streamer.Bot), puis plus jamais jusqu'au rechargement de la source navigateur.
  • Les lurkers, si vous voulez. Streamer.Bot envoie toutes les quelques minutes la liste des spectateurs présents dans le chat. Avec Accueillir les lurkers activé, chaque nouveau venu de cette liste est salué. La première liste reçue après le chargement de la source navigateur est seulement notée, sans saluer personne : un rechargement ne salue donc jamais tout votre chat une deuxième fois.
  • Les accueils s'empilent. Chacun reste le temps choisi, puis disparaît. Quand il en arrive plus que Accueils à l’écran ne le permet, le plus ancien part en premier.
  • Le message part dans le chat du spectateur — un spectateur Twitch est accueilli sur Twitch, un spectateur Kick sur Kick.
  • Sons et messages viennent de l'overlay qui lance les actions, même quand un autre overlay affiche les accueils. Une URL d'un seul widget ne fait que les afficher. → Quel overlay lance les actions
  • La dernière visite est enregistrée. L'overlay qui lance les actions enregistre la visite de chaque spectateur salué dans sa variable utilisateur persistante lastSeen (une date et une heure), 10 secondes après l'accueil. C'est elle que lisent les accueils De retour après.
Les utilisateurs ignorés — vos bots, Nightbot… — et les comptes diffuseur et bot connectés dans Streamer.Bot ne sont jamais salués. Les utilisateurs ignorés se règlent une fois pour tous les widgets, dans l'onglet Utilisateurs ignorés de la page Réglages.

La page

La page du widget fonctionne comme une petite application :

  • Réglages, Style et Commandes, les onglets au-dessus de l'éditeur, changent ce qu'il affiche.
  • La colonne de gauche liste les sections de l'onglet Réglages : Affichage, Accueils par défaut, Tout premier message, Groupes d’utilisateurs et De retour après, les trois dernières chacune avec son interrupteur sur sa ligne. Cliquez sur l'une d'elles pour la modifier dans la zone principale. Dans l'onglet Commandes, Pause et Reprendre et leurs déclencheurs → Pause et reprise.
  • Groupes d’utilisateurs et De retour après ouvrent leur liste à côté — Liste des groupes, Liste des paliers — où vous ajoutez, réordonnez, dupliquez ou supprimez des lignes ; celle choisie se modifie dans la zone principale.
  • Aperçu du widget, le panneau contre le bord droit de la fenêtre : l'aperçu, les boutons de test et l'URL propre au widget. La flèche en haut le replie en un mince rail. Faites glisser son bord gauche pour l'élargir, jusqu'à la moitié de la fenêtre ; il garde sa largeur. Widget montre le widget dans sa position, découpé dans le canevas tel que votre source navigateur le dessine ; Sur le canevas, tout le canevas.

Mise en place

Activez-le

Sur la page Widgets, activez Accueil des chatteurs. Il est dans l'onglet Chat, et activé par défaut.

Écrivez votre message d'accueil

Dans Accueils par défaut, modifiez la ligne Modèle du message d’accueil. {user} est le pseudo du spectateur, {platform} la plateforme sur laquelle il est arrivé. Ajoutez un son ou un message dans le chat si vous voulez.

Choisissez qui est salué

Laissez Accueillir les lurkers désactivé pour ne saluer que les personnes qui écrivent, ou activez-le pour saluer tous ceux qui arrivent. Tout premier message, Groupes d’utilisateurs et De retour après saluent à leur façon les nouveaux venus, les groupes et ceux qui reviennent.

Testez, puis mettez à jour votre source navigateur

Utilisez les boutons de test du panneau Aperçu du widget, puis recopiez l'URL de l'overlay dans votre source navigateur → Disposition et source navigateur.

Réglages

Affichage

En deux parties : Réglages de l’overlay (les quatre premiers) et Infos du chatteur (la photo et l'icône).

RéglageDéfautDétail
Durée à l’écran8 sDurée d'affichage de chaque accueil, de 3 à 60 s.
Accueils à l’écran5Nombre d'accueils affichés en même temps, de 1 à 15. Un de plus pousse le plus ancien dehors.
Le plus récent en hautdésactivéDésactivé : les nouveaux accueils arrivent en bas. Activé : en haut.
Accueillir les lurkersdésactivéSalue aussi les spectateurs qui rejoignent le chat sans écrire.
Afficher la photo de profilactivéLa photo du spectateur à côté de la carte.
Afficher l’icône de plateformeactivéLe logo Twitch, YouTube ou Kick dans la carte.

Accueils par défaut

Chaque accueil — celui par défaut comme chaque accueil personnalisé — est le même bloc, en trois parties : Message à l’écran, Son et Message dans le chat.

RéglageDéfautDétail
Modèle du message d’accueil{user} is in the chat!La ligne dans la bulle. Ses variables sont indiquées dessous.
Jouer un sonactivéDésactivé : cet accueil ne joue rien.
SondésactivéLe bouton son ouvre la fenêtre Son d’accueil : un fichier de votre PC, un fichier au hasard d'un dossier, ou un lien. → Sons
Envoyer un message dans le chatdésactivéPoste un message dans le chat du spectateur.
Envoyer avec le botactivéPoste avec votre compte bot plutôt que celui du diffuseur.
Reprendre le message à l’écrandésactivéPoste le texte de l'accueil au lieu d'un message à part.
Message dans le chatWelcome {user}!Le message posté.

Les textes peuvent utiliser :

VariableExempleDétail
{user}PixelPandaSon pseudo affiché.
{platform}TwitchLa plateforme sur laquelle il est arrivé.
{days}12Les jours depuis sa dernière visite (vide si inconnue).

Accueils personnalisés

Trois types, chacun une ligne avec son propre interrupteur (tous désactivés par défaut) ; un spectateur reçoit le premier activé qui correspond, dans cet ordre, sinon l'accueil par défaut :

  1. Tout premier message — son tout premier message sur votre chaîne (le First Words de Streamer.Bot le signale). Par défaut : Welcome {user}, first time here!, message Welcome to the channel {user}!.
  2. Groupes d’utilisateurs — la première ligne de sa Liste des groupes, de haut en bas, dont il est membre du Groupe Streamer.bot (le nom de la ligne, tapé dans la zone principale). Ajouter un groupe ajoute une ligne. Le groupe est vérifié par identifiant ou login, sur toutes les plateformes.
  3. De retour après — la ligne de sa Liste des paliers au plus grand Jours d’absence qu'il a atteint depuis son dernier accueil. Ajouter un palier ajoute une ligne (14 jours au départ). Par défaut : 7 jours, Welcome back {user}! ; 30 jours, {user} is back after {days} days! avec le message Long time no see {user}!. Un spectateur sans visite enregistrée reçoit l'accueil par défaut.

Chaque accueil personnalisé a le même bloc que celui par défaut, plus :

RéglageDéfautDétail
Reprendre le son par défautactivéAffiché tant que Jouer un son est activé. Joue le son de l'accueil par défaut (aucun si le Jouer un son de l'accueil par défaut est désactivé). Le bouton son apparaît quand il est désactivé.

Un Modèle du message d’accueil ou un message vide reprend celui de l'accueil par défaut (les champs vides affichent Message d’accueil par défaut et Message dans le chat par défaut). Chaque accueil personnalisé a son propre interrupteur Envoyer un message dans le chat.

L'aperçu n'interroge pas Streamer.Bot : les accueils de groupes et De retour après ne se voient qu'en stream. Tout premier message a son propre bouton de test.

Style

Chaque élément suit le style de l'overlay champ par champ : un champ modifié dans l'onglet Style devient celui du widget, avec une flèche de réinitialisation à côté. Chaque plateforme peut aussi avoir son propre style : choisissez-la dans Style pour, à côté de l'interrupteur Styles globaux / Personnalisé. Voir Apparence.

ÉlémentDétail
ConteneurLes accueils les uns sous les autres, alignés sur la position du widget, Full width, 8 px entre les cartes. Alignés à droite, l'image d'un accueil passe à droite de sa carte.
FondLa carte derrière chaque accueil : son icône de plateforme et son texte sur une ligne. En Pleine largeur, un accueil prend toute la ligne. Suit le style Fond des widgets de l'overlay.
ImageLa photo de profil du spectateur. Les photos Twitch demandent l'action Get Profile Pic. Listée tant que Afficher la photo de profil est activé.
Icône de plateformeLe logo Twitch, YouTube ou Kick, dans la carte. Suit le style Icônes des plateformes de l'overlay. Listée tant que Afficher l’icône de plateforme est activé.
TexteLe message d'accueil. Les pseudos longs passent à la ligne.
Transition d’apparitionL'apparition et la disparition des accueils.

Position par défaut

Position En bas à droite, aussi large que la position, taille 100 %. Tout cela se change dans l'onglet Disposition du Créateur d’overlay.

Pause et reprise

En pause, les accueils à l'écran partent aussitôt et personne n'est salué : ni bulle, ni son, ni message. Les spectateurs arrivés entre-temps comptent comme salués : la reprise ne salue donc jamais tout votre chat d'un coup.

Dans l'onglet Commandes de la page du widget :

  • Commandes, la colonne de gauche, liste Pause et Reprendre, chacune avec les noms de ses déclencheurs. Choisissez-en une pour voir ses déclencheurs dans Liste des déclencheurs, à côté.
  • Liste des déclencheurs : les déclencheurs Streamer.Bot qui la lancent. Ajouter un déclencheur en ajoute un, conditions comprises → Déclencheurs et conditions.
    • Pause — par défaut : Stream Offline de Twitch.
    • Reprendre — par défaut : Stream Online de Twitch.
  • La zone principale indique Accueil des chatteurs : En cours ou En pause, avec les boutons Reprendre et Pause, aussi dans la fenêtre de contrôles.

L'état est gardé dans Streamer.Bot, dans la variable globale persistante streamUi.off.greeting (1 : en pause ; 0 ou absente : actif) : la pause dure jusqu'à la reprise, même si la source navigateur se recharge, et tous les overlays la suivent aussitôt. Vos propres actions peuvent aussi mettre en pause ou relancer le widget, avec une sous-action Global (Set) sur cette variable. Les boutons et les déclencheurs demandent l'action Stream UI - Backend.

Événements Streamer.Bot écoutés

ÉvénementCe qu'il déclenche
Vos déclencheurs Pause / ReprendreMet en pause ou relance le widget
Misc.GlobalVariableUpdated, Misc.GlobalVariableCreatedLe widget mis en pause ou relancé ailleurs (la page, la fenêtre de contrôles, vos actions)
Twitch.FirstWordLe premier message Twitch d'un spectateur — le salue
YouTube.FirstWordsLe premier message YouTube d'un spectateur — le salue
Kick.FirstWordsLe premier message Kick d'un spectateur — le salue
Twitch.PresentViewers, YouTube.PresentViewers, Kick.PresentViewersLes spectateurs présents dans le chat — salue les nouveaux. Seulement avec Accueillir les lurkers activé

Seules les plateformes activées sur la page Réglages sont écoutées.

Le panneau Aperçu du widget a un bouton de test par plateforme — Twitch first words, YouTube first words, Kick first words — plus Twitch lurker, YouTube lurker et Kick lurker quand Accueillir les lurkers est activé, et Tout premier message quand cet accueil est activé. Dès qu'une plateforme en a plusieurs, chaque plateforme a son onglet. Ils ne jouent que dans l'aperçu.