La_Syl Studio
Guide des widgets

Premier du chat

Met à l'honneur la première personne à écrire dans le chat de chaque stream, sur chaque plateforme, avec sa photo et le nombre de fois où elle a été première.

Récompense la première personne qui écrit dans votre chat. Chaque plateforme a son propre premier : le premier sur Twitch, le premier sur YouTube et le premier sur Kick ont chacun leur place, avec leur photo de profil, leur pseudo et le nombre de fois où ils ont été premiers.

Plateformes : Twitch, YouTube, Kick

Pack d'actions : nécessaire — Backend garde les places, les compteurs et l'état affiché ou masqué du widget, et envoie l'événement personnalisé ; Get Profile Pic trouve les photos Twitch. Voir Qui a besoin de quoi.

Fonctionnement

  • Un premier par plateforme. L'événement First Words de Streamer.Bot se déclenche quand quelqu'un écrit son premier message. Le premier de ces messages sur une plateforme prend la place de cette plateforme ; les suivants sont ignorés jusqu'à ce que la place soit libérée.
  • La place reste prise jusqu'à une remise à zéro. Par défaut, chaque plateforme libère sa place quand votre stream démarre dessus (voir Commandes automatiques). Les places sont enregistrées dans Streamer.Bot : recharger la source navigateur ne les perd pas.
  • Chaque premier est compté. Chaque nouveau premier ajoute 1 à la variable utilisateur firstInChat du spectateur dans Streamer.Bot. Elle est conservée définitivement, et vos propres actions peuvent la lire — une commande !first, par exemple.
  • Les places suivent l'ordre d'arrivée. La première personne arrivée est affichée en premier, puis la suivante, puis la suivante — en ligne, en colonne ou sur un podium.
  • Seul l'overlay qui lance les actions prend les places, compte et envoie l'événement personnalisé. Les autres overlays affichent ce qu'il a enregistré, et un nouveau premier y apparaît aussi. Une URL d'un seul widget ne prend jamais de place. → Quel overlay lance les actions
Les utilisateurs ignorés — vos bots, Nightbot… — et vos propres comptes diffuseur et bot ne sont jamais premiers. 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.
  • L'onglet Réglages réunit tous les réglages dans la zone principale, sous quatre titres. Dans l'onglet Commandes, une colonne à gauche liste les commandes — Afficher, Masquer et Vider —, la liste de déclencheurs de celle choisie à côté, et la zone principale contient les commandes manuelles. L'événement personnalisé n'est expliqué que sur cette page.
  • 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.

Réglages

Affichage

RéglageDéfautDétail
Mode podiumdésactivéPlace les premiers sur un podium : le 1er au milieu sur la plus haute marche, le 2e à gauche, le 3e à droite. Affichage seulement — les places du podium ne sont pas comptées. Sans le podium, les premiers sont côte à côte ou les uns sous les autres : c'est la Direction du Conteneur (son Contenu), dans l'onglet Style.
Rester à l’écranactivé (fixe)Activé : les premiers restent à l'écran jusqu'à ce qu'on les masque. Désactivé : chaque nouveau premier s'affiche pendant la durée choisie, puis disparaît.
Durée à l’écran15 sDurée d'affichage d'un premier, de 3 à 120 s. Seulement quand Rester à l’écran est désactivé.

Avec Rester à l’écran désactivé et le podium activé, un nouveau premier fait réapparaître tout le podium, avec les premiers précédents à leur place.

Infos du viewer

RéglageDéfautDétail
Afficher la photo de profilactivéLa photo du premier. Désactivé, le pseudo reste à sa place.
Afficher le pseudoactivéSon pseudo affiché, sur le bas de la photo.

Infos de la plateforme

RéglageDéfautDétail
Afficher l’icône de plateformeactivéLe logo Twitch, YouTube ou Kick, à côté de la ligne de texte.
Afficher le libelléactivéAffiche la ligne sous le pseudo, à côté de l'icône de plateforme.
Texte du libellé{platform} firstCette ligne. Seulement quand Afficher le libellé est activé.

Score

RéglageDéfautDétail
Afficher le scoreactivéAffiche le nombre de fois où la personne a été première.
Texte du scoreTimes first: {count}Cette ligne. Seulement quand Afficher le score est activé.

Les deux textes peuvent utiliser {platform} (la plateforme sur laquelle la personne a été première), {user} (son pseudo affiché) et {count} (le nombre de fois où elle a été première sur cette plateforme, celle-ci comprise).

Un encadré sous ces champs donne la variable Streamer.Bot du score, firstInChat, avec un bouton Copier, pour l'afficher aussi sur les cartes de viewers — voir Avec les cartes de viewers.

Commandes

Ce qui affiche, masque et libère le widget se trouve dans l'onglet Commandes de sa page, chacun sur une ligne de sa colonne.

Commandes automatiques

Trois listes de déclencheurs Streamer.Bot, chacune nommée comme son bouton et choisie comme partout ailleurs dans Stream UI — voir Déclencheurs.

ListeDéfautDétail
AfficheraucunAffiche le widget dans chaque overlay — une commande !first, une récompense de points de chaîne… Avec Rester à l’écran désactivé, tous les premiers actuels s'affichent pendant la durée choisie.
MasqueraucunMasque le widget dans chaque overlay jusqu'à ce qu'il soit réaffiché — un changement de scène, par exemple. Le masquage survit au rechargement de la source navigateur.
Viderle début du stream de chaque plateformeLibère les places de premier, pour que les prochains premiers messages les prennent.

