Déclencheurs et conditions
Les Alertes, les Objectifs et subathon et les Compteurs de stream n'utilisent pas une liste fixe d'événements. Chacun de leurs tableaux contient des lignes, et chaque ligne est un déclencheur Streamer.Bot que vous avez choisi — avec, si vous voulez, une condition. Dans les Alertes et les Objectifs et subathon, une ligne peut aussi poster un message de chat et jouer un son, et dans les Alertes afficher sa propre image et poster un message Discord. Les catégories et les déclencheurs de vidage du Générique de fin, ainsi que les déclencheurs de remise à zéro, d'affichage et de masquage du Premier du chat, des Compteurs de stream et du Compteur de spectateurs, se choisissent de la même façon. Les déclencheurs qui affichent, masquent, remettent à zéro ou vident un widget sont dans l'onglet Commandes de sa page.
Dans les Alertes et le Temps ajouté du subathon, les lignes forment une liste à part (Liste des alertes, Liste des déclencheurs) : choisissez-y une ligne pour la modifier dans la zone principale — Changer de déclencheur rouvre le sélecteur, puis son titre et son texte (ou ses secondes), son image, son message de chat, son message Discord et son son en champs. Ailleurs, elles forment un tableau.
Ajouter un déclencheur
Chaque liste ou tableau a un bouton Ajouter un déclencheur. Il ouvre Configurer le déclencheur :
- Déclencheur reprend le menu de déclencheurs de Streamer.Bot lui-même, avec les mêmes sections et les mêmes noms que dans Streamer.Bot — par exemple Twitch › Subscriptions › Gift Subscription. Seule la plateforme ou l'intégration du tableau est listée.
- Seuls les déclencheurs que propose votre Streamer.Bot connecté apparaissent : il faut donc être connecté pour en choisir un.
- Enregistrer le déclencheur ajoute la ligne. Le crayon d'une ligne rouvre la fenêtre ; la croix la supprime.
Une ligne dont votre Streamer.Bot ne propose plus le déclencheur affiche Déclencheur introuvable : modifiez-le pour en choisir un autre.
Conditions
Activez Activer quand une condition précise est remplie pour qu'une ligne ne réagisse qu'à certains événements de son déclencheur — un resub de 12 mois ou plus, un cheer entre 100 et 499 bits, une récompense d'un nom donné.
| Champ | Détail |
|---|---|
| Nom de la variable | La variable de l'événement à regarder, tapée avec son nom complet dans le data de l'événement, par exemple months, user.name ou scene.sceneName. Les noms sont dans la documentation des événements WebSocket de Streamer.Bot, ou dans l'Inspecteur d’événements, le bouton à côté du champ (son bouton de copie donne le nom prêt à coller). |
| Type de variable | Texte, Nombre ou Booléen. |
| Correspondance | Une seule valeur, Un intervalle de valeurs, Une liste de valeurs ou Chaque multiple d’un nombre. |
| Opération | Pour une seule valeur : = (Equals), ≠ (Différent), Commence par (Texte seulement, majuscules et minuscules confondues : un fichier dans un dossier), > (Supérieur), < (Inférieur), ≥ (Supérieur ou égal), ≤ (Inférieur ou égal). |
| Valeur | La valeur que la variable doit avoir ; pour un booléen, Vrai ou Faux. |
Les quatre correspondances :
| Correspondance | Vrai quand la variable… | Possible pour |
|---|---|---|
| Une seule valeur | se compare à la valeur avec l'opération | Texte (=, ≠ et Commence par), Nombre, Booléen (=) |
| Un intervalle de valeurs | est entre De et À, bornes incluses | Nombre |
| Une liste de valeurs | est égale à l'une des Valeurs séparées par des virgules | Texte, Nombre |
| Chaque multiple d’un nombre | est un multiple de Tous les (3 → 3, 6, 9…) | Nombre |
La ligne affiche ensuite sa condition sous le nom du déclencheur, par exemple
months ≥ 12, months 6–11, streak ∈ 3, 6, 9 ou streak ×3.
obs.sceneName, mais
scene.sceneName dans le payload. Prenez toujours le nom dans la documentation des
événements WebSocket ou dans l'Inspecteur d’événements, sans le data. du début.Plusieurs lignes pour un déclencheur
Vous pouvez ajouter le même déclencheur plusieurs fois avec des conditions différentes.
Dans les Alertes, un événement affiche la première ligne dont il remplit la
condition ; si aucune ne correspond, la ligne de ce déclencheur sans condition ;
s'il n'y en a pas, rien. Un réglage classique : une ligne « Resub » sans condition, et
une autre avec months ≥ 12 et un remerciement plus appuyé.
Déclencher un widget depuis vos propres actions
N'importe quelle liste de déclencheurs peut réagir à l'une de vos propres actions Streamer.Bot — une récompense, une commande, un mini-jeu — grâce à un événement personnalisé. Exemple : afficher un compte à rebours quand votre action se lance.
Lancez un événement personnalisé depuis votre action
Dans Streamer.Bot, ajoutez une sous-action Custom Event Trigger à votre action.
Donnez-lui un nom, par exemple Show Muted Timer, et cochez Use Args si le widget doit
utiliser des informations de l'action (qui l'a déclenchée, sa plateforme…).
Ajoutez le déclencheur sur la page du widget
Cliquez sur Ajouter un déclencheur dans la liste qui doit réagir : pour un compte à rebours, Afficher dans son onglet Commandes. Choisissez Custom › Other › Event.
Ne gardez que votre événement
Activez Activer quand une condition précise est remplie, puis remplissez :
| Champ | Valeur |
|---|---|
| Nom de la variable | eventName |
| Type de variable | Texte |
| Correspondance | Une seule valeur |
| Opération | = (Égal) |
| Valeur | Le nom donné à l'événement personnalisé, par exemple Show Muted Timer |
Cliquez sur Enregistrer le déclencheur.
Sans la condition, la ligne réagirait à tous les événements personnalisés que lancent vos actions.
args :
utilisez-les sous la forme args.<nom>, dans les conditions comme dans les textes — par
exemple args.user, args.eventSource ou args.rewardName, pour que le Modèle du texte
d'un compte à rebours affiche {args.user} m'a rendue muette !. Les noms qui contiennent des
points ou des crochets se tapent tels quels : args.reward.title, args.match[0].
L'Inspecteur d’événements montre tous les arguments qu'envoie votre action.Variables de texte
Titres, textes et messages de chat acceptent des variables entre accolades, nommées
comme Streamer.Bot les nomme dans le payload de l'événement : {user.name}, {bits},
{recipient.name}, {amount}… Chacun est son nom complet dans le data de l'événement, lu
exactement tel que tapé.
Les noms de chaque déclencheur sont dans la documentation des événements WebSocket de Streamer.Bot, liée sous chaque tableau. Une variable que l'événement ne contient pas reste telle quelle, accolades comprises — pratique pour repérer une faute de frappe dans l'aperçu.
Ce qu'ajoute une ligne d'objectif
Dans les objectifs et les déclencheurs qui augmentent les Compteurs de stream, chaque ligne indique aussi ce qu'elle ajoute — Progression de l’objectif dans les objectifs, Ce qu’il ajoute dans les Compteurs de stream :
- Ajouter 1 — chaque événement compte pour un.
- Ajouter la valeur d’une variable — l'événement ajoute la valeur d'une de ses
variables, écrite dans Nom de la variable avec son nom complet dans
data, par exemplebitspour un cheer,gift.amountpour des Kicks.
Les Compter −1 triggers des Compteurs de stream indiquent plutôt Ce qu’il retire : Retirer 1 ou Retirer la valeur d’une variable.
Le déclencheur d'un objectif de subathon a aussi, en dessous, Timer du subathon incrementation et ses Secondes ajoutées : le temps qu'il ajoute pour chaque 1 compté (par bit, par €…). → Temps ajouté
Le tableau des scores et les Cartes de viewers l'appellent Incrément du score, avec un choix de plus : Remplacer par la valeur d’une variable, et en dessous Only replace if the new value is higher than the current value pour garder la plus haute valeur vue (pic de viewers).
Un message de chat par ligne
Le bouton en forme de bulle d'une ligne — dans les Alertes et le Temps ajouté du subathon, l'interrupteur Envoyer un message dans le chat de la ligne choisie, avec Réglages du message dans le chat à sa droite qui ouvre la fenêtre Message dans le chat tant qu'il est activé — ajoute un Message dans le chat, envoyé quand la ligne se déclenche :
| Champ | Détail |
|---|---|
| Message dans le chat | Par exemple Thank you {user.name}!. Mêmes variables que plus haut. |
| Publier sur | Twitch, YouTube, Kick. Un déclencheur de plateforme publie par défaut sur sa propre plateforme ; un déclencheur d'intégration sur toutes les plateformes où Streamer.Bot est connecté. |
| Envoyer avec le bot | Activé par défaut. Là où il n'y a pas de compte bot (YouTube n'en signale aucun), c'est le compte broadcaster qui l'envoie. |
L'Accueil des chatteurs et les Récompenses d’activité ont le même message en dehors de toute ligne : un interrupteur Envoyer un message dans le chat, puis Envoyer avec le bot sur la même ligne, le message et, quand c'est utile, Publier sur. Activé sans plateforme choisie, il coche les plateformes où Streamer.Bot a un compte connecté.
Un son par ligne
Le bouton haut-parleur (Jouer un son) ouvre la fenêtre du son — Son de l’alerte sur les lignes de déclencheurs. L'enregistrer active le son ; cliquer de nouveau sur le haut-parleur le désactive, et le crayon à côté le modifie. Dans une alerte, un interrupteur Jouer un son active et désactive le son (il n'ouvre jamais la fenêtre), et Réglages du son, à sa droite, actif tant qu'il est activé, ouvre la fenêtre. L'Accueil des chatteurs (Son d’accueil) et les Sondages et prédictions (Son des sondages Twitch, Son des prédictions Twitch or Son des sondages YouTube) utilisent la même fenêtre.
Un son vient de l'un de ces trois endroits :
| Source | Détail |
|---|---|
| Fichier sur ce PC | Fichier son, par exemple C:\Sounds\alert.mp3. Parcourir… ouvre le sélecteur de fichiers de Windows sur le PC où tourne Streamer.Bot. |
| Fichier d’un dossier | Dossier de sons, par exemple C:\Sounds\Alerts : un fichier au hasard du dossier se joue à chaque fois. Inclure les sous-dossiers ajoute ceux des sous-dossiers. |
| Lien | Lien du fichier son : un lien direct vers un fichier audio. La source navigateur le charge depuis ce lien, qui doit donc rester en ligne — les liens temporaires, comme les pièces jointes Discord, cessent de fonctionner au bout d'un moment. |
Fichiers et dossiers sont joués par Streamer.Bot lui-même, via l'action Stream UI - Sounds, sur sa sortie audio par défaut. Parcourir… demande Streamer.Bot connecté et le dernier code de Stream UI - Backend. Chaque source a Écouter pour l'essayer et Volume de 0 à 100 % (80 par défaut). Fichiers et dossiers ont en plus :
| Réglage | Défaut | Détail |
|---|---|---|
| Terminer avant le son suivant | désactivé | Le son suivant attend la fin de celui-ci (l'action Sounds doit être dans une file bloquante). |
| Arrêter les autres sons | désactivé | Arrête d'abord tous les sons que Streamer.Bot joue. |
| Utiliser le nom du fichier comme nom as name | activé | Désactivé : le champ Nom du son nomme le son dans Streamer.Bot. |
Annuler ferme la fenêtre, Enregistrer le son garde le son.
Dans les Alertes, le son se joue quand l'alerte s'affiche vraiment : une alerte en file d'attente joue son son quand vient son tour. Dans le Temps ajouté du subathon, il se joue quand l'événement est compté. Un objectif a un son à lui, joué quand il est atteint, et un compte du subathon aussi, joué à chaque palier. Les sons ne sont joués que par l'overlay qui lance les actions. L'aperçu du site joue les liens, jamais les fichiers : un fichier se jouerait en stream.
Une image par ligne
Dans les Alertes, l'interrupteur Utiliser la photo de profil du viewer d'une alerte et Réglages de l’image, à sa droite, choisissent son image : la photo de profil du spectateur ou une image que vous importez, avec le style de la Image des alertes (onglet Style) ou le sien. → Alertes › L'image
Un message Discord par ligne
Dans les Alertes, une fois Publier les alertes sur Discord activé (Réglages des alertes), chaque alerte a un interrupteur Publier sur Discord, et Réglages du message Discord à sa droite, actif tant qu'il est activé, ouvre Message Discord : reprenez le message de chat de l'alerte ou écrivez-en un à part. Le poster au nom du spectateur ou sous le nom par défaut se règle avec le webhook. Comme les messages de chat, il n'est envoyé que par l'overlay qui lance les actions. Régler le webhook → Alertes › Webhooks Discord.
Connexion
Se connecter au serveur WebSocket de Streamer.Bot, installer le pack de quatre actions, choisir plateformes et intégrations, et sauvegarder ses réglages.
Chat
Chat multi-plateforme avec emotes, badges, annonces Twitch, échanges de points de chaîne, Bits, Kicks, Super Chats et Jewels YouTube, et un relais de chat facultatif entre vos plateformes.