Alertas

Muestra los eventos de tu canal de uno en uno, cada uno con la foto de la persona implicada. Las alertas van en cola: si llegan tres subs a la vez, se reproducen una tras otra. Cada alerta también puede publicarse en un canal de Discord.

Plataformas: Twitch, YouTube, Kick, y las integraciones activadas en Conexión (Ko-fi, Streamlabs, StreamElements…)

Paquete de acciones: Stream UI - Get Profile Pic para las fotos de perfil de Twitch, Stream UI - Sounds para los archivos de sonido, Stream UI - Broadcast para los controles manuales, Stream UI - Backend para los webhooks de Discord y la pausa → Conexión

La página

La página del widget funciona como una pequeña aplicación:

• Ajustes, Estilo y Controles, las pestañas encima del editor, cambian lo que muestra.
• La columna de la izquierda lista las secciones de la pestaña — Ajustes de las alertas, Alertas de plataformas e Alertas de integraciones en la pestaña Ajustes. Haz clic en una para editarla en la zona principal. En la pestaña Controles, sus controles y sus disparadores → Controles, y la guía Alertas personalizadas.
• Alertas de plataformas abre una columna propia: Twitch, YouTube, Kick. Alertas de integraciones hace lo mismo con cada integración activada; sin ninguna, muestra un botón Activar integraciones, que abre la página Ajustes.
• Una fuente abre su Lista de alertas: una fila por disparador de Streamer.Bot, con su condición debajo. Añadir disparador añade uno; el menú de una fila la duplica (el mismo disparador con otra condición) o la borra. La alerta elegida se edita en la zona principal.
• Vista previa del widget, el panel contra el borde derecho de la ventana: la vista previa, los botones de prueba y la URL propia del widget. La flecha de arriba lo pliega en un riel estrecho. Arrastra su borde izquierdo para ensancharlo, hasta la mitad de la ventana; conserva su ancho. Widget muestra el widget en su posición, recortado del lienzo tal como lo dibuja tu fuente de navegador; En el lienzo, todo el lienzo.

Ajustes

Ajustes de las alertas

Tres partes, cada una bajo su título: Visualización, Icono de plataforma y Webhooks de Discord.

Webhooks de Discord

La última parte de Ajustes de las alertas: publica alertas en un canal de Discord a través de Streamer.Bot — un follow, un sub, una donación de Ko-fi anunciada en tu servidor. Publicar las alertas en Discord, bajo su título, lo activa (desactivado por defecto) y muestra sus ajustes; eliges qué alertas con Publicar en Discord en cada alerta.

Para conseguir la URL del webhook, en Discord: ajustes del canal › Integraciones › Webhooks › Nuevo webhook › Copiar URL de webhook.

Después, en cada alerta que quieras publicar, activa Publicar en Discord; Ajustes del mensaje de Discord, a su derecha, abre Mensaje de Discord: Reutilizar el mensaje del chat, activado por defecto, publica el mismo mensaje que el mensaje de chat de la fila; desactivado, escribe un Mensaje de Discord propio, con las mismas variables que el texto de la alerta.

Guardar el mensaje de Discord lo guarda. Como los mensajes de chat y los sonidos, los mensajes de Discord solo salen del overlay que ejecuta las acciones, nunca de los demás overlays, de una URL de un solo widget ni de la vista previa.

Una alerta

La alerta elegida, en la zona principal: el nombre de su disparador arriba, Cambiar de disparador para elegir otro disparador u otra condición, y después sus ajustes en cinco partes: Ajustes del overlay (Título, Texto), Datos del espectador (la imagen), Mensaje en el chat, Webhook de Discord y Ajustes del sonido:

Cómo funcionan el selector, las condiciones, las variables y los sonidos está en su propia página → Disparadores y condiciones.

Las filas por defecto

Twitch

YouTube

Kick

Integraciones. Cuando activas una integración, su lista empieza con una fila por cada uno de sus disparadores que nombra a una persona, titulada con la integración y el disparador (por ejemplo Ko-fi Donation). El texto nombra a la persona y el importe cuando lo hay: las donaciones de Ko-fi dicen {from} sent {amount} {currency}!.

Estas integraciones empiezan con una lista vacía, para que la rellenes tú: HypeRate, Patreon, Pulsoid, Shopify, Speaker.bot, Streamer.bot Remote, Streamloots, Throne, T.I.T.S., Voicemod, VTube Studio.

