Tarjetas de espectadores

Da a cada espectador una tarjeta de puntuaciones: sus propias puntuaciones — mensajes en este stream y de siempre, Bits, canjes… — en secciones de una o dos columnas, sus insignias del chat y su nivel de suscripción, y las insignias de los logros que ha desbloqueado. Una tarjeta se muestra cuando un espectador la pide (un comando…), la de cada espectador activo pasa por turnos, o todas se desplazan juntas, cada modo de visualización con sus propios disparadores, en una sola fuente de navegador.

Las tarjetas de espectadores forman parte de los widgets Stream Scores, con el marcador. Funcionan gratis en un overlay, con un modo de visualización, 5 puntuaciones por plataforma y 5 logros por lista; Stream Scores Licence quita estos límites → Stream Scores Licence.

Plataformas: Twitch, YouTube, Kick, y las integraciones por el nombre

Paquete de acciones: necesario — Stream UI - Backend escribe las variables de los espectadores, los añade a los grupos de los logros y guarda las capturas. Mira Quién necesita qué.

Cómo funciona

• Las puntuaciones viven en Streamer.Bot, en las variables de usuario de cada espectador, en la plataforma de la que viene — temp_messages, messages… Tus propias acciones pueden leerlas y cambiarlas.
• Solo cuenta lo que hace un espectador. Los selectores de disparadores solo ofrecen los que provoca un espectador: los eventos de las plataformas, Core › Commands, los eventos de integraciones que nombran a una persona, y User Global Variable Updated (una variable de un espectador que escribe otra herramienta, como el firstInChat de Chat First).
• Las integraciones se reconocen por el nombre. Una donación de Ko-fi solo trae un nombre: cuenta para el espectador con ese nombre en cada plataforma donde Streamer.Bot lo conoce (tiene una variable de usuario allí). El campo que lleva el nombre se ajusta en la página Ajustes, bajo la fila de la integración.
• Los logros son grupos de usuarios. Cuando un espectador provoca un logro, entra en su Grupo de Streamer.bot, salta el disparador personalizado New Achievement Unlocked (si está activado) y su Mensaje en el chat se publica en su chat — una sola vez: un espectador que ya está en el grupo no recibe nada.
• Las fotos y las insignias vienen del chat. Con las primeras palabras de cada espectador, su foto de perfil y sus insignias del chat se guardan en sus variables profilePic y userBadges, para su tarjeta.
• Las cuenta el overlay que ejecuta las acciones, mientras el conteo está activo.Empezar a contar y Dejar de contar, a mano o por disparador, lo controlan (streamUi.off.viewercards en Streamer.Bot). Por defecto, empieza y termina con tu stream de Twitch. Las fotos se guardan siempre.
• Todo el mundo cuenta, salvo tus usuarios ignorados: no tienen puntuación, ni logros, ni tarjeta.

La página

• Ajustes, Estilo y Controles, las pestañas sobre el editor.
• En la pestaña Ajustes, la columna Ajustes lista Modos de visualización, Card options, Secciones de la tarjeta, Puntuaciones y Logros. Modos de visualización abre sus tres modos en una columna propia; las tres últimas abren sus plataformas en una columna propia, y después la lista de la plataforma al lado.
• Vista previa del widget junto al borde derecho de la ventana: la vista previa (la tarjeta del espectador de prueba), los botones de prueba y la URL propia del widget. 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.

Cómo configurarlo

Ajustes

Modos de visualización

Tres formas de mostrar las tarjetas, cada una activada con el interruptor de su fila, con su propia lista de disparadores Mostrar y su botón Mostrar en la pestaña Controles. Todas se muestran en el mismo sitio del widget, así que basta con una fuente de navegador: un nuevo Mostrar sustituye las tarjetas en pantalla, y Ocultar las tarjetas oculta lo que se esté mostrando. Solo Una tarjeta está activado por defecto. Sin Stream Scores Licence, un modo cada vez: desactívalo antes de activar otro.

En bucle desactivado: se oculta tras una pasada.

Ajustes de la tarjeta

Qué tarjetas se muestran, y luego las tres partes de la tarjeta, de arriba abajo. Todos los interruptores menos el primero están activados por defecto.

• Espectadores: Solo suscriptores y miembros (desactivado): solo las tarjetas de suscriptores y miembros.
• Encabezado: Mostrar el icono de plataforma, Mostrar el nivel de suscripción (niveles de Twitch I, II, III) y Mostrar las insignias del chat.
• Cuerpo: Disposición de las secciones, las secciones de una tarjeta Horizontal (una al lado de otra, por defecto) o Vertical (una debajo de otra).
• Pie de la tarjeta: Mostrar las insignias de logros, Mostrar el nombre del canal (el nombre y la foto de tu canal, las palabras Viewer card) y Mostrar la fecha.

Secciones de la tarjeta

Una fila por plataforma, su Lista de secciones: los bloques de sus tarjetas, en orden.

Puntuaciones

Una fila por plataforma, su Lista de puntuaciones. La Puntuación elegida:

