Stream Deck en afstandsbediening

De signaal-API

Met de Signal API van Voco kunnen externe apparaten opdrachten naar de actieve stream sturen zonder het beheerdersdashboard te openen. Het is beschikbaar op Voco Pro- en netwerkabonnementen.

De API ondersteunt vijf acties: stream:start, stream:stop, captions:clear, captions:hide en captions:show.

Stream Deck installatie (URL-actie)

Voor tools die aangepaste HTTP-headers ondersteunen, gebruikt u POST met een Authorization-header. Hierdoor blijft uw API-sleutel buiten URL's, browsergeschiedenis en serverlogboeken.

De basiswebsiteknop van Stream Deck kan nog steeds een URL-trigger gebruiken als er geen op headers gebaseerde actie beschikbaar is, maar behandelt dat knopprofiel als een wachtwoord en roteert de sleutel als deze wordt gedeeld.

1. 1Vind uw API-sleutelOpen Instellingen → API in het Voco dashboard en kopieer de API-sleutel van uw kerk.
2. 2Gebruik waar mogelijk een actie die headers ondersteuntStel de methode in op POST, de URL op https://voco.church/api/v1/signal en voeg Autorisatie toe: Bearer YOUR_KEY.
3. 3Verzend de actieStuur JSON zoals { "action": "stream:start" } voor elke knop.
4. 4Alleen fallback: URL-triggerAls uw tool geen headers kan verzenden, gebruik dan het onderstaande URL-formaat en houd het Stream Deck profiel privé.
5. 5Herhaal dit voor elke actieMaak één knop per actie: starten, stoppen, ondertiteling aan/uit, wissen.

Bitfocus-metgezel

Bitfocus Companion ondersteunt HTTP-verzoekacties, die werken met het POST-eindpunt van de Signal API. Gebruik een Generic HTTP Request-knop en stel de methode in op POST, de URL op https://voco.church/api/v1/signal, en stuur een Authorization-header of een JSON-body met uw API-sleutel en actie.

Companion is handig wanneer u een rastercontroller met volledige knoppen nodig heeft in plaats van een consumenten- Stream Deck, of wanneer u integreert met ATEM-, vMix- of ProPresenter-besturingsworkflows.

ProPresenter URL-acties

ProPresenter dia's kunnen URL-acties activeren wanneer ze worden weergegeven. Voeg een URL-actie toe aan elke dia met behulp van het Signal API GET-eindpunt, bijvoorbeeld een pre-service dia die de Voco-stream automatisch start wanneer deze op het scherm wordt weergegeven.