La imagen

Cada alerta elige su imagen. El interruptor Usar la foto de perfil del espectador de una alerta, activado por defecto, dice de dónde viene su imagen. Activado: la foto de perfil de la persona. Desactivado: una imagen que subes. Ajustes de la imagen, a su derecha, abre Imagen, donde la subes:

Guardar la imagen la guarda para esa fila; Restablecer quita la imagen de la fila: esa alerta ya no muestra ninguna. Una alerta personalizada muestra la imagen enviada con ella, si la hay.

YouTube y Kick envían la foto de perfil con el evento. Twitch no: la fuente de navegador se la pide a la acción Stream UI - Get Profile Pic. Las integraciones usan la imagen que trae su payload, cuando la hay. La vista previa del sitio nunca descarga fotos.

Estilo

La pestaña Estilo ajusta cada parte de la alerta — ver Apariencia para saber cómo funciona:

Estilo para da a una plataforma o integración su propio estilo: elígela y cambia los campos que quieras. Todo lo demás sigue Todas.

Botones de prueba

Botones de prueba, en el panel Vista previa del widget, tiene un botón por alerta, en una pestaña por fuente — por ejemplo Gift Subscription (months ≥ 12). Cada uno reproduce un evento que cumple la condición de la fila.

Controles

En la pestaña Controles de la página del widget:

• Controles, la columna de la izquierda, lista Pausar, Reanudar, Saltar la alerta y Vaciar la cola, cada uno con los nombres de sus disparadores. Elige uno para ver sus disparadores en Lista de disparadores, al lado.
• Lista de disparadores: los disparadores de Streamer.Bot que lo lanzan — ninguno por defecto, por ejemplo el inicio y el final de una pausa publicitaria, o un cambio de escena. Añadir disparador añade uno, con condiciones incluidas → Disparadores y condiciones.
• La zona principal muestra Alertas: En marcha o En pausa, con los botones Reanudar y Pausar, y después los demás botones, todos también en la ventana de controles:

Los botones necesitan Streamer.Bot conectado; Pausar y Reanudar necesitan Stream UI - Backend, los demás Stream UI - Broadcast.

Pausa y reanudación

En pausa, la alerta en pantalla termina su tiempo, y las nuevas alertas esperan en la cola en lugar de mostrarse: no se pierde ninguna. Sus mensajes de chat y de Discord se envían igualmente al momento; su sonido suena cuando se muestran. Reanudar reproduce las alertas que han esperado, una tras otra — usa Vaciar la cola antes si prefieres descartarlas. La fuente de navegador guarda las alertas en espera: recargarla durante la pausa las descarta.

El estado se guarda en Streamer.Bot, en la variable global persistente streamUi.off.alerts (1: en pausa; 0 o ninguna: en marcha), así que dura hasta que reanudas, aunque la fuente de navegador se recargue, y todos los overlays lo siguen al momento. Tus propias acciones también pueden pausar o reanudar el widget, con una subacción Global (Set) sobre esa variable.

Alertas personalizadas

Envía alertas desde tus propias acciones de Streamer.Bot — un logro desbloqueado, una recompensa propia. En la pestaña Controles de la página del widget, un recuadro bajo los botones lleva aquí (Ver la documentación).

Configuración, una sola vez:

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;
    }
}

Cómo usarla, en cualquier acción — un comando, una recompensa de puntos de canal…:

1. Añade subacciones Core › Arguments › Set Argument para estos argumentos:

2. Añade una subacción Core › Actions › Run Action que ejecute Stream UI - Send Custom Alert.

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

Las alertas personalizadas entran en la misma cola, sin mensaje de chat ni sonido.

Posición por defecto

Posición Abajo al centro, tan ancho como la posición, tamaño 100 % — se cambia en la pestaña Disposición del Editor de overlays.

Eventos de Streamer.Bot que escucha

El disparador de cada fila con texto, para las plataformas activadas y las integraciones activadas, los disparadores Pausar, Reanudar, Saltar la alerta y Vaciar la cola que has elegido, más General.Custom para las alertas personalizadas, los botones y las fotos de perfil de Twitch, y Misc.GlobalVariableUpdated / Misc.GlobalVariableCreated para la pausa cambiada en otro sitio.