Gratis proberen — 7 dagen gratis

Gratis proberen

← Back to docs

Voco Docs

Stream Deck en bediening op afstand

Bedien Voco via een Stream Deck-knop, ProPresenter-actie of een URL-trigger met de Signal API.

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.

  1. 1Vind je API-sleutelOpen Instellingen → API in het Voco-dashboard en kopieer je kerk-API-sleutel.
  2. 2Voeg een Website-knop toeVoeg in Stream Deck een actie toe en kies het actietype Systeem → Website.
  3. 3Plak de trigger-URLGebruik het URL-formaat hieronder en vervang YOUR_KEY door je werkelijke sleutel.
  4. 4Instellen op openen op achtergrondSchakel 'openen op achtergrond' in zodat de URL stil wordt geactiveerd zonder een browsertabblad te openen.
  5. 5Herhaal voor elke actieMaak één knop per actie — starten, stoppen, ondertiteling aan/uit, wissen.
https://voco.church/api/v1/signal?api_key=YOUR_KEY&action=stream:start
https://voco.church/api/v1/signal?api_key=YOUR_KEY&action=stream:stop
https://voco.church/api/v1/signal?api_key=YOUR_KEY&action=captions:hide
https://voco.church/api/v1/signal?api_key=YOUR_KEY&action=captions:show
https://voco.church/api/v1/signal?api_key=YOUR_KEY&action=captions:clear

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.

Related guides