Alertes

Affiche les événements de votre chaîne un par un, chacun avec la photo de la personne concernée. Les alertes passent en file d'attente : si trois subs arrivent en même temps, elles s'enchaînent. Chaque alerte peut aussi être postée dans un salon Discord.

Plateformes : Twitch, YouTube, Kick, et les intégrations activées dans Connexion (Ko-fi, Streamlabs, StreamElements…)

Pack d'actions : Stream UI - Get Profile Pic pour les photos de profil Twitch, Stream UI - Sounds pour les fichiers son, Stream UI - Broadcast pour les commandes manuelles, Stream UI - Backend pour les webhooks Discord et la pause → Connexion

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 des alertes, Alertes des plateformes et Alertes des intégrations dans l'onglet Réglages. Cliquez sur l'une d'elles pour la modifier dans la zone principale. Dans l'onglet Commandes, ses commandes et leurs déclencheurs → Commandes, et le guide Alertes personnalisées.
• Alertes des plateformes ouvre une colonne à elle : Twitch, YouTube, Kick. Alertes des intégrations fait de même avec chaque intégration activée ; sans aucune, elle affiche un bouton Activer des intégrations, qui ouvre la page Réglages.
• Une source ouvre son Liste des alertes : une ligne par déclencheur Streamer.Bot, avec sa condition dessous. Ajouter un déclencheur en ajoute un ; le menu d'une ligne la duplique (le même déclencheur avec une autre condition) ou la supprime. L'alerte 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.

Réglages

Réglages des alertes

Trois parties, chacune sous son titre : Affichage, Icône de plateforme et Webhooks Discord.

Webhooks Discord

La dernière partie d'Réglages des alertes : poste des alertes dans un salon Discord via Streamer.Bot — un follow, un sub, un don Ko-fi annoncé sur votre serveur. Publier les alertes sur Discord, sous son titre, l'active (désactivé par défaut) et affiche ses réglages ; vous choisissez quelles alertes avec Publier sur Discord dans chaque alerte.

Pour obtenir l'URL du webhook, dans Discord : paramètres du salon › Intégrations › Webhooks › Nouveau webhook › Copier l'URL du webhook.

Ensuite, dans chaque alerte à poster, activez Publier sur Discord ; Réglages du message Discord, à sa droite, ouvre Message Discord : Reprendre le message du chat, activé par défaut, poste le même message que le message de chat de la ligne ; désactivé, écrivez un Message Discord à part, avec les mêmes variables que le texte de l'alerte.

Enregistrer le message Discord le garde. Comme les messages de chat et les sons, les messages Discord ne partent que de l'overlay qui lance les actions, jamais des autres overlays, d'une URL d'un seul widget ou de l'aperçu.

Une alerte

L'alerte choisie, dans la zone principale : le nom de son déclencheur en haut, Changer de déclencheur pour choisir un autre déclencheur ou une autre condition, puis ses réglages en cinq parties : Réglages de l’overlay (Titre, Texte), Infos du viewer (l'image), Message dans le chat, Webhook Discord et Réglages du son :

Le fonctionnement du sélecteur, des conditions, des variables et des sons a sa propre page → Déclencheurs et conditions.

Les lignes par défaut

Twitch

YouTube

Kick

Intégrations. Quand vous activez une intégration, sa liste démarre avec une ligne pour chacun de ses déclencheurs qui nomme une personne, titrée avec l'intégration et le déclencheur (par exemple Ko-fi Donation). Le texte nomme la personne, et le montant quand il y en a un : les dons Ko-fi donnent {from} sent {amount} {currency}!.

Ces intégrations démarrent avec une liste vide, à remplir vous-même : HypeRate, Patreon, Pulsoid, Shopify, Speaker.bot, Streamer.bot Remote, Streamloots, Throne, T.I.T.S., Voicemod, VTube Studio.

L'image

Chaque alerte choisit son image. L'interrupteur Utiliser la photo de profil du viewer d'une alerte, activé par défaut, dit d'où vient son image. Activé : la photo de profil de la personne. Désactivé : une image que vous importez. Réglages de l’image, à sa droite, ouvre Image, où vous l'importez :

