Connexion à Streamer.Bot

Stream UI dialogue avec Streamer.Bot par son serveur WebSocket. La plupart des widgets n'ont besoin de rien d'autre. Quelques fonctions demandent en plus quatre petites actions C#, le pack d'actions, importées en une fois.

La page Réglages a quatre onglets : Streamer.bot (les actions, la connexion, les plateformes et les intégrations, ouvert par défaut), Utilisateurs ignorés, Sauvegarde et Licence.

L'onglet Streamer.bot

1. Importer les actions

Chaîne d’import des actions Streamer.bot, en haut de la carte du serveur WebSocket :

Une fois connecté, la ligne Actions de État du système indique si elles sont toutes là. Après une mise à jour de Stream UI, importez de nouveau la chaîne : une fonction ajoutée depuis peut en avoir besoin.

2. Démarrer le serveur WebSocket

Dans Streamer.Bot, ouvrez Servers/Clients → WebSocket Server :

Cochez Auto Start, puis cliquez sur Start Server.

3. Se connecter

Recopiez les mêmes valeurs dans la carte Serveur WebSocket de Streamer.bot :

Cliquez sur Connecter. Activez Me connecter automatiquement à l’ouverture du site pour ne pas avoir à cliquer à chaque fois.

État du système

À côté du formulaire, État du système montre ce que le site a trouvé dans votre Streamer.Bot :

Si la connexion échoue, le message dit pourquoi : Streamer.Bot n'est pas lancé ou son serveur n'est pas démarré, un mot de passe est demandé ou faux, aucune réponse à temps, ou autre chose que Streamer.Bot répond sur ce port.

Plateformes et intégrations

Les Plateformes — Twitch, YouTube et Kick — sont toutes activées par défaut. Chaque ligne montre le compte avec lequel Streamer.Bot est connecté. Désactivez une plateforme pour ignorer ses événements dans tous les widgets et masquer ses sections et ses déclencheurs sur le site.

Les Intégrations Streamer.bot sont les services connectés à Streamer.Bot. Elles sont toutes désactivées par défaut ; activez celles que vous utilisez :

Crowd Control · DonorDrive · Fourthwall · HypeRate · Ko-fi · Pally.gg · Patreon · Pulsoid · Shopify · Speaker.bot · StreamElements · Streamer.bot Remote · Streamlabs · Streamloots · Throne · T.I.T.S. · TipeeeStream · TreatStream · Voicemod · VTube Studio

En activer une l'ajoute partout où elle sert : sa propre section dans les Alertes et les Objectifs et subathon, ses boutons de test, et son propre bouton sous Style pour dans l'onglet Style des alertes. Streamer.Bot n'indique pas si une intégration est configurée : ces lignes n'ont donc pas de badge d'état.

Une intégration dont les événements viennent d'une personne (un don, une commande…) se déplie avec la flèche à gauche de son icône : un champ par déclencheur, le champ de l'événement qui contient le nom de la personne — from pour Ko-fi, par exemple. Les cartes de viewers créditent le viewer de ce nom. Chaque champ affiche celui que documente Streamer.Bot tant que vous n'en tapez pas un autre ; laissé vide, il y revient.

Les quatre actions

Ce que fait chaque action importée. Aucune n'a besoin de déclencheur : le site les appelle par leur nom.

Stream UI - Broadcast

Permet au site d'envoyer des commandes (lancer un subathon, tester une alerte, lancer le générique…) à votre overlay. Elles arrivent sous la forme d'un événement General.Custom.

Stream UI - Backend

