OBS Studio

A integração OBS Studio conecta o Macro Deck ao OBS pelo servidor WebSocket que vem embutido no OBS (obs-websocket 5). Depois de conectado, os botões podem controlar quase tudo o que você faz no OBS durante uma live, e o OBS informa de volta o que muda, então o deck sempre mostra o estado atual.

O que dá para fazer

• Troque a cena do programa, a cena de pré-visualização do modo estúdio, o perfil ou a coleção de cenas.
• Inicie, pare ou alterne a transmissão, a gravação, o buffer de repetição e a câmera virtual, salve um replay, pause uma gravação, divida o arquivo de gravação ou adicione um marcador de capítulo.
• Mostre ou oculte uma fonte em uma cena, ative ou desative um filtro, silencie uma entrada ou mude o volume dela em porcentagem ou em dB.
• Mude uma configuração de uma fonte, por exemplo o texto de uma fonte de texto, o arquivo de uma fonte de imagem ou de mídia ou a URL de uma fonte de navegador.
• Inicie e pare qualquer saída do OBS pelo nome, incluindo saídas adicionadas por plugins.

Alguns exemplos de uso:

• Um botão Já volto que muda para a sua cena de pausa e silencia o microfone.
• Um botão Gravar que alterna a gravação e mostra se o OBS está gravando, pausado ou parado.
• Um controle deslizante vinculado à variável obs_<input>_volume da sua entrada de música, para que mover o controle mude o volume no OBS.
• Um fluxo executado quando o OBS informa Transmissão iniciada e envia uma notificação para você.

Como funciona

O Macro Deck escuta os eventos que o OBS envia, então variáveis como a cena atual, os estados de silenciamento e os estados dos filtros são atualizadas em uma fração de segundo depois que você os muda no OBS. Botões de alternância acendem enquanto o estado deles está ativo, também quando a mudança é feita no próprio OBS. Estatísticas como FPS, uso da CPU, taxa de bits e quadros perdidos são lidas a cada um ou dois segundos.

Além das variáveis fixas, o seletor de variáveis lista cada entrada, cena, item de cena e filtro do OBS conectado, com volume, estado de silenciamento, visibilidade ou estado de ativação. Os gatilhos reagem a mudanças de cena, de gravação e de transmissão, a replays e capturas de tela salvos, a entradas que ficam ativas e a eventos personalizados transmitidos pelos seus próprios scripts do OBS.

É possível adicionar mais de uma configuração, por exemplo uma para o PC de transmissão e outra para o PC de jogos. Cada configuração recebe o próprio conjunto de variáveis, e toda ação tem um campo Configuração para escolher qual OBS ela controla. Quando o OBS é fechado ou a rede cai, o Macro Deck continua tentando reconectar e dispara os gatilhos Desconectado e Conectado.