Controle do OBS com Social Stream Ninja

Controle o OBS diretamente pelo Event Flow — sem precisar do Streamer.bot. Este guia aborda configuração, todos os gatilhos e ações do OBS, exemplos práticos e os controles antigos de dock/fonte de navegador.

Português (Brasil)
EnglishEspañolPortuguês (Brasil)РусскийFrançaisDeutsch日本語简体中文繁體中文ItalianoPolski한국어УкраїнськаالعربيةTürkçeČeštinaไทย

1. Conecte Flow Actions ao OBS

OBS WebSocket v5 está integrado ao OBS 28 e posteriores. O Social Stream Ninja o usa para controle completo do OBS e eventos de mídia.

  1. No OBS, abra Ferramentas → Configurações do servidor WebSocket.
  2. Ative o servidor WebSocket. Mantenha a porta padrão 4455; defina uma senha se desejar.
  3. No Social Stream Ninja, abra a Flow Actions seção e defina a URL do OBS WebSocket e a senha opcional.
  4. Copie a URL de Flow Actions e mantenha-a aberta. Uma fonte de navegador do OBS é recomendada para ações de sobreposição/áudio.
  5. Use: Testador de OBS WebSocket para confirmar a conexão antes de montar um fluxo.
Exemplo de URL direta
https://socialstream.ninja/actions.html?session=YOUR_SESSION&obsws=ws://127.0.0.1:4455

Adicione &obspw=YOUR_PASSWORD somente quando o OBS exigir autenticação. Adicione &obsdebug=1 para mostrar um pequeno indicador de status da conexão durante o diagnóstico.
Mantenha a página Flow Actions em execução. É a ponte que recebe ações do Event Flow e envia solicitações OBS WebSocket. Se for uma fonte de navegador do OBS, desative Desligar fonte quando não estiver visível quando a fonte precisa continuar controlando o OBS enquanto está oculta.
Chat / evento da transmissão │ ▼ Social Stream Ninja Event Flow │ mesmo ID de sessão ▼ Página Flow Actions (actions.html) │ OBS WebSocket v5 · ws://127.0.0.1:4455 ▼ OBS Studio

Dois modos de conexão com OBS

ModoO que suportaRequisito
OBS WebSocket v5Todos os gatilhos e ações deste guia.OBS 28+, servidor WebSocket ativado, página Flow Actions aberta.
API de fonte de navegador do OBSAlternativa para trocar cenas, iniciar/parar transmissão, iniciar/parar gravação e salvar o buffer de replay.Flow Actions carregado dentro do OBS com nível de acesso avançado. Recursos de fonte, filtro, texto, volume, mídia, atualização e fim de mídia ainda exigem WebSocket.

2. Adicione nós do OBS a um fluxo

  1. Abra: Editor do Event Flow e crie ou edite um fluxo.
  2. Arraste um gatilho para a área de edição.
  3. Expanda OBS Studio na lista de ações e arraste a ação do OBS necessária.
  4. Conecte o gatilho à ação, configure os nomes exatos de cenas/fontes do OBS, salve e ative o fluxo.
Lista de ações do OBS Studio no editor do Event Flow do Social Stream Ninja
O grupo OBS Studio contém controles de cena, fonte, texto, mídia, áudio, filtro, saída e buffer de replay.
Os nomes do OBS devem corresponder exatamente, incluindo espaços e pontuação. Ações de fonte usam o nome da entrada no OBS, não o rótulo do item de cena caso tenha sido renomeado separadamente.

3. Gatilhos do OBS

Eles iniciam um fluxo quando o OBS informa um evento correspondente. Chegam como type: "obs"; os detalhes específicos do OBS estão em meta.

AcionadorQuando acionaDados úteis
Transmissão do OBS iniciadaA transmissão chega ao estado iniciado.meta.outputState, meta.outputActive
Transmissão do OBS paradaA transmissão chega ao estado parado.meta.outputState, meta.outputActive
Gravação do OBS iniciadaA gravação começa.meta.outputState
Gravação do OBS paradaA gravação para.meta.outputState
Cena do OBS alteradaA cena ativa de programa muda.meta.sceneName
Mídia do OBS encerrada WebSocketUma entrada de mídia termina de reproduzir. Opcionalmente, filtre pelo nome exato da fonte de mídia.meta.inputName, meta.inputUuid
Buffer de replay do OBS salvoO OBS termina de salvar um replay.meta.savedReplayPath

