Overlays dinâmicos para OBS com variáveis e Google Sheets
Placar, meta de doações, nomes de times ou a próxima partida: valores assim mudam durante a live. Guarde esses valores em variáveis e todo overlay que usa elas se atualiza sozinho.
É preciso ter uma conta no Vision. Você monta o overlay no editor. · Atualizado em
Como funciona
O que você precisa para um overlay dinâmico
Abra um overlay no Vision e escolha Overlay → Variables. Crie uma variável e escolha de onde vem o valor: definido à mão, um contador, stats da Twitch ou da Kick, Google Sheets, uma API ou um webhook. Insira a variável numa camada de texto, ligue a visibilidade de uma camada a ela e mude o valor pelo chat, por uma automação ou pelo Stream Deck. A fonte de navegador no OBS se atualiza sem recarregar.
- Um overlay do Vision adicionado ao OBS como fonte de navegador
- O plano Basic ou superior para variáveis
- O plano Pro para Google Sheets, APIs HTTP e webhooks
Passo a passo
Monte um overlay de meta de doações com Google Sheets
Abra as variáveis
Abra seu overlay no editor do Vision e escolha Overlay → Variables. Clique em New e, em Pick a source, escolha Google Sheets.
Conecte a planilha
Clique em Connect Google e permita acesso somente leitura. Cole a URL da planilha e defina o intervalo na célula com o seu total, por exemplo Sheet1!B2. Dê o nome Donation total à variável, use a chave donations e o tipo de valor number. Clique em Test now para ver o valor atual.
Adicione a meta e uma porcentagem
Crie uma segunda variável com a fonte Manual, a chave goal e o valor 1000. Depois crie uma terceira com a fonte Expression e digite ({donations} / {goal}) * 100. Ela sempre guarda a porcentagem atual.
Mostre os valores no seu overlay
Selecione uma camada de texto e clique em Insert Variable na barra de controle dela. Escolha donations e escreva o texto em volta, por exemplo € arrecadados. O chip mostra o valor ao vivo no editor e no OBS. Ligue os pontos de uma camada de placar à porcentagem se quiser um número que vai subindo.
Mostre um banner quando a meta for batida
Adicione uma camada de texto que diga Meta batida. Na lista de camadas, clique no botão de vínculo de visibilidade dela, escolha Add condition e defina donations is at least. Mude para Compare to another variable e escolha goal. A prévia mostra se a camada está visível agora.
De onde uma variável tira o valor
Toda variável tem uma fonte. Valores Manual são definidos à mão, Counters sobem e descem em passos. Time / Clock mostra a hora, o tempo de live, uma contagem regressiva ou o tempo desde uma data. Channel stats oferece 40 valores da Twitch e da Kick, como último follower, maior doador ou subs desta live. Vision Companion traz batimentos, velocidade e dados de saúde do app para celular, e Logo Rotation acompanha uma rotação em andamento.
Essas fontes vêm com o Basic. O Pro adiciona Google Sheets, HTTP API e Webhook, dados de quizzes e torneios, e placares de futebol ao vivo com atraso de stream, para o overlay não dar spoiler de um gol antes dos seus viewers verem.
Cada variável é local a um overlay ou fica disponível em todos os seus overlays. Escolha isso em Scope ao criar a variável; não dá para mudar depois.
Conecte Google Sheets, APIs e webhooks
O Google Sheets lê uma célula por variável, com acesso somente leitura à sua conta do Google. Use uma variável para cada célula que quiser mostrar. O Vision verifica a célula a cada 15 segundos, no mínimo.
A HTTP API consulta uma URL com GET ou POST a cada 5 segundos, no mínimo. Pegue um valor de dentro de um JSON com um caminho como data.items[0].value e adicione um bearer token, basic auth ou seus próprios headers. As requisições rodam nos servidores do Vision, então os tokens nunca chegam à fonte de navegador.
O Webhook dá à variável uma URL privada. Mande JSON ou texto para ela de qualquer ferramenta, script ou serviço e o valor muda na hora. O editor mostra um exemplo de curl pronto para testar.
Faça as camadas reagirem aos valores
Camadas de texto mostram variáveis como chips. Camadas de placar podem pegar os pontos de uma variável, e camadas de contagem regressiva, o horário de início ou de fim.
Qualquer camada pode ligar sua visibilidade a regras. Combine regras com ALL ou ANY, verifique números, texto, expressões regulares ou datas, e compare com um valor fixo ou com outra variável. Esconda o espaço de um patrocinador enquanto o valor estiver vazio ou mostre uma camada só em dia de jogo.
Variáveis Expression calculam um valor a partir de outras com aritmética, comparações, condições escritas como ? : e funções como round, min, max e clamp. Elas recalculam sempre que uma das entradas muda.
Mude valores pelo chat, por automações e pelo Stream Deck
Variáveis Manual e Counter podem ser alteradas durante a live. No Chatbot, adicione uma ação Variable a um comando ou timer para definir, aumentar, diminuir ou zerar uma variável, na Twitch e na Kick. O valor fica fixo no comando.
As Automations, em beta no momento, podem começar quando uma variável muda e definir variáveis como etapa de um fluxo, por exemplo somando um a subs_today a cada novo sub. Um gatilho Chat command também repassa o que foi digitado depois do comando: defina uma variável como {{trigger.arg1}} e !score 5 muda o valor para 5.
O plugin do Vision para Stream Deck tem uma ação Variable para somar, subtrair, definir ou zerar. Atalhos de teclado para contadores funcionam enquanto o editor do overlay está aberto.
Solução de problemas
Se algo não funcionar
- Não aparece Variables no menu Overlay? Variáveis exigem o plano Basic ou superior.
- O valor da planilha não muda? Confira o intervalo e clique em Reload now. Se aparecer Last poll failed, verifique se a conta do Google conectada consegue abrir a planilha.
- Um comando de chat ou botão do Stream Deck não faz nada? Só variáveis Manual e Counter podem ser alteradas assim.
- Uma camada continua escondida? Abra as regras de visibilidade dela. A prévia mostra Waiting for values… até toda variável das regras ter um valor.
Perguntas frequentes
Overlays dinâmicos: perguntas frequentes
Preciso recarregar a fonte de navegador quando um valor muda?
Não. Os novos valores chegam ao overlay em tempo real. Relógios e expressões recalculam direto no overlay.
O Vision consegue escrever na minha planilha do Google?
Não. O Vision só lê, uma célula por variável, com acesso somente leitura à sua conta do Google.
Os viewers podem definir um valor pelo chat, tipo !score 5?
Sim, com uma automação. Adicione um gatilho Chat command para !score, limite aos mods se quiser e conecte uma ação Variable que define score como {{trigger.arg1}}. Comandos no próprio Chatbot só usam valores fixos.
O que acontece com minhas variáveis se eu mudar para um plano menor?
Seus overlays continuam mostrando as variáveis, mas no plano Free você não consegue mais editá-las.