Les déclencheurs par défaut de Vider :

Déclencheur par défautLibère
Twitch › Stream Onlinela place Twitch
YouTube › Broadcast Startedla place YouTube
Kick › Stream Onlinela place Kick

Le déclencheur d'une plateforme libère la place de cette plateforme. Tout autre déclencheur — une commande, un événement OBS… — les libère toutes. Ajoutez, modifiez ou retirez des déclencheurs avec Ajouter un déclencheur.

Manual controls

Des boutons pour agir à la main sur votre source navigateur, immédiatement — aussi dans la fenêtre de contrôles :

BoutonEffet
Afficher / MasquerUn seul bouton, Masquer quand il est affiché et Afficher quand il est masqué : affiche ou masque le widget dans chaque overlay et dans l'aperçu, avec sa Transition d’apparition, lu en direct : Premier du chat : Affiché ou Masqué.
Vider (un par plateforme)Libère la place de cette plateforme.
Tout viderLibère toutes les places. Seulement avec plus d'une plateforme activée.

Ils demandent que Streamer.Bot soit connecté, avec l'action Backend. Un bouton Vider est grisé quand sa place est déjà libre.

Masqué, le widget prend toujours les places et les compte ; avec Rester à l’écran désactivé, aucun premier n'apparaît avant qu'il soit réaffiché. Une fois sorti, sa place revient aux autres widgets de sa position.

L'état affiché ou masqué est gardé dans Streamer.Bot sous streamUi.off.chatfirst.display (1 masqué) : vos propres actions peuvent afficher ou masquer le widget en changeant cette variable globale persistante.

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
ConteneurLa liste : les premiers côte à côte par défaut (sa Direction ; le podium la règle), alignée sur la position du widget, Full width, 12 px entre les cartes.
FondLe cadre derrière chaque premier : son image et ses textes centrés les uns sous les autres. Suit le style Fond des widgets de l'overlay.
ImageLa photo de profil du premier. 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, à côté de la ligne de texte. Suit le style Icônes des plateformes de l'overlay. Listée tant que Afficher l’icône de plateforme est activé.
PseudoSur le bas de la photo. Suit le style Titres de l'overlay. Les pseudos trop longs sont coupés par « … ». Listé tant que Afficher le pseudo est activé.
LibelléLa ligne sous le pseudo. Listé tant que Afficher le libellé est activé.
ScoreLe nombre de fois où la personne a été première. Listé tant que Afficher le score est activé.
Marche du podiumPodium seulement. La marche sous chaque premier ; celles du 2e et du 3e sont plus basses. Son réglage Hauteur en plus pour la 1re place s'ajoute au contenu de la marche : la 1re place est donc toujours la plus haute (40 px par défaut ; en px, en % du canevas, en em, vw ou vh).
PlacePodium seulement. « 1st », « 2nd », « 3rd » sur les marches.
Transition d’apparitionL'apparition et la disparition des premiers.

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.

Événements Streamer.Bot écoutés

ÉvénementCe qu'il déclenche
Twitch.FirstWordUn premier message sur Twitch — prend la place Twitch si elle est libre
YouTube.FirstWordsUn premier message sur YouTube — prend la place YouTube si elle est libre
Kick.FirstWordsUn premier message sur Kick — prend la place Kick si elle est libre
Misc.GlobalVariableUpdated, Misc.GlobalVariableCreatedLe widget affiché ou masqué ailleurs

S'y ajoutent les déclencheurs choisis dans Afficher, Masquer et Vider.

Le panneau Aperçu du widget a un bouton de test par plateforme — Twitch first words, YouTube first words, Kick first words. Ils ne jouent que dans l'aperçu : rien n'est enregistré et aucun compteur ne change.

Événement personnalisé

Le widget envoie un événement personnalisé à Streamer.Bot à chaque nouveau premier du chat. Servez-vous-en comme déclencheur d'action pour créer vos propres interactions : remercier la personne dans le chat, jouer un son, lui offrir des points de chaîne…

Dans Streamer.Bot, le déclencheur est Custom › Stream UI › New First in Chat. Il est ajouté par l'action Stream UI - Backend : après avoir importé de nouveau les actions, redémarrez Streamer.Bot pour que le déclencheur apparaisse.

VariableValeurDétail
user%user%Son pseudo affiché.
userLogin%userLogin%Son identifiant de connexion.
userId%userId%Son identifiant sur la plateforme.
platform%platform%twitch, youtube ou kick.
firstInChatCount%firstInChatCount%Le nombre de fois où la personne a été première, celle-ci comprise.

Les photos de profil des spectateurs sont enregistrées sous profilePic dans leurs variables utilisateur. Récupérez-les là si vous en avez besoin.

Avec les cartes de viewers

Le compteur firstInChat vit dans Streamer.Bot : les cartes de viewers peuvent donc l'afficher et débloquer des succès avec.

  • Sur les cartes : ajoutez un score à la Liste des scores d'une plateforme, activez Gérer dans Streamer.bot et collez firstInChat dans Nom de la variable. La carte affiche le compteur tel quel.
  • Pour les succès et les badges : choisissez le déclencheur User Global Variable Updated, tapez firstInChat dans son champ Variable utilisateur, puis ajoutez une condition sur global.newValue — par exemple ≥ 10 pour un badge après dix premières places.

Les cartes de viewers lisent le spectateur et la plateforme dans la variable elle-même : les succès de chaque plateforme suivent le compteur de cette plateforme.