Scénarios d'automatisation

Fourni avec strAImer : ce module s'installe avec l'application, il n'y a donc rien à télécharger. Il figure dans Catalogue de modules → Intégrés.

Ce qu'est cette page

Automatisation → Scénarios relie un événement à une chaîne d'actions : un spectateur échange une récompense, et OBS change de scène, un son se joue et le bot écrit une ligne dans le chat. La description de la page le dit ainsi : « Configurer des règles de réaction pour les récompenses Twitch et les minuteries ».

Un scénario tient en trois choses, et il vaut mieux ne pas les confondre :

• Déclencheurs — les portes d'entrée. Plusieurs peuvent lancer le même scénario.
• Chaîne d'étapes — ce qui se passe, de haut en bas. Ni branchement, ni condition.
• Groupe — une enveloppe facultative capable d'allumer et d'éteindre tout un ensemble de scénarios toute seule, selon ce qu'OBS affiche.

Comment le configurer

1. Créez-le

Créer un scénario dans l'en-tête. Une page vide affiche « Aucun scénario trouvé. Créez votre premier scénario ci-dessus. » Remplissez Nom du scénario et choisissez un Groupe — Aucun groupe est une réponse valable, et [ Créer un nouveau groupe... ] en crée un sur place.

2. Ajoutez un déclencheur

Déclencheurs est la liste des portes d'entrée, et la page explique pourquoi c'est une liste et non un seul : « N'importe lequel de ceux-ci démarre la même chaîne d'étapes. Ajoutez-en un deuxième au lieu de copier le scénario. » + Déclencheur ouvre Ajouter un déclencheur, et Type de Déclencheur en propose quatorze :

Pour les trois minimums, zéro veut dire « n'importe lequel ». Stream démarré et Stream terminé le disent eux-mêmes : « Se déclenche une fois lorsque l'état du stream change. Rien à configurer. »

Le minuteur a atteint zéro écoute les comptes à rebours de Widgets → Minuteurs, et l'aide sous le champ explique comment : « Les minuteurs se règlent dans Widgets → Minuteurs. Un compte à rebours qui continue sous zéro se déclenche une fois, au passage à zéro. » Seuls les comptes à rebours sont proposés : un minuteur qui compte vers le haut n'atteint jamais zéro. Un minuteur désactivé ne lance pas le scénario, et un zéro atteint pendant que l'application était fermée ne le lance pas non plus quand l'application tourne de nouveau.

Message dans le chat fonctionne d'un coup sur tous les chats connectés, et les trois façons de comparer diffèrent plus qu'il n'y paraît. Commande ne lit que le premier mot, donc « !lumière » attrape aussi « !lumière rouge » ; le point d'exclamation est facultatif dans ce que vous écrivez, mais si vous l'écrivez, un simple « lumière » au milieu d'une conversation ne compte plus. Mot n'importe où dans le message veut dire le mot entier : « salut » ne correspond pas à « salutation ». Les réponses de votre propre bot ne lancent jamais un scénario, une chaîne qui écrit dans le chat ne peut donc pas se nourrir elle-même.

Phrase vocale est comparée par l'application elle-même, pas par l'IA : elle n'a besoin d'aucun nom de bot devant la phrase et ne dépense aucun crédit. Elle entend ce qu'entend la reconnaissance vocale (Voix → Reconnaissance vocale). Avec Quand écouter réglé sur Toujours, une phrase qui revient dans une conversation ordinaire lance aussi le scénario : choisissez donc des mots que vous ne diriez pas par hasard, ou prenez La phrase correspond exactement. Avec Maintenir une touche, le micro n'écoute que pendant que la touche est enfoncée, et ce que vous dites alors part aussi à l'assistant, et c'est cette partie qui coûte des crédits. Avec Toujours, une phrase qui commence par le nom indiqué dans Comment vous appelez le bot part aussi à l'assistant, et si ce nom est vide, chaque phrase y part ; le guide « Reconnaissance vocale » explique les deux modes.

Terminé place le déclencheur dans la liste, où un déclencheur enregistré peut être rouvert ou retiré.

Deux protections vivent dans la même fenêtre, et toutes deux sont désactivées au départ. Pas plus d'une fois toutes les, secondes est la pause entre les exécutions : « Zéro signifie sans limite : chaque événement lance le scénario. Une attaque de bots envoie des centaines d'abonnements par minute, et sans pause chacun écrit dans le chat, parle et coupe un clip. » Une fois par spectateur est l'autre moitié, avec une liste à côté : par heure signifie que la même personne ne peut pas le relancer dans l'heure, par stream signifie une seule fois jusqu'au début du prochain direct. Les anciens scénarios restent sur par heure. La mémoire par stream repart de zéro quand Statut du Stream signale un nouveau direct, et quand l'application redémarre.

