Controle suas telas com o Bitfocus Companion e um Stream Deck

O Bitfocus Companion é um software gratuito que transforma um Elgato Stream Deck, ou os botões em um navegador web, em um painel de controle para toda a sua produção. Com a conexão do Screenbird no Companion, um toque coloca uma cena ao vivo em todas as suas telas, e o botão acende na cor da cena enquanto ela está ao vivo. Entre esses momentos, as suas telas continuam funcionando sozinhas.

Você precisa de:

  • Companion 4.3 ou mais recente.
  • Um token de API do Screenbird.
  • Para os botões de cena: Cenas ativado e pelo menos uma cena. Como isso funciona: Troque várias telas de uma vez com Cenas. Sem Cenas, o Companion ainda consegue enviar conteúdo para uma tela e pará-lo.

Crie um token de API

  1. Vá em Configurações > Conexões.
  2. Em Tokens de API, clique em Novo token de API.
  3. Dê um nome ao token, por exemplo o nome do local ou do Stream Deck.
  4. Em Acesso, escolha Controlar telas e cenas.
  5. Clique em Criar token e copie o token. Você o vê apenas uma vez.

O token funciona na equipe que está ativa quando você o cria. Para as telas de outra equipe, mude primeiro para essa equipe e crie um token separado. Use um token por conexão do Companion.

Mais sobre tokens: Tokens de API.

Adicione o Screenbird no Companion

  1. No Companion, vá em Connections, procure por Screenbird e adicione.
  2. Cole o token em API token e salve.
  3. Abra os presets da conexão e arraste os botões para o seu Stream Deck.

Deixe API address como está, a menos que o suporte do Screenbird indique outro endereço.

O computador que roda o Companion precisa de acesso de saída por HTTPS e WebSocket seguro (WSS) na porta 443 para api.screenbird.app. Sem uma conexão de internet funcionando, os botões não funcionam.

Os botões

Os presets vêm em três grupos.

Scenes

  • Go: um botão por cena, na cor da cena.
  • Stop: um botão por cena que devolve essa cena ao normal. Ele é escuro, com o nome da cena em uma versão clara da cor dela.

Control

  • STOP ALL devolve tudo ao normal. Ele é vermelho-escuro.
  • NEXT inicia a cena seguinte à que você iniciou por último, na ordem de Cenas no dashboard. Ele mostra o nome dessa cena.

Screens

  • Um botão stop por tela ou subtela. Ele fica vermelho-escuro enquanto uma cena ou um conteúdo enviado aparece nessa tela.

A cor do botão de uma cena indica o estado:

  • Escuro: a cena está desligada.
  • Cor cheia: a cena está ao vivo em todas as suas telas.
  • Meio brilho: a cena está parcialmente ao vivo. Algumas das telas dela mostram outra coisa, ou a cena ainda está na tela desde antes.
  • Âmbar, com "(changed)" no texto: a cena foi editada depois de entrar ao vivo. Pressione-o de novo para colocar as alterações ao vivo.

Os botões acompanham as mudanças na hora, inclusive quando alguém inicia uma cena no dashboard, em um celular ou em um horário definido. Uma cena nova ou uma tela nova aparece sozinha nos presets.

Ações

Use estas ações nos seus próprios botões:

  • Scene: go: mostra a cena em todas as telas dela. Se a cena mudou depois de entrar ao vivo, pressioná-lo de novo coloca as alterações ao vivo.
  • Scene: stop: para esta cena. As telas dela voltam ao próprio conteúdo.
  • Scene: next: vai para a cena seguinte à última ativada.
  • Stop all: para todas as cenas e todo o conteúdo enviado. O compartilhamento de tela continua ativo.
  • Screen: push content: mostra conteúdo em uma tela ou subtela, por alguns minutos ou até ser parado. Você escolhe o conteúdo em uma lista com os arquivos, designs, apps, telas divididas e playlists da equipe.
  • Screen: stop: para o conteúdo enviado ou uma cena em uma tela ou subtela.

Feedbacks

Use estes feedbacks para mudar a aparência de um botão:

  • Scene is live, Scene is partly live e Scene changed since it went live.
  • Screen shows: uma cena, conteúdo enviado, um compartilhamento de tela ou conteúdo normal.
  • Screen is online.

Variáveis

Use variáveis no texto dos botões, por exemplo $(screenbird:last_scene). Se você renomeou a conexão, use o nome dela no lugar de "screenbird".

  • last_scene: a última cena ativada.
  • next_scene: a cena que Scene: next inicia.
  • live_scenes: as cenas que estão ao vivo.
  • screens_online e screens_total: telas online e total de telas.

Quando algo não funciona

  • Authentication failure: o token não é válido ou foi revogado. Crie um novo token e cole-o nas configurações da conexão.
  • Insufficient permissions: o token não tem acesso às telas, ou a pessoa que o criou perdeu o acesso. Crie um token com o acesso Controlar telas e cenas.
  • Connection failure que menciona o API address: alguma coisa que não é o Screenbird está respondendo, por exemplo uma página de login de Wi-Fi, ou o endereço está errado. Verifique a rede e o API address.
  • Waiting for the live connection que não desaparece, ou Live updates unavailable: um firewall ou proxy pode estar bloqueando o tráfego WebSocket para api.screenbird.app. Os botões continuam funcionando, mas as cores só são atualizadas depois de um toque.
  • No active subscription: a conta do Screenbird não está ativa. A conexão verifica de novo a cada 5 minutos.
  • Sem botões de cena: Cenas está desativado. O proprietário o ativa em Configurações > Avançado. Os botões então aparecem sozinhos, sem reiniciar o Companion.

Revogue o token

Clique em Revogar ao lado do token em Configurações > Conexões. Tudo o que o usa para de funcionar na hora. Veja Tokens de API.

© screenbird.app