Die Signal-API
Mit der Signal-API von Voco können externe Geräte Befehle an den aktiven Stream senden, ohne das Admin-Dashboard zu öffnen. Es ist in den Tarifen Voco Pro und Network verfügbar.
Die API unterstützt fünf Aktionen: stream:start, stream:stop, captions:clear, captions:hide und captions:show.
Stream Deck-Setup (URL-Aktion)
Für Tools, die benutzerdefinierte HTTP-Header unterstützen, verwenden Sie POST mit einem Authorization-Header. Dadurch bleibt Ihr API-Schlüssel von URLs, Browserverlauf und Serverprotokollen fern.
Die grundlegende Website-Schaltfläche von Stream Deck kann immer noch einen URL-Trigger verwenden, wenn keine Header-basierte Aktion verfügbar ist, aber behandeln Sie dieses Schaltflächenprofil wie ein Passwort und rotieren Sie den Schlüssel, wenn es geteilt wird.
- 1Finden Sie Ihren API-SchlüsselÖffnen Sie Einstellungen → API im Voco-Dashboard und kopieren Sie Ihren Kirchen-API-Schlüssel.
- 2Verwenden Sie nach Möglichkeit eine Header-fähige AktionSetzen Sie die Methode auf POST, die URL auf https://voco.church/api/v1/signal und fügen Sie Authorization: Bearer YOUR_KEY hinzu.
- 3Senden Sie die AktionSenden Sie JSON wie { "action": "stream:start" } für jede Schaltfläche.
- 4Nur Fallback: URL-TriggerWenn Ihr Tool keine Header senden kann, verwenden Sie das unten stehende URL-Format und halten Sie das Profil Stream Deck privat.
- 5Wiederholen Sie dies für jede AktionErstellen Sie eine Schaltfläche pro Aktion – Starten, Stoppen, Untertitel ein/aus, löschen.
Bitfocus-Begleiter
Bitfocus Companion unterstützt HTTP-Anfrageaktionen, die mit dem POST-Endpunkt der Signal-API funktionieren. Verwenden Sie eine generische HTTP-Anfrage-Schaltfläche, legen Sie die Methode auf POST und die URL auf https://voco.church/api/v1/signal fest und senden Sie entweder einen Authorization-Header oder einen JSON-Body mit Ihrem API-Schlüssel und Ihrer API-Aktion.
Companion ist nützlich, wenn Sie einen vollständigen Button-Grid-Controller anstelle eines Consumer-Stream Deck benötigen oder wenn Sie ATEM-, vMix- oder ProPresenter-Steuerungsworkflows integrieren.
ProPresenter URL-Aktionen
ProPresenter Folien können bei der Anzeige URL-Aktionen auslösen. Fügen Sie mithilfe des GET-Endpunkts der Signal-API eine URL-Aktion zu jeder Folie hinzu – zum Beispiel eine Pre-Service-Folie, die den Voco-Stream automatisch startet, wenn er auf dem Bildschirm angezeigt wird.
Halten Sie Ihren API-Schlüssel privat
Fügen Sie Ihren API-Schlüssel nicht in freigegebene Dokumente, Gruppenchats von Freiwilligen oder Livestream-Aufzeichnungen ein. URL-Trigger-Tools speichern den Schlüssel möglicherweise in ihrer Konfiguration. Halten Sie diese Dateien daher privat und wechseln Sie den Schlüssel über Einstellungen → API, wenn er verfügbar ist.