Enregistrer l’image la garde pour cette ligne ; Réinitialiser retire l'image de la ligne : cette alerte n'en affiche alors aucune. Une alerte personnalisée affiche l'image envoyée avec elle, s'il y en a une.

YouTube et Kick envoient la photo de profil avec l'événement. Twitch non : la source navigateur la demande à l'action Stream UI - Get Profile Pic. Les intégrations utilisent l'image que contient leur payload, quand il y en a une. L'aperçu du site ne récupère jamais les photos.

Style

L'onglet Style règle chaque partie de l'alerte — voir Apparence pour le fonctionnement :

Style pour donne à une plateforme ou à une intégration son propre style : choisissez-la, puis modifiez les champs voulus. Tout le reste continue de suivre Tous.

Boutons de test

Boutons de test, dans le panneau Aperçu du widget, a un bouton par alerte, dans un onglet par source — par exemple Gift Subscription (months ≥ 12). Chacun joue un événement qui remplit la condition de la ligne.

Commandes

Dans l'onglet Commandes de la page du widget :

• Commandes, la colonne de gauche, liste Pause, Reprendre, Passer l’alerte et Vider la file, 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 — aucun par défaut, par exemple le début et la fin d'une page de pub, ou un changement de scène. Ajouter un déclencheur en ajoute un, conditions comprises → Déclencheurs et conditions.
• La zone principale affiche Alertes : En cours ou En pause, avec les boutons Reprendre et Pause, puis les autres boutons, tous aussi dans la fenêtre de contrôles :

Les boutons demandent Streamer.Bot connecté ; Pause et Reprendre demandent Stream UI - Backend, les autres Stream UI - Broadcast.

Pause et reprise

En pause, l'alerte à l'écran va au bout de son temps, et les nouvelles alertes attendent dans la file au lieu de s'afficher : aucune n'est perdue. Leurs messages de chat et Discord partent quand même tout de suite ; leur son se joue quand elles s'affichent. Reprendre joue les alertes qui ont attendu, l'une après l'autre — Vider la file d'abord si vous préférez les abandonner. Les alertes en attente sont gardées par la source navigateur : la recharger pendant la pause les abandonne.

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

Alertes personnalisées

Envoyez des alertes depuis vos propres actions Streamer.Bot — un succès débloqué, une récompense maison. Dans l'onglet Commandes de la page du widget, un encadré sous les boutons renvoie ici (Voir la documentation).

Mise en place, une seule fois :

using System;
using Newtonsoft.Json;

public class CPHInline
{
    public bool Execute()
    {
        // Sends a custom alert to Stream UI's overlays from this action's arguments
        CPH.TryGetArg("title", out string title);
        CPH.TryGetArg("text", out string text);
        CPH.TryGetArg("alertImageUrl", out string alertImageUrl);
        CPH.TryGetArg("platform", out string platform);

        var alert = new
        {
            @event = "customAlert",
            title = title ?? "",
            text = text ?? "",
            alertImageUrl = alertImageUrl ?? "",
            platform = platform ?? ""
        };
        CPH.WebsocketBroadcastJson(JsonConvert.SerializeObject(alert));
        return true;
    }
}

Utilisation, dans n'importe quelle action — une commande, une récompense de points de chaîne… :

1. Ajoutez des sous-actions Core › Arguments › Set Argument pour ces arguments :

2. Ajoutez une sous-action Core › Actions › Run Action qui lance Stream UI - Send Custom Alert.

Set Argument  title = Achievement unlocked
Set Argument  text  = 100 hours streamed!
Run Action    Stream UI - Send Custom Alert

Les alertes personnalisées rejoignent la même file d'attente, sans message de chat ni son.

Position par défaut

Position En bas au centre, aussi large que la position, taille 100 % — à changer dans l'onglet Disposition du Créateur d’overlay.

Événements Streamer.Bot écoutés

Le déclencheur de chaque ligne qui a un texte, pour les plateformes activées et les intégrations activées, les déclencheurs Pause, Reprendre, Passer l’alerte et Vider la file choisis, plus General.Custom pour les alertes personnalisées, les boutons et les photos de profil Twitch, et Misc.GlobalVariableUpdated / Misc.GlobalVariableCreated pour la pause changée ailleurs.