La pause s'affiche pour les entrées qu'une foule peut pousser : un nouveau follower, un abonnement, des abonnements offerts, un raid, des bits, un achat intégré à Twitch et un message dans le chat. Une fois par spectateur n'est proposé que pour Nouveau follower et Message dans le chat : les deux sont gratuits et faciles à répéter, alors qu'un abonnement ou des bits répétés sont un second paiement, et il n'est pas bloqué. Une récompense, un bouton du Panneau de contrôle, les bords du direct, un minuteur arrivé à zéro et une phrase prononcée n'affichent aucune des deux protections : aucune tempête n'est à craindre de ce côté-là. Un nouveau déclencheur Message dans le chat s'ouvre avec cinq secondes déjà inscrites dans la pause, parce que les spectateurs répètent les commandes ; un scénario écrit avant l'existence de ces protections se comporte exactement comme avant.

Une liste de récompenses vide affiche « Aucune récompense trouvée. Veuillez connecter Twitch ou vérifier votre tableau de bord Twitch. »

3. Le don a deux filtres

Condition de montant est Tout don, À partir de ce montant et plus, Exactement ce montant ou Entre deux montants, avec Montant et Jusqu'à en dessous.

Compter les dons de liste vos connecteurs de dons sous forme de cases : « Les plateformes non cochées sont ignorées par ce scénario. Un connecteur de don nouvellement installé compte immédiatement. »

Les montants sont comparés dans votre devise de base (Paramètres → Localisation), et un don qui n'a pas pu être converti ne déclenche pas le scénario du tout. C'est aussi pourquoi Exactement ce montant est un piège pour tout ce qui arrive dans une autre devise, et la page en avertit en toutes lettres : « Une correspondance exacte ne fonctionne que pour les dons déjà dans votre devise de base : après conversion, le montant tombe sur des fractions d'unité et ne correspond pratiquement jamais. »

4. Construisez la chaîne

Chaîne d'étapes est ce qui va se produire. Vide, elle affiche « Aucune étape pour l'instant. Ajoutez une action ou un délai. »

• + Délai insère une étape Délai avec une case de secondes.
• + Action ouvre Ajouter une Action, et la liste arrive en deux groupes.

Un Délai décide aussi de ce que fait un second déclenchement pendant que la chaîne attend encore. Une chaîne qui allume quelque chose puis l'éteint est prolongée : l'échéance recule de la durée du délai et les actions ne sont pas rejouées — acheter l'effet deux fois achète deux fois le temps, alors que répéter l'interrupteur l'aurait éteint. Une chaîne qui dit ou écrit ce que le déclenchement a apporté — {message}, {user} — s'exécute au contraire une fois par déclenchement : trois achats en cinq secondes font trois exécutions séparées, et le message de personne n'est perdu. Rien à régler ici : l'application décide d'après ce que font les étapes.

Une chaîne qui fait du son garde le son de l'application pour elle jusqu'à la fin de sa dernière étape sonore. C'est ce qui donne sa valeur à une pause avant la parole. « Attendre 6 secondes, puis dire à voix haute » garde le son pendant toute la lecture : trois achats de suite sont donc lus l'un après l'autre avec six secondes de silence entre eux, au lieu de décompter tous les trois en même temps et d'arriver collés. Une chaîne dont le son vient en premier (« jouer un son, attendre 30 secondes, masquer le filtre ») le relâche dès que le son se termine : une demi-minute d'effet ne retient personne. Une chaîne sans étape sonore n'attend pas du tout, donc un changement de scène ne passe jamais derrière la parole de quelqu'un d'autre.

Une pause s'écoule même quand l'application n'arrive pas à la noter. Le décompte démarre avant l'enregistrement de la chaîne en pause, si bien qu'un enregistrement lent ou raté n'avale plus le reste de la chaîne. Ce qui se perd dans ce cas, c'est seulement de survivre à un redémarrage de l'application : la pause va quand même jusqu'au bout et la chaîne continue.

OBS — nécessite la connexion à OBS, et les sélecteurs se remplissent depuis OBS lui-même :

• OBS : Changer de scène — Sélectionner une scène.
• OBS : Afficher ou masquer la source — Sélectionner une scène, Sélectionner une source, Action à effectuer (Afficher la source, Masquer la source, Basculer).
• OBS : Filtre de source — la même chose plus Sélectionner un filtre et État du Filtre (Activer le filtre, Désactiver le filtre).
• OBS : Couper ou rétablir l'audio — Entrée audio, puis Couper, Rétablir ou Basculer.
• OBS : Volume de l'entrée audio — Entrée audio et un curseur Volume.

