Stream Deck e Companion
Controle o PalcoTimer com botões físicos usando Stream Deck ou Companion.
Introdução
O PalcoTimer pode ser controlado por dispositivos de hardware como o Elgato Stream Deck ou softwares como Bitfocus Companion. Isso permite que operadores controlem timers com botões físicos, sem precisar navegar pelo computador.
Bitfocus Companion
O Bitfocus Companion é um software gratuito que transforma qualquer dispositivo em um painel de controle. Funciona com Stream Deck, tablets, celulares e mais.
Configurando
- Baixe e instale o Companion em bitfocus.io/companion
- Abra o Companion e acesse a interface web (porta 8000)
- Vá em "Connections" e adicione "Generic HTTP"
- Configure os botões com as URLs de controle abaixo
Dica
Estamos desenvolvendo um módulo oficial do PalcoTimer para Companion. Em breve você poderá adicionar diretamente sem configurar URLs.
Stream Deck Nativo
Se você usa o software nativo do Stream Deck (sem Companion), pode usar o plugin "Web Request" ou "Website" para chamar as URLs de controle.
Usando o plugin Website
- Arraste a ação "Website" para um botão
- Cole a URL de controle desejada
- Marque "Abrir em segundo plano"
- Configure o ícone e título do botão
URLs de Controle
Use estas URLs para controlar sua sala. Substitua ABC123 pelo Short Code da sua sala (visível na página de Integrações):
Dica
Acesse a página de Integrações da sua sala no Dashboard para ver todas as URLs prontas para copiar, com o Short Code já preenchido.
Controles de Transporte
| Ação | URL |
|---|---|
| Play / Start | https://app.palcotimer.com/r/ABC123/api/play |
| Pause | https://app.palcotimer.com/r/ABC123/api/pause |
| Stop | https://app.palcotimer.com/r/ABC123/api/stop |
| Reset | https://app.palcotimer.com/r/ABC123/api/reset |
| Próximo Timer | https://app.palcotimer.com/r/ABC123/api/next |
| Timer Anterior | https://app.palcotimer.com/r/ABC123/api/previous |
Ajustes de Tempo
| Ação | URL |
|---|---|
| Adicionar 1 minuto | https://app.palcotimer.com/r/ABC123/api/add_time |
| Adicionar N segundos | https://app.palcotimer.com/r/ABC123/api/add_time?seconds=30 |
| Remover 1 minuto | https://app.palcotimer.com/r/ABC123/api/subtract_time |
Controles do Viewer
| Ação | URL |
|---|---|
| Toggle Blackout | https://app.palcotimer.com/r/ABC123/api/blackout |
| Blackout Ligado | https://app.palcotimer.com/r/ABC123/api/blackout/on |
| Blackout Desligado | https://app.palcotimer.com/r/ABC123/api/blackout/off |
| Toggle Flash | https://app.palcotimer.com/r/ABC123/api/flash |
| Toggle Focus | https://app.palcotimer.com/r/ABC123/api/focus |
Estado da Sala
| Ação | URL |
|---|---|
| Obter Estado (JSON) | https://app.palcotimer.com/r/ABC123/api/state |
Exemplo de Código
// JavaScript/Node.js
fetch('https://app.palcotimer.com/r/ABC123/api/play')
.then(response => response.json())
.then(data => console.log(data));
// cURL
curl "https://app.palcotimer.com/r/ABC123/api/play"
// Python
import requests
response = requests.get('https://app.palcotimer.com/r/ABC123/api/play')
print(response.json())