Variables de plantilla
Cada variable que puedes incluir en el texto de un paso, qué contiene y qué disparadores la completan
Escribe una variable entre llaves, como {name}, y Vfinity la completará cuando el
paso se ejecute: "¡Gracias {name} por el {gift}!" se convierte en "¡Gracias Mika
por la Rosa!".
Variables compartidas por los disparadores
| Variable | Contiene | Completada por |
|---|---|---|
{name} | El nombre visible del espectador o su @handle cuando no tiene ninguno | Cualquier disparador que identifique a un espectador |
{nickname} | El nombre visible del espectador | Cualquier disparador que identifique a un espectador |
{uniqueId} | El @handle del espectador, sin el @ | Cualquier disparador que identifique a un espectador |
{points} | El saldo de puntos del espectador, tras descontar el coste en puntos | Cualquier disparador que identifique a un espectador |
{trigger} | El nombre del disparador de API o el tipo del disparador (como gift o chat) | Todos los disparadores |
{gift} | El nombre del regalo | Regalo |
{count} | La cantidad del combo para un regalo, o el número de «me gusta» | Regalo, Me gusta |
{diamonds} | El valor de un solo regalo | Regalo |
{totalDiamonds} | El valor de todo el combo: diamantes × cantidad | Regalo |
{likes} | Los «me gusta» de este evento individual | Me gusta |
{totalLikes} | El total acumulado de «me gusta» de la sala | Me gusta, Hito de «me gusta» de la sala |
{comment} | El mensaje del chat, o el mensaje que acompaña a un regalo o a una recompensa | Mensaje de chat, Primer mensaje del directo, Regalo, Puntos de canal de Twitch |
{args} | Todo el texto tras el comando como un único bloque | Mensaje de chat |
{arg1} a {arg9} | De la primera a la novena palabra tras el comando, o las capturas de una expresión regular | Mensaje de chat |
El saldo de puntos de un espectador es independiente por plataforma, por lo que el mismo nombre en TikTok LIVE y en Twitch mantiene dos saldos separados.
Variables de disparadores específicos
| Variable | Contiene | Disparador |
|---|---|---|
{months} | Meses de suscripción, o meses como miembro de YouTube | Suscripción |
{rewardName}, {rewardCost} | El título de la recompensa y lo que costó en puntos de canal | Puntos de canal de Twitch |
{rewardId}, {redemptionId} | El ID de Twitch de la recompensa y el de este canje concreto | Puntos de canal de Twitch |
{viewers} | Espectadores que acompañaron en la raid o espectadores en la sala | Raid, Hito de recuento de espectadores |
{followers} | Tu número de seguidores | Hito de seguidores |
{coins} | Las monedas que el emisor introdujo en el cofre del tesoro | Cofre del tesoro |
{emoteUrl} | La dirección de la imagen del primer emoticono | Emoticono de suscriptor |
{questionText} | El texto de la pregunta | Pregunta del LIVE |
{phase}, {level}, {total} | Fase, nivel y total del tren del hype | Tren del hype |
{value}, {target}, {cycle} | Estado actual de la meta, su objetivo y en qué ronda se encuentra una meta repetitiva | Meta de overlay alcanzada |
{result} | La opción donde se detuvo la ruleta | Resultado de la ruleta |
{winner}, {tickets}, {entrants} | Nombre del ganador, sus boletos y cuántos participaron | Ganador del sorteo |
{team}, {score}, {otherScore} | El equipo ganador, su puntuación y la del otro equipo | Victoria en tira y afloja |
{level}, {levelName} | El nivel alcanzado, como número y por su nombre | Nivel de hype alcanzado |
Ganador del sorteo también identifica al ganador como espectador, de modo que {name}
también funciona en ese caso. En un Regalo, {comment} contiene el mensaje enviado
con un cheer de Twitch, un regalo de Kicks o un Super Chat de YouTube, o el texto que un
espectador escribió para una recompensa.
Campos del disparador de API
Un Disparador de API convierte cada campo de primer nivel de los datos (data) recibidos
en una variable, siempre que el campo contenga texto, un número o un valor booleano. Se
admiten hasta 50 campos, y los objetos anidados se ignoran. Si se envía {"name":"raid_alert","data":{"user":"Mika"}},
un paso puede utilizar {user}.
Batalla, Meta de TikTok LIVE, Pregunta del LIVE y Super Fan exponen los
campos de primer nivel propios de TikTok del mismo modo, como {outcome} en una batalla, o
{description} y {progress} en una meta de LIVE.
Dónde puedes utilizarlas
| Paso o ubicación | Campo | Cómo se incorporan los valores |
|---|---|---|
| Pronunciar texto | Texto a pronunciar | Como texto hablado, tras pasar los filtros de moderación de TTS |
| Controlar OBS, Escribir en una fuente de texto | Texto | Como texto sin formato |
| Webhook HTTP | URL / ID de acción | Con codificación porcentual (URL-encoded), únicamente en la ruta y la consulta |
| Webhook HTTP | Cuerpo JSON / argumentos | Dentro de los valores de texto del JSON |
| Acción de Streamer.bot | Cuerpo JSON / argumentos | Dentro de los valores de texto del JSON |
| Comando de la app | Valor o Valor (JSON) | Dentro de los valores de texto |
Un webhook se envía siempre al host especificado: una variable puede alterar la ruta y los parámetros de consulta, pero nunca el servidor de destino. En JSON, solo se completan los valores de texto, evitando que el mensaje de un espectador añada campos o altere la estructura.
Cómo se completan los valores
- Una variable sin datos que la respalden (como
{gift}en un evento de seguimiento) se sustituye por una cadena vacía. - Un nombre desconocido para Vfinity (como
{banana}) permanece exactamente como se escribió. - En texto hablado y texto sin formato, los saltos de línea se convierten en espacios y se eliminan los caracteres de control. Cada valor se corta a un máximo de 500 caracteres.
- La sustitución se realiza una sola vez. Si un espectador se llama literalmente
{name}, se mostrará{name}y nunca se sustituirá una segunda vez. - Los nombres distinguen mayúsculas de minúsculas:
{Name}no equivale a{name}.
Texto de las alertas
Las tarjetas de alertas disponen de sus propios marcadores para el Mensaje personalizado, obtenidos directamente de la alerta y no de un evento.
| Marcador | Contiene |
|---|---|
{name} | El emisor, resaltado en el color de acento |
{gift}, {count} | El regalo y su cantidad |
{diamonds}, {totalDiamonds} | El valor de un regalo y el del combo completo |
{likes}, {totalLikes} | El hito de «me gusta» alcanzado y el total de la sala |
{months} | Meses de suscripción, en una alerta de suscripción |
{viewers} | Espectadores acompañantes, en una alerta de raid |
Un marcador sin datos asociados en una alerta se muestra como 0 o vacío. El texto a voz lee exactamente el mismo texto que muestra la tarjeta.