strAImer — tout ce que l'application fait elle-même :

• Jouer un son : Sélectionner un son est un emplacement avec un bouton ▶ pour écouter. Un clic dessus ouvre la fenêtre Choisir un son, où chaque fichier affiche sa durée, une forme d'onde et son propre ▶, et où vous pouvez ouvrir n'importe quel dossier. Plus Volume.
• Le dire à voix haute et Envoyer un message dans le chat — les deux prennent Texte ; celle du chat prend en plus Où envoyer (Tous les chats connectés, Twitch, YouTube ou Kick).
• Prise intelligente — la prise et Action à effectuer : Allumer temporairement (qui ajoute Durée, sec), Allumer et maintenir allumée ou Éteindre. Sans prise, il est écrit « Aucune prise ajoutée — voir Appareils → Shelly ».
• Créer un clip Twitch.
• Minuteur : choisissez le minuteur, puis Que faire : Démarrer, Pause, Démarrer ou mettre en pause, Réinitialiser, Ajouter du temps ou Retirer du temps ; les deux derniers ajoutent Minutes. Sans minuteur, la liste indique « Pas encore de minuteur : ils sont dans Widgets → Minuteurs ».
• Appeler un autre service — Adresse, Ce qui est envoyé (Envoyer des données (POST) ou Ouvrir simplement l'adresse (GET)), Données en JSON ou en Texte simple, et En-têtes supplémentaires, un par ligne sous la forme « Nom : valeur », si le service demande une clé d'accès. C'est ainsi qu'un mot dans le chat atteint Discord, n8n, Make, une maison connectée ou n'importe quoi à vous. La réponse n'est pas lue : le journal garde le code de statut et le nom du service, et l'étape suivante s'exécute dans tous les cas. L'adresse et les en-têtes sont stockés chiffrés sur cet ordinateur et ne font pas partie d'une sauvegarde. Après la restauration d'une sauvegarde sur un autre ordinateur, l'étape indique « Non enregistrée sur cet ordinateur. Saisissez de nouveau l'adresse » : collez l'adresse, et les en-têtes si le service en a besoin, une nouvelle fois. Sur le même ordinateur, une étape rouverte affiche un champ vide avec « Enregistrée : {host}. Laissez vide pour la conserver », l'adresse est donc toujours là.

Sous Texte et Données se trouvent les puces {user}, {amount}, {reward}, {message} et {args} : « Cliquez sur un nom ci-dessous pour l'insérer. Il est remplacé par ce qui a déclenché le scénario ; un nom inconnu reste tel quel. » {args} appartient au déclencheur du chat : c'est le texte après la commande, donc « !commande pizza » donne « pizza ». Les guillemets et les retours à la ligne de ce qu'a écrit un spectateur sont échappés au passage dans le JSON, et les données restent donc valides.

5. Ordre et enregistrement

Les étapes s'exécutent de haut en bas. Chaque ligne porte les flèches Monter et Descendre, plus Modifier et Supprimer. Enregistrer stocke le scénario.

La carte dans la liste montre alors une étiquette par déclencheur, la chaîne entière et le nombre d'étapes. À côté : l'interrupteur marche/arrêt, Test d'exécution, Dupliquer (la copie s'ouvre aussitôt pour édition, avec « (copie) » dans le nom), Modifier et Supprimer, qui demande « Supprimer ce scénario ? »

Les groupes, et laisser OBS les commuter

Un groupe est un dossier qui peut aussi être un interrupteur. Créer un groupe dans l'en-tête en crée un ; donnez-lui un Nom du groupe, et les scénarios y entrent par le champ Groupe. Un groupe vide affiche « Aucun scénario dans ce groupe pour le moment. »

Contrôle automatique

Contrôle automatique fait suivre au groupe un Type de condition :

• Visibilité de la source sur la scène
• Scène active
• Source visible sur la scène actuelle
• L'enchère accepte les points de chaîne

Les trois premiers demandent Sélectionner la scène OBS et Sélectionner une source OBS, et chacun s'explique sous le sélecteur — par exemple « La condition est vraie tant que la scène sélectionnée est en direct. »