4. Ações do OBS

AçãoConfiguração e comportamentoConexão
Trocar cenaTroca a cena ativa de programa pelo nome exato da cena.WebSocket ou alternativa pela API de fonte de navegador
Alternar fonteMostrar, ocultar ou alternar um item de cena. Cena e Grupo são campos opcionais de destino.WebSocket
Definir fonte de textoAtualiza Texto (GDI+) ou Texto (FreeType 2), com placeholders de modelo.WebSocket
Controlar fonte de mídiaReproduzir/retomar, pausar, reiniciar, parar, próximo ou anterior.WebSocket
Definir volume da fonteDefine uma entrada de -100 como +26 dB.WebSocket
Atualizar fonte de navegadorRecarrega uma fonte de navegador sem cache.WebSocket
Alternar filtroAtivar, desativar ou alternar um filtro de fonte pelo nome.WebSocket
Silenciar/ativar áudioSilenciar, ativar o som ou alternar uma entrada.WebSocket
Iniciar gravaçãoInicia a gravação do OBS.WebSocket ou alternativa pela API de fonte de navegador
Parar gravaçãoPara a gravação do OBS.WebSocket ou alternativa pela API de fonte de navegador
Iniciar transmissãoInicia a saída de transmissão configurada no OBS.WebSocket ou alternativa pela API de fonte de navegador
Parar transmissãoPara a saída de transmissão do OBS.WebSocket ou alternativa pela API de fonte de navegador
Controlar buffer de replayIniciar, parar ou alternar o buffer de replay.WebSocket
Salvar buffer de replaySalva o buffer de replay atualmente em execução.WebSocket ou alternativa pela API de fonte de navegador

Definir fonte de texto e variáveis do fluxo

O campo de texto aceita placeholders normais de mensagem, como {username}, {message}, {source}, e {donation}, além de valores adicionados por nós anteriores do fluxo, como {counterValue}, {counterTarget}, e {counterRemaining}.

{username}: now {counterValue}, need {counterTarget}
Propriedades de Definir fonte de texto com variáveis de modelo de contador
Definir fonte de texto grava o valor resolvido diretamente na entrada de texto do OBS com o nome informado.
Para uma fonte Texto (GDI+) ou Texto (FreeType 2), desative Ler de arquivo. Caso contrário, o OBS pode continuar exibindo o conteúdo do arquivo em vez do texto enviado pelo Event Flow.

Controles de fonte de mídia

Reproduzir / Pausar

Reproduzir retoma mídia pausada. Pausar mantém a posição atual.

Reiniciar / Parar

Reiniciar começa do início. Parar encerra a reprodução e redefine a entrada.

Próximo / Anterior

Navega por entradas com suporte a playlists, como Fonte de vídeo VLC. Uma fonte de mídia de arquivo único pode ignorar essas ações.

Volume, mudo e filtros

Definir volume da fonte usa dB, correspondendo à escala do mixer do OBS: 0 dB é ganho sem alteração, valores negativos são mais baixos e -100 dB é efetivamente silêncio. Mudo é um estado separado. Alternar filtro muda apenas o estado ativado de um filtro existente; não edita as configurações dele.

Buffer de replay

Primeiro, ative o buffer de replay em Configurações do OBS → Saída. Use Controlar buffer de replay para iniciar/parar e depois Salvar buffer de replay para gravar no disco o segmento recente armazenado no buffer.

Aviso sobre saída ao vivo: Iniciar/Parar transmissão e Iniciar/Parar gravação atuam imediatamente. Use gatilhos restritos, permissões e intervalos para que mensagens normais do chat não os acionem por acidente.

5. Exemplos úteis

Mensagem a cada hora enquanto o OBS está ao vivo

No editor do Event Flow, escolha Começar com um modelo → Intermediário → Mensagem a cada hora enquanto o OBS está ao vivo. Começa desativado e contém três ramificações em um único fluxo:

  • Transmissão do OBS iniciada → Definir estado da porta: ON
  • Intervalo de tempo (3600 segundos) → Interruptor ON/OFF → Enviar mensagem
  • Transmissão do OBS parada → Definir estado da porta: OFF

