Stream Deck und Fernsteuerung

Die Signal-API

Vocos Signal-API ermöglicht es externen Geräten, Befehle an den aktiven Stream zu senden, ohne das Admin-Dashboard zu öffnen. Sie ist auf Voco Pro- und Network-Plänen verfügbar.

Die API unterstützt fünf Aktionen: stream:start, stream:stop, captions:clear, captions:hide und captions:show.

Stream Deck einrichten (URL-Aktion)

Die Website-Schaltfläche von Stream Deck öffnet eine URL – was ausreicht, um den GET-Endpoint der Signal-API auszulösen. Kein Plugin erforderlich.

1. 1Ihren API-Schlüssel findenÖffnen Sie Einstellungen → API im Voco-Dashboard und kopieren Sie Ihren Kirchen-API-Schlüssel.
2. 2Website-Schaltfläche hinzufügenFügen Sie in Stream Deck eine Aktion hinzu und wählen Sie den Aktionstyp System → Website.
3. 3Trigger-URL einfügenVerwenden Sie das untenstehende URL-Format und ersetzen Sie YOUR_KEY durch Ihren tatsächlichen Schlüssel.
4. 4Im Hintergrund öffnen setzenAktivieren Sie 'Im Hintergrund öffnen', damit die URL still ausgelöst wird, ohne einen Browser-Tab zu öffnen.
5. 5Für jede Aktion wiederholenErstellen Sie eine Schaltfläche pro Aktion – start, stop, Untertitel ein/aus, leeren.

Bitfocus Companion

Bitfocus Companion unterstützt HTTP-Anfrage-Aktionen, die mit dem POST-Endpoint der Signal-API funktionieren. Verwenden Sie eine generische HTTP-Anfrage-Schaltfläche und setzen Sie die Methode auf POST, die URL auf https://voco.church/api/v1/signal, und fügen Sie einen JSON-Body mit Ihrem API-Schlüssel und der Aktion hinzu.

Companion ist nützlich, wenn Sie ein vollständiges Schaltflächenraster-Controller statt eines Consumer Stream Decks benötigen oder wenn Sie mit ATEM, vMix oder ProPresenter-Steuerungs-Workflows integrieren.

ProPresenter URL-Aktionen

ProPresenter-Folien können URL-Aktionen auslösen, wenn sie angezeigt werden. Fügen Sie einer beliebigen Folie eine URL-Aktion mit dem Signal-API-GET-Endpoint hinzu – zum Beispiel eine Vorservice-Folie, die den Voco-Stream automatisch startet, wenn sie auf den Bildschirm gebracht wird.