Ce que la condition contrôle est la liste en dessous : « Tant que la condition est remplie, tout ce qui est listé ici est activé ; dès qu'elle cesse de l'être, c'est désactivé. » La première ligne est verrouillée et toujours présente : « Les scénarios de ce groupe ne se déclenchent pas tant que la condition n'est pas remplie. » + Ajouter ajoute Récompenses de points de chaîne Twitch, une liste à cocher de vos récompenses, et Retirer enlève l'entrée.

Pourquoi certaines récompenses sont grisées

Une récompense que vous avez créée à la main sur le site de Twitch apparaît grisée, marquée « créé en dehors de strAImer », et ne peut pas être cochée. Twitch ne laisse une application commuter que les récompenses qu'elle a créées elle-même, une telle récompense serait donc refusée à chaque fois — et le groupe se déclarerait activé alors que rien n'a changé sur Twitch.

Pour en automatiser une, recréez-la comme récompense gérée dans Automatisation → Récompenses de chaîne ; le guide « Gestionnaire de Récompenses de Chaîne » couvre cette page. Une récompense déjà cochée peut toujours être décochée, un ancien réglage n'est donc jamais coincé.

Les trois secondes d'attente

Une condition qui change ne commute pas le groupe tout de suite : le nouvel état doit tenir trois secondes d'abord. Une source qui clignote et s'éteint de nouveau dans ces trois secondes ne change rien — la commutation en attente est abandonnée et le groupe reste tel qu'il était.

C'est délibéré. Une source que personne n'a eu le temps de voir à l'antenne n'est pas une raison d'ouvrir les récompenses, et commuter un groupe signifie une écriture vers Twitch par récompense qu'il contient : une source clignotante en déclenchait donc des dizaines à la suite.

L'attente ne s'applique qu'à ce qui vient d'OBS. Activer ou désactiver le Contrôle automatique, appuyer sur Enregistrer, l'enchère qui ouvre ou ferme les points de chaîne, et OBS qui perd la connexion prennent effet immédiatement.

Le groupe dans la liste

L'en-tête d'un groupe porte la case auto, l'interrupteur du groupe, Paramètres de condition et Supprimer ; cliquer sur l'en-tête replie le groupe. La suppression demande d'abord et rassure : « Supprimer le groupe "{name}" ? Tous les scénarios imbriqués seront déplacés en toute sécurité vers la section "Aucun groupe". »

Ce qu'elle ne peut pas faire

• Ni branchement ni condition à l'intérieur d'une chaîne. Les étapes s'exécutent dans l'ordre, de haut en bas. Les conditions vivent sur le déclencheur et sur le groupe, nulle part ailleurs.
• Aucun déclencheur ne réagit à chaque message du chat. Message dans le chat demande au moins une commande ou un mot, donc « saluer tous ceux qui écrivent pour la première fois » ne peut pas se construire. Ce qui marche : Nouveau follower avec Une fois par spectateur et une étape Envoyer un message dans le chat, ou Message dans le chat sur des mots de salutation comme salut et bonjour, avec Une fois par spectateur réglé sur par stream.
• Pas de déclencheur horaire. Les types sont exactement les quatorze ci-dessus : Le minuteur a atteint zéro se déclenche quand un de vos comptes à rebours se termine, pas à une heure donnée, et Délai est une étape dans une chaîne, pas un moyen de la lancer. Les messages répétés dans le chat sont une autre page : Chat Bot → Minuteurs du chat.
• Scènes, sources, filtres et entrées audio sont lus depuis OBS. Sans cette connexion, ces sélecteurs n'ont rien à proposer.
• L'emprise d'un groupe sur ses propres scénarios ne se désactive pas : « C'est ce qu'est un groupe, donc cela ne peut pas être désactivé séparément. »
• Seules les récompenses créées par strAImer peuvent être placées sous une condition. Récompenses de points de chaîne Twitch est la seule entrée que propose + Ajouter dans Ce que la condition contrôle.
• Avec le Contrôle automatique activé, l'interrupteur propre du groupe est verrouillé et indique « Géré automatiquement par une condition ».
• Les trois secondes sont fixes. Il n'y a pas de champ pour elles ni moyen de faire commuter un groupe instantanément par une condition OBS.
• Durée, sec n'existe que pour Allumer temporairement. Les deux autres actions de prise sont terminées par la chaîne, pas par un compte à rebours.
• L'attente du son ne se désactive pas tant que l'application le joue elle-même. Quand Où le son est joué (Paramètres → Audio) est sur Dans une source navigateur OBS, l'application ne peut pas savoir quand une étape Jouer un son se termine là-bas : la chaîne suivante avec son ne l'attend donc pas, et les sons peuvent se superposer. Il n'y a pas de champ pour la durée pendant laquelle une chaîne peut garder le son.