Disparadores contados, junto a la puntuación, cada uno con su Incremento de la puntuación: Sumar 1, Sumar el valor de una variable o Fijar el valor de una variable (con Only replace if the new value is higher than the current value para guardar el más alto). Con Dos valores independientes, un selector debajo de Añadir disparador elige Variable 1 o Variable 2. Un disparador User Global Variable Updated que vigila la propia variable de la puntuación se ignora, y la página lo avisa.

El menú de una puntuación también tiene Copiar a YouTube (u otra plataforma).

Logros

Una fila por plataforma, cada una con su Lista de logros. Un logro que se consigue con un comando o una integración va en la lista de cada plataforma donde cuenta.

Desbloqueado por, al lado: sus disparadores, con una condición opcional — un resub de 12 meses, global.newValue ≥ 10… → Disparadores y condiciones.

New Achievement Unlocked

Cada vez que un espectador desbloquea un logro con Disparador personalizado al desbloquear activado, el widget también lanza un disparador personalizado en Streamer.Bot, en el mismo momento que el mensaje de chat del logro. Úsalo para celebrarlo a tu manera: reproducir un sonido, mostrar una alerta, regalar puntos de canal…

Lo envía el overlay que ejecuta las acciones, mientras el conteo está activado. Lo añade la acción Stream UI - Backend: después de volver a importar las acciones, reinicia Streamer.Bot para que aparezca el disparador.

Las acciones que tenías asociadas en el antiguo sitio Stream Scores siguen funcionando: el disparador y sus variables conservan sus nombres.

Estilo

Cada elemento sigue el estilo del overlay campo por campo: un campo que cambies pasa a ser del widget, con una flecha de restablecer al lado. Estilo para cambia el estilo de una plataforma por separado. Mira Apariencia.

Posición por defecto

Centro, ancho automático. → Pestaña Disposición del Editor de overlays

Eventos de Streamer.Bot que escucha

Controles

• La columna Controles: un Mostrar por cada modo de visualización activado (Mostrar una tarjeta, Mostrar todas las tarjetas por turnos, Mostrar todas las tarjetas en desplazamiento), y luego Ocultar las tarjetas, Empezar a contar y Dejar de contar, cada uno con su Lista de disparadores.
• La zona principal, y la ventana de controles: Empezar a contar / Dejar de contar (Tarjetas de espectadores: Contando o Parado), los mismos botones Mostrar (Mostrar una tarjeta muestra la tarjeta de tu propio canal) y Ocultar las tarjetas.

Tus propias acciones de Streamer.Bot también pueden mostrar y ocultar las tarjetas. Las listas de disparadores son lo más sencillo: añade un comando !tarjeta a Mostrar una tarjeta y mostrará la tarjeta de quien lo escriba. Los dos comandos de abajo hacen lo mismo desde cualquier acción, y le dejan elegir el modo de visualización y qué tarjeta se muestra. No necesitan ninguna acción del paquete.

viewerCardsShow

Muestra las tarjetas. Una tarjeta: la tarjeta del espectador que nombra el comando, o la de tu canal cuando no nombra a nadie. Todas las tarjetas por turnos o Grouped: la tarjeta de cada espectador activo, nombre a quien nombre. Un modo desactivado (o que no se puede usar sin la licencia) no muestra nada.

using System;
using Newtonsoft.Json;

public class CPHInline
{
    public bool Execute()
    {
        // The viewer who set the action off: their login, id and platform
        CPH.TryGetArg("userName", out string login);
        CPH.TryGetArg("userId", out string userId);
        CPH.TryGetArg("userType", out string platform);
        var command = new { @event = "viewerCardsShow", display = "single", user = login, userId, platform = platform?.ToLower() };
        CPH.WebsocketBroadcastJson(JsonConvert.SerializeObject(command));
        return true;
    }
}

Para mostrar la tarjeta de tu canal, sustituye las líneas de Execute() que hay encima de return true; por el comando solo: CPH.WebsocketBroadcastJson("{\"event\":\"viewerCardsShow\",\"display\":\"single\"}"); — o separate / grouped en su lugar para la tarjeta de cada espectador.

viewerCardsHide

Oculta las tarjetas. Los mismos pasos, con este código:

using System;

public class CPHInline
{
    public bool Execute()
    {
        CPH.WebsocketBroadcastJson("{\"event\":\"viewerCardsHide\"}");
        return true;
    }
}

Stream Scores Licence

Sin la licencia: un solo overlay muestra las tarjetas de espectadores, un solo modo de visualización está activado a la vez, y solo las 5 primeras puntuaciones de cada plataforma y los 5 primeros logros de la lista de cada plataforma cuentan y se muestran — en el orden de tu lista, así que reordenarla los elige. Los que pasan del límite siguen editables, marcados Not used without Stream Scores Licence (también los modos de visualización activados mientras tenías la licencia: solo se muestra el primero); nunca se borra nada, y todo vuelve con la licencia. Stream Scores Licence (4,99 € al mes o 99,99 € una vez, sin IVA) quita todos los límites y la publicidad → La pestaña Licencia. La fuente de navegador comprueba la clave por sí misma, desde su URL.