De Signal API
De Signal API van Voco laat externe apparaten opdrachten sturen naar de actieve stream zonder het beheerdersdashboard te openen. Het is beschikbaar op Voco Pro- en Network-abonnementen.
De API ondersteunt vijf acties: stream:start, stream:stop, captions:clear, captions:hide en captions:show.
Stream Deck-installatie (URL-actie)
De Website-knop van Stream Deck opent een URL — wat voldoende is om het GET-eindpunt van de Signal API te activeren. Geen plugin nodig.
- 1Vind je API-sleutelOpen Instellingen → API in het Voco-dashboard en kopieer je kerk-API-sleutel.
- 2Voeg een Website-knop toeVoeg in Stream Deck een actie toe en kies het actietype Systeem → Website.
- 3Plak de trigger-URLGebruik het URL-formaat hieronder en vervang YOUR_KEY door je werkelijke sleutel.
- 4Instellen op openen op achtergrondSchakel 'openen op achtergrond' in zodat de URL stil wordt geactiveerd zonder een browsertabblad te openen.
- 5Herhaal voor elke actieMaak één knop per actie — starten, stoppen, ondertiteling aan/uit, wissen.
Bitfocus Companion
Bitfocus Companion ondersteunt HTTP-verzoekacties, die werken met het POST-eindpunt van de Signal API. Gebruik een Generiek HTTP-verzoek-knop en stel de methode in op POST, de URL op https://voco.church/api/v1/signal en voeg een JSON-body toe met je API-sleutel en actie.
Companion is nuttig wanneer je een volledige knoppenrooster-controller nodig hebt in plaats van een consument-Stream Deck, of wanneer je integreert met ATEM-, vMix- of ProPresenter-besturingsworkflows.
ProPresenter URL-acties
ProPresenter-dia's kunnen URL-acties activeren wanneer ze worden getoond. Voeg een URL-actie toe aan een dia via het GET-eindpunt van de Signal API — bijvoorbeeld een dia vóór de dienst die de Voco-stream automatisch start wanneer hij op het scherm wordt gezet.
Houd je API-sleutel privé
Plak je API-sleutel niet in gedeelde documenten, vrijwilligerschatgroepen of livestreamopnames. Rouleer hem via Instellingen → API als die is blootgesteld.