Disparadores
Cada disparador que un evento puede esperar, con sus campos propios, su procedencia y las variables que completa
Cada disparador del menú Tipo de evento en el editor de eventos, con los campos que añade, las plataformas que lo envían y las variables de plantilla que pueden utilizar sus pasos.
El menú lista primero lo que ocurre en directo y después los dos disparadores que coinciden con el texto que escribas: Disparador de API y Mensaje de chat. Para obtener ayuda al elegir uno, consulta Elegir un disparador.
Elige un tipo de evento y un tipo de paso. Los campos cambian según la selección, igual que en la app.
Actividad de los espectadores
| Disparador | Se activa cuando | Enviado por | Campos propios |
|---|---|---|---|
| Regalo | Llega un regalo o finaliza un combo | TikTok LIVE, Twitch, Kick, YouTube | Nombre del regalo, Catálogo, Coincidencia, Valor mínimo |
| Me gusta | Los espectadores tocan la pantalla | TikTok LIVE | Ninguno |
| Seguir | Alguien te sigue | TikTok LIVE, Twitch, Kick | Ninguno |
| Compartir | Alguien comparte el LIVE | TikTok LIVE | Ninguno |
| Mensaje de chat | Un mensaje coincide con tu texto | TikTok LIVE, Twitch, Kick, YouTube | Texto del disparador, modo de coincidencia, Sensible a mayúsculas, Coste en puntos por comando, Usar el primer argumento para el movimiento del modelo |
| Primer mensaje del directo | Primer mensaje de un espectador en el directo | TikTok LIVE, Twitch, Kick, YouTube | Ninguno |
| Espectador se une | Un espectador entra al LIVE | TikTok LIVE | Ninguno |
| Suscripción | Un espectador se suscribe, o un miembro de YouTube se une o alcanza un hito | TikTok LIVE, Twitch, Kick, YouTube | Ninguno |
| Super Fan | Un espectador se convierte en Super Fan | TikTok LIVE | Ninguno |
| Emoticono de suscriptor | Un suscriptor envía un emoticono | TikTok LIVE | Ninguno |
| Cofre del tesoro | Un espectador suelta un cofre del tesoro | TikTok LIVE | Ninguno |
| Pregunta del LIVE | Un espectador hace una pregunta en directo | TikTok LIVE | Ninguno |
| Raid Solo Twitch | Otro canal te hace una raid | Twitch | Ninguno |
| Puntos de canal de Twitch Solo Twitch | Un espectador canjea una recompensa de puntos de canal | Twitch | El menú de recompensas, Cualquier recompensa, Actualizar recompensas |
Espectador se une se activa una vez por espectador en un intervalo de 30 segundos, de forma que si alguien sale y vuelve a entrar no se active dos veces. Primer mensaje del directo recuerda hasta 50.000 espectadores por emisión.
Regalos de Twitch, Kick y YouTube
Las compras en Twitch, Kick y YouTube llegan al disparador Regalo como regalos con un valor en diamantes configurado en AjustesPuntosValor de los eventos. Escribe estos nombres en Nombre del regalo para reaccionar a uno concreto:
| Nombre del regalo | Qué representa |
|---|---|
Cheer | Bits de Twitch |
Gift Sub | Suscripciones regaladas en Twitch o Kick, o membresías de YouTube regaladas |
Kicks | Moneda propia de regalos de Kick |
Super Chat | Un Super Chat de YouTube, que vale su importe en diamantes |
Super Sticker | Un Super Sticker de YouTube, que vale su importe en diamantes |
| El nombre del propio regalo | Un regalo con Joyas de YouTube, que no vale diamantes |
| El título de la recompensa | Un canje de puntos de canal de Twitch o una recompensa de Kick |
El mensaje enviado con un cheer, un regalo de Kicks o un Super Chat rellena {comment}. El
mensaje de un Super Chat también llega como mensaje de chat, después del regalo.
Puntos de canal de Twitch y membresías de YouTube
Puntos de canal de Twitch reconoce una recompensa por su ID, así que sigue funcionando aunque le cambies el nombre en Twitch. Cualquier recompensa coincide con todos los canjes, y un canje que Twitch notifica dos veces se ejecuta una sola vez. El menú muestra tus recompensas personalizadas con su coste en puntos mientras Twitch está conectado y con la sesión iniciada como propietario del canal.
En YouTube, un nuevo miembro y un hito de membresía activan Suscripción, igual que cada espectador que recibe una membresía regalada. Un miembro del canal cuenta como suscriptor en Quién puede activarlo.
Momentos e hitos de la transmisión
| Disparador | Se activa cuando | Campos propios |
|---|---|---|
| Empieza el directo | Comienza un nuevo LIVE en cualquier plataforma, o un directo programado de YouTube al que te uniste antes empieza a emitirse | Ninguno |
| Termina el directo | El LIVE finaliza. En YouTube, en menos de un minuto | Ninguno |
| Hito de «me gusta» de la sala | El total de «me gusta» supera el umbral | Umbral, Repetir en cada múltiplo |
| Hito de recuento de espectadores | Los espectadores superan el umbral | Umbral, Repetir en cada múltiplo |
| Hito de seguidores | Tu recuento de seguidores supera el umbral | Umbral, Repetir en cada múltiplo |
| Batalla | Una batalla de TikTok inicia, se actualiza o finaliza | Fase de la batalla, Resultado de la batalla (opcional) |
| Meta de TikTok LIVE | Tu meta de TikTok LIVE cambia | Solo al alcanzar la meta del LIVE |
| Tren del hype Solo Twitch | Comienza o finaliza un tren del hype | Fase de la batalla: begin o end |
| Cada pocos minutos | Su cuenta regresiva finaliza | Ejecutar cada, Extra aleatorio, Solo mientras esté en directo |
Umbral comienza en 100 y acepta cualquier número entero a partir de 1. Un hito lee el estado de la sala una vez al unirte y cuenta a partir de ahí, por lo que entrar a un directo en marcha no reactiva hitos ya superados. Sin Repetir en cada múltiplo, se dispara una sola vez por transmisión. Hito de «me gusta» de la sala lee el total de TikTok, por lo que permanece inactivo en Twitch, Kick y YouTube.
Fase de la batalla ofrece start, progress y end. Resultado de la batalla
(opcional) ofrece Ninguno, win, lose y draw.
Raid, Tren del hype y Puntos de canal de Twitch aparecen en el menú una vez que Twitch se ha conectado al menos una vez.
Cada pocos minutos
| Campo | Rango | Predeterminado |
|---|---|---|
| Ejecutar cada | 1–240 minutos, con Accesos rápidos de 5, 10, 15, 30 y 60 | 10 minutos |
| Extra aleatorio | 0 hasta el propio intervalo, en minutos | 0 |
| Solo mientras esté en directo | Activado o desactivado | Activado |
La primera ejecución ocurre tras transcurrir un intervalo completo desde que inicia la cuenta, nunca de inmediato. Una ejecución que coincida con Vfinity en pausa se omite, y una acción de pánico reinicia todas las cuentas atrás.
Juegos y widgets de overlay
Estos disparadores se activan cuando un widget en la pestaña Overlay produce un resultado.
| Disparador | Se activa cuando | El campo clave filtra por |
|---|---|---|
| Meta de overlay alcanzada | Un widget de meta alcanza su objetivo | El ID del widget de meta, como goal1 |
| El temporizador llega a cero | La cuenta atrás llega a cero o el cronómetro alcanza su objetivo | Déjalo vacío |
| Resultado de la ruleta | La ruleta de la fortuna se detiene | El ID de resultado de una opción |
| Ganador del sorteo | El rodillo del sorteo se detiene en un ganador | Sin campo clave |
| Victoria en tira y afloja | Una ronda de tira y afloja termina con un ganador | 1, 2 o el nombre del equipo |
| Nivel de hype alcanzado | El medidor de hype sube a un nivel | Un número de nivel (1–5) o su nombre |
El campo clave es ID de widget o clave de resultado (vacío coincide con todos). Los nombres de equipo y de nivel coinciden sin distinguir mayúsculas de minúsculas. El medidor de hype debe descender un 10% por debajo de un nivel antes de que dicho nivel pueda activarse nuevamente.
Texto que escribes
| Disparador | Campo | Coincide con |
|---|---|---|
| Disparador de API | Nombre del disparador | El valor de name enviado a la API local o a la API de disparadores, ignorando mayúsculas |
| Mensaje de chat | Texto del disparador | Un mensaje de chat, según el modo de coincidencia inferior |
Modos de coincidencia de chat
| Modo | Un mensaje coincide cuando |
|---|---|
| Contiene (predeterminado) | El texto aparece en cualquier parte del mensaje |
| Exacto | Coincide exactamente con el texto |
| Empieza con | Comienza con el texto |
| Comando y argumentos | Comienza con el comando (como !spin); las palabras posteriores se convierten en argumentos |
| Expresión regular restringida | Coincide con el patrón; las capturas se convierten en argumentos |
Marca Sensible a mayúsculas para distinguir mayúsculas de minúsculas. Una expresión regular puede utilizar anclas, clases de caracteres, capturas y repeticiones fijas de hasta 32.
Coste en puntos por comando admite entre 0 y 1.000.000 de puntos. Un espectador sin suficientes puntos no activará el evento, y los puntos se reembolsan si la ejecución en cola se descarta antes de comenzar.
Usar el primer argumento para el movimiento del modelo traslada el primer argumento a cada
paso de Mover modelo: Rotación (°), Tamaño, Posición X o Posición Y. Si un espectador
escribe !spin 90, el modelo girará 90°. Un valor que no sea numérico detiene el evento y no deduce puntos.
Campos compartidos por todos los disparadores
Se encuentran en Ajustes avanzados dentro del editor de eventos.
| Campo | Se aplica a | Rango u opciones |
|---|---|---|
| Mínimo de regalos, Mínimo de me gusta o Recuento mínimo | Todos los disparadores excepto hitos y Cada pocos minutos | 0 o más |
| Retardo (ms) | Todos los disparadores | 0 o más, antes de toda la lista de acciones |
| Modo de recuento | Todos los disparadores excepto Cada pocos minutos | Recuento por espectador o Recuento de todos los espectadores |
| Activar límite de frecuencia | Todos los disparadores | Disparadores máx. en Ventana de tiempo (segundos); 5 en 60 al activarse por primera vez |
| Comportamiento por cantidad | Regalo | Una vez por evento de regalo, Repetir la acción xN, Ampliar la duración xN |
| Recuento | Regalo con Recuento de todos los espectadores | Regalos o Diamantes |
| Como máximo (◆) | Regalo | 1–1.000.000 de diamantes, o Sin límite |
| Valor de | Regalo | Todo el combo (regalo × cantidad) o Un solo regalo |
Con Recuento establecido en Diamantes, el evento se activa cada vez que los diamantes acumulados de todos superan Diamantes a recolectar, como máximo 20 veces por combo.
Ajustes, debajo de los pasos, contiene las reglas: Quién puede activarlo, Tiempo de recarga y Cola de acciones. Reglas y tiempos de recarga explica su funcionamiento.
| Regla | Rango | Predeterminado |
|---|---|---|
| Quién puede activarlo | Seguidores, Amigos, Suscriptores, Super Fans, Moderadores, Miembros del club de fans, Mayores donantes | Todos |
| Cuántos donantes principales | 1–100 | 3 |
| Siempre permitidos, Nunca permitidos | Hasta 200 nombres cada uno | Vacío |
| Por espectador (segundos), Para todos (segundos) | 0–86.400 | 0 |
| Durante el tiempo de recarga | Ignorar el disparador o Ejecutarlo al terminar la espera | Ignorar el disparador |
| Carril de cola (el mismo nombre se ejecuta en orden) | Hasta 64 caracteres | default |
| Prioridad de cola (más alto se ejecuta primero) | −1000 a 1000 | 0 |
| Descartar ejecuciones en cola tras segundos | 1–3600 | 120 |
Variables que completa cada disparador
Cada disparador que identifique a un espectador completa {name}, {nickname}, {uniqueId} y
{points}, y todos los disparadores completan {trigger}. Los siguientes añaden sus variables específicas:
| Disparador | Añade |
|---|---|
| Regalo | {gift}, {count}, {diamonds}, {totalDiamonds} y {comment} cuando el regalo llega con un mensaje |
| Puntos de canal de Twitch | {rewardName}, {rewardCost}, {rewardId}, {redemptionId} y {comment} en una recompensa que pide texto |
| Me gusta | {count}, {likes}, {totalLikes} |
| Mensaje de chat | {comment}, {args}, {arg1} a {arg9} |
| Primer mensaje del directo | {comment} |
| Suscripción | {months} |
| Raid | {viewers} |
| Cofre del tesoro | {coins} |
| Emoticono de suscriptor | {emoteUrl} |
| Pregunta del LIVE | {questionText} |
| Tren del hype | {phase}, {level}, {total} |
| Hito de «me gusta» de la sala | {totalLikes} |
| Hito de recuento de espectadores | {viewers} |
| Hito de seguidores | {followers} |
| Meta de overlay alcanzada | {value}, {target}, {cycle} |
| Resultado de la ruleta | {result} |
| Ganador del sorteo | {winner}, {tickets}, {entrants} |
| Victoria en tira y afloja | {team}, {score}, {otherScore} |
| Nivel de hype alcanzado | {level}, {levelName} |
| Disparador de API | Cada campo de texto, número o booleano de primer nivel en data |
Variables de plantilla describe el contenido de cada una.