As duas ações Definir estado da porta já apontam para o mesmo interruptor, que começa em OFF. Edite Enviar mensagem para escolher a plataforma de chat (o exemplo usa Twitch) e a mensagem. Escolha uma plataforma ou Todas as plataformas; Responder à fonte não pode responder a um evento do OBS nem a um pulso do temporizador.

Conectar Flow Actions ao OBS, mantenha o Social Stream e o chat de destino conectados, salve e ative o fluxo antes de iniciar sua transmissão. O interruptor aguarda um evento de início do OBS; carregá-lo durante uma transmissão já em andamento não o liga. Reiniciar o Social Stream também redefine o interruptor para OFF.

Temporização: o intervalo segue seu próprio agendamento, então o primeiro lembrete pode chegar antes de uma hora após o início da transmissão. Os seguintes se repetem a cada hora enquanto o interruptor estiver em ON. Altere o valor de Intervalo de tempo para outra frequência; ele é medido em segundos.

Texto de contador no OBS

Coloque Definir fonte de texto após o caminho do contador/verificação e use:

{username}: now {counterValue}, need {counterTarget}

Executar algo após um vídeo

Mídia do OBS encerrada (filtre por Intro Video) → Trocar cena como Main.

Reinício de mídia controlado pelo chat

Mensagem igual a !replayintro → condição de permissão → Controlar fonte de mídia: reiniciar.

Atualizar uma página de alerta

Mensagem igual a !refreshalerts → condição de moderador → Atualizar fonte de navegador.

Abaixar a música durante um alerta

Definir volume da fonte como -24 dB → ação de alerta → Atraso → restaurar para 0 dB.

Fluxo de replay

Transmissão do OBS iniciada → Controlar buffer de replay: iniciar; um comando confiável separado executa Salvar buffer de replay.

6. Outros controles integrados do OBS

O Social Stream Ninja também tem controles antigos de fonte de navegador do OBS no dock de chat da transmissão. Eles não usam a ponte WebSocket de Flow Actions.

OpçãoO que fazRequisito
Indicador da cena atual do OBSMostra a cena ativa no dock de chat da transmissão.Dock carregado dentro do OBS com permissão de leitura.
Convidados podem usar !cycleAvança para a próxima cena do OBS, limitado a uma vez a cada 10 segundos.Ative a opção do popup; dock carregado dentro do OBS com acesso avançado.
Usuários privilegiados podem usar !start / !stopInicia ou para a transmissão a partir de usuários confiáveis do chat.Ative a opção do popup; dock carregado dentro do OBS com permissão de controle completo/avançado.
Painel remoto de controle do OBSExibe cenas e pode trocar cenas ou alternar transmissão/gravação quando o dock de destino no OBS concede o nível de controle necessário.Dock de chat da transmissão pareado com um dock executado dentro do OBS.
Testador de OBS WebSocketVerifica versão, conexão, cenas e solicitações individuais antes de usar o Event Flow.Abrir testador

7. Solução de problemas

ProblemaVerifique
Nada aconteceO fluxo está salvo e ativado; Flow Actions está aberto; ambos usam o mesmo ID de sessão.
O OBS não conectaO servidor WebSocket está ativado, a URL é ws://127.0.0.1:4455, e a senha corresponda. A porta 4444 é o padrão obsoleto da v4.
Cena/fonte/filtro não encontradoCopie o nome exato do OBS. Para visibilidade, defina Cena ou Grupo quando o item estiver aninhado ou fora da cena atual.
O texto não mudaUse Texto (GDI+) ou Texto (FreeType 2), confirme o nome da entrada e desative Ler de arquivo.
Fim de mídia nunca é acionadoUse OBS WebSocket v5 e uma entrada de mídia real. Mídia em loop não chega ao estado encerrado.
Próximo/Anterior não faz nadaUse uma fonte com suporte a playlist, como Fonte de vídeo VLC.
Falha ao salvar replayAtive o buffer de replay nas configurações de saída do OBS e inicie-o antes de salvar.
Ações param quando uma cena mudaDesative Desligar fonte quando não estiver visível na fonte de navegador de Flow Actions ou mantenha a página aberta em outro lugar.
Ordem do diagnóstico: abra o testador → confirmar GetVersion → confirmar cenas/entradas → testar a solicitação individual → testar o Event Flow completo.