Enregistre ce qui doit survivre à un redémarrage dans les variables globales de Streamer.Bot — la progression des objectifs et du subathon (streamUi.goals.<id de l'objectif>, streamUi.subathon), les places du Premier du chat, les compteurs (streamUi.counter.<nom>), les nombres de spectateurs, le compte des Récompenses d’activité, la pause du relais de chat et celle de Sondages et prédictions, les webhooks Discord — et permet au site de les modifier pendant le direct. Elle écrit aussi les variables utilisateur des spectateurs (firstInChat, lastSeen, chatMessages), récupère les clips et les infos de chaîne Twitch pour Shoutout et le Lecteur de clips, vérifie de quels groupes d'utilisateurs un spectateur fait partie, remplit, lit et vide les groupes du Générique de fin, envoie les shoutouts Twitch, poste les alertes, les messages et les images sur Discord, lit les photos Twitch de vos comptes diffuseur et bot (pour l'onglet Utilisateurs ignorés et les aperçus) et ouvre les sélecteurs de fichier et de dossier de Windows pour les sons et les dossiers de captures. Pour le tableau des scores et les cartes de viewers, elle garde les scores (ss.<plateforme>.<stat>.*) et les stats des viewers, ajoute les viewers aux groupes des succès et enregistre les captures des cartes. Elle ajoute les déclencheurs New First in Chat, New Stream High Score et New Achievement Unlocked (Custom › Stream UI) pour vos propres actions.

Stream UI - Sounds

Joue les fichiers son de vos alertes, objectifs, accueils et sondages depuis ce PC — un fichier, ou un fichier au hasard d'un dossier — avec le lecteur de Streamer.Bot, sur la sortie audio par défaut de Streamer.Bot (le C# ne peut pas en choisir une autre). Les sons réglés en Lien n'en ont pas besoin : c'est la source navigateur qui les joue.

Stream UI - Get Profile Pic

Récupère les photos de profil Twitch pour les Alertes, le Premier du chat et l'Accueil des chatteurs. YouTube et Kick envoient la leur avec l'événement, Twitch non.

Qui a besoin de quoi

Les commandes manuelles sont les boutons de l'onglet Commandes de chaque page de widget, aussi réunis dans la fenêtre de contrôles.

L'onglet Utilisateurs ignorés

Les personnes dont les messages n'apparaissent jamais dans le Chat ni dans la Pluie d'emotes et de gifs, qui ne sont jamais transmises par le relais de chat, jamais saluées par l'Accueil des chatteurs, jamais comptées comme chatteurs uniques par le Compteur de spectateurs, jamais premières du chat, jamais comptées ni récompensées par les Récompenses d’activité et jamais ajoutées au Générique de fin — vos bots, un compte secondaire. La liste vaut pour tous les widgets à la fois.

• Ignorer les comptes connectés — List of accounts connected in Streamer.bot. Toggle to add to the ignored user list. Une ligne par plateforme activée, le Streamer à gauche et le Bot à droite, chacun avec sa photo. Activez-en un pour l'ignorer ; si le compte change de nom, la liste suit.
• Utilisateurs ignorés — Ces utilisateurs sont exclus sur ce site. Tapez n'importe quel nom dans Pseudo à ignorer, puis Ajouter. Les noms sont comparés sans tenir compte des majuscules. La liste démarre vide : ajoutez vous-même vos bots (Nightbot, StreamElements…).

L'onglet Sauvegarde

Vos réglages ne vivent que dans ce navigateur. Utilisez l'onglet Sauvegarde :

Les licences sont rangées à part : export, import et réinitialisation n'y touchent jamais, et une sauvegarde ne contient jamais de clé.

L'onglet Licence

Deux licences côte à côte, chacune avec sa propre clé :

• Licence sans publicité — 1 mois, 6 mois ou 1 an. Une fois la clé acceptée, les publicités disparaissent du site dans ce navigateur. Elles n'apparaissent jamais dans votre overlay de toute façon. C'est le même panneau que l'encadré Soutenir le projet de la page d'accueil de Stream UI.
• Stream Scores Licence — 4,99 € par mois ou 99,99 € une fois, hors TVA. Plus d'un overlay pour le tableau des scores et les cartes de viewers, toutes les stats du tableau des scores activées (5 par plateforme sans elle), toutes les stats et tous les succès sur les cartes (5 stats par plateforme et 5 succès par liste sans elle), et pas de publicité non plus. Les clés achetées pour l'ancien site Stream Scores fonctionnent ici. Tant qu'elle est active, l'URL de l'overlay contient la clé, et la source navigateur la vérifie elle-même : recopiez l'URL après l'avoir saisie.

Saisissez une clé dans sa carte, ou choisissez une formule pour en acheter une. Vérifier maintenant interroge de nouveau Lemon Squeezy ; Désactiver libère l'activation de ce navigateur, pour utiliser la clé ailleurs.

Piloter les widgets depuis vos propres actions

N'importe quelle action Streamer.Bot peut commander un widget : ajoutez une sous-action Execute C# Code qui diffuse du JSON.

CPH.WebsocketBroadcastJson("{\"event\":\"rollCredits\",\"scrollTime\":60}");

Aucune action du pack n'est nécessaire pour cela. Les widgets qui acceptent des commandes les listent dans l'onglet Commandes de leur page, avec une ligne prête à copier, ou sur leur page de documentation (Cartes de viewers).

Les objectifs n'ont pas de commande : leur compteur et leur cible se modifient sur la page Objectifs et subathon, via Stream UI - Backend. Les Compteurs de stream et le Compteur de spectateurs n'en ont pas non plus : vos actions modifient directement leurs variables globales persistantes — la valeur d'un compteur, ou le fait qu'il soit masqué — et l'overlay suit. De même pour afficher et masquer le Chat, le Premier du chat, les Objectifs et subathon, le Compteur de spectateurs et le Tableau des scores : streamUi.off.<widget>.display (chat, chatfirst, goals, viewers, scoreboard) à 1 masque le widget dans chaque overlay, à 0